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 connection 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 ressource é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