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

# pg_last_error

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

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

### Описание

function 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() - Возвращает конкретное поле из отчёта об ошибках

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open