Home/ Manual/ pgsql / functions/ pg_last_error

pg_last_error

PHP function Edit on GitHub ✎

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

Get the last error message string of a connection

Description

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

pg_last_error() returns the last error message for a given connection.

Error messages may be overwritten by internal PostgreSQL (libpq) function calls. It may not return an appropriate error message if multiple errors occur inside a PostgreSQL module function.

Use pg_result_error(), pg_result_error_field(), pg_result_status() and pg_connection_status() for better error handling.

Note

This function used to be called pg_errormessage().

Parameters

connection: Connection-with-nullable-default

Return Values

A string containing the last error message on the given connection.

Changelog

Version	Description
8.0.0	`connection` is now nullable.

Examples

pg_last_error() example

php

<?php
  $dbconn = pg_connect("dbname=publisher") or die("Could not connect");

  // Query that fails
  $res = pg_query($dbconn, "select * from doesnotexist");
  
  echo pg_last_error($dbconn);
?>