pg_last_error

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

pg_last_errorПолучает сообщение о последней произошедшей ошибке на соединении с базой данных

Описание

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

pg_last_error() возвращает сообщение о последней ошибке на заданном соединении connection.

Сообщения об ошибках могут перезаписываться при внутренних вызовах функций PostgreSQL (libpq). Если внутри модуля PostgreSQL произойдёт несколько ошибок, сообщение может оказаться неинформативным.

Для обработки ошибок лучше использовать функции pg_result_error(), pg_result_error_field(), pg_result_status() и pg_connection_status().

Замечание:

Прежнее название функции: pg_errormessage().

Список параметров

connection

Экземпляр класса PgSql\Connection. Функция выберет соединение по умолчанию, если для параметра connection указали значение null. Соединение по умолчанию — последнее соединение, которое установила функция pg_connect() или pg_pconnect().

Внимание

Начиная с PHP 8.1.0 выбор функцией соединения по умолчанию устарел.

Возвращаемые значения

Функция возвращает строку, которая содержит сообщение о последней ошибке соединения connection.

Список изменений

Версия Описание
8.1.0 Параметр connection теперь ожидает экземпляр класса PgSql\Connection; раньше параметр ожидал ресурс (resource).
8.0.0 connection теперь допускает значение null.

Примеры

Пример #1 Пример использования pg_last_error()

<?php

$dbconn
= pg_connect("dbname=publisher") or die("Не удалось соединиться с сервером");

// Неудачный запрос
$res = pg_query($dbconn, "SELECT * FROM doesnotexist");

echo
pg_last_error($dbconn);

?>

Смотрите также

  • pg_result_error() - Возвращает сообщение об ошибке, связанное с запросом результата
  • pg_result_error_field() - Возвращает конкретное поле из отчёта об ошибках