# pg_last_error

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

pg_last_error — Lit le dernier message d'erreur sur la connexion

### Description

pg_last_error(?PgSql\Connection `$connection` = `null`): string

pg_last_error() retourne le dernier message d'erreur pour une connexion `connection`.

Les messages d'erreur peuvent être écrasés par des appels internes à l'extension PostgreSQL (libpq) : il se peut que le message retourné ne soit pas approprié, notamment si plusieurs erreurs ont eu lieu dans le module.

Utilisez pg_result_error(), pg_result_error_field(), pg_result_status() et pg_connection_status() pour améliorer la gestion des erreurs.

> Note:

> Auparavant, cette fonction s'appelait pg_errormessage().

### Liste de paramètres

`connection`

  Une instance PgSql\Connection. Quand `connection` est `null`, la connexion par défaut est utilisé. La connexion par défaut est la dernière connexion faite par pg_connect() ou pg_pconnect()

  Avertissement

  À partir de PHP 8.1.0, utiliser la connexion par défaut est obsolète.

### Valeurs de retour

Une chaîne de caractères contenant le dernier message d'erreur sur la connexion `connection`.

### Historique

Version | Description
--- | ---
8.1.0 | Le paramètre `connection` attend désormais une instance de PgSql\Connection ; auparavant, une resource était attendu.
8.0.0 | `connection` est désormais nullable.

### Exemples

Exemple #1 Exemple avec pg_last_error()

`<?php
$dbconn = pg_connect("dbname=publisher") or die("Connexion impossible");
// Requête qui échoue
$res = pg_query($dbconn, "select * from doesnotexist");
echo pg_last_error($dbconn);
?>`

### Voir aussi

- pg_result_error() - Lit le message d'erreur associé à un résultat
- pg_result_error_field() - Retourne un champ individuel d'un rapport d'erreur