Предопределенные константы

Перечисленные ниже константы определены данным расширением и могут быть доступны только в том случае, если PHP был собран с поддержкой этого расширения или же в том случае, если данное расширение было подгружено во время выполнения.

PGSQL_LIBPQ_VERSION (string)

Короткое обозначение версии libpq, содержащее только цифры и точки.

PGSQL_LIBPQ_VERSION_STR (string)

Длинное обозначение версии libpq, включая информацию компилятора.

PGSQL_ASSOC (integer)

Передается в функцию pg_fetch_array(). Возвращает ассоциативный массив 'имя поля' => 'значение поля'.

PGSQL_NUM (integer)

Передается в функцию pg_fetch_array(). Возвращает нумерованный массив 'номер поля' => 'значение поля'.

PGSQL_BOTH (integer)

Передается в функцию pg_fetch_array(). Возвращает массив значений поля, нумерованный (по номеру поля) и ассоциативный (по имени поля).

PGSQL_CONNECT_FORCE_NEW (integer)

Передается в функцию pg_connect() для принудительного создания нового подключения вместо использования идентичного существующего.

PGSQL_CONNECT_ASYNC (integer)

Передается в pg_connect() для создания асинхронного соединения. Добавлено в PHP 5.6.0.

PGSQL_CONNECTION_BAD (integer)

Возвращается функцией pg_connection_status(), указывает на неработоспособность соединения с базой данных.

PGSQL_CONNECTION_OK (integer)

Возвращается функцией pg_connection_status(), указывает на нормальное (рабочее) состояние соединения с базой данных.

PGSQL_SEEK_SET (integer)

Передается в функцию pg_lo_seek(). Операция поиска начнет работу с начала объекта.

PGSQL_SEEK_CUR (integer)

Передается в функцию pg_lo_seek(). Операция поиска начнет работу с текущей позиции.

PGSQL_SEEK_END (integer)

Передается в функцию pg_lo_seek(). Операция поиска начнет работу с конца объекта.

PGSQL_EMPTY_QUERY (integer)

Возвращается функцией pg_result_status(). Означает, что отправленная на сервер строка была пустой.

PGSQL_COMMAND_OK (integer)

Возвращается функцией pg_result_status(). Означает успешное завершение команды, не возвращающей данных.

PGSQL_TUPLES_OK (integer)

Возвращается функцией pg_result_status(). Означает успешное завершение команды, возвращающей какие-либо данные (например, SELECT или SHOW).

PGSQL_COPY_OUT (integer)

Возвращается функцией pg_result_status(). Сообщает, что было начато копирование данных с сервера.

PGSQL_COPY_IN (integer)

Возвращается функцией pg_result_status(). Сообщает, что было начато копирование данных на сервер.

PGSQL_BAD_RESPONSE (integer)

Возвращается функцией pg_result_status(). Сообщает, что ответ от сервера не был распознан.

PGSQL_NONFATAL_ERROR (integer)

Возвращается функцией pg_result_status(). Сообщает, что произошла некритическая (уведомление или предупреждение) ошибка.

PGSQL_FATAL_ERROR (integer)

Возвращается функцией pg_result_status(). Сообщает, что произошла критическая ошибка.

PGSQL_TRANSACTION_IDLE (integer)

Возвращается функцией pg_transaction_status(). Означает, что соединение на данный момент бездействует и не находится в рамках транзакции.

PGSQL_TRANSACTION_ACTIVE (integer)

Возвращается функцией pg_transaction_status(). Означает состояние, когда команда находится в процессе выполнения. Запрос через соединение отправлен, но выполнение еще не завершено.

PGSQL_TRANSACTION_INTRANS (integer)

Возвращается функцией pg_transaction_status(). Означает, что соединение простаивает и находится в рамках транзакции.

PGSQL_TRANSACTION_INERROR (integer)

Возвращается функцией pg_transaction_status(). Означает, что соединение простаивает и находится в рамках транзакции потерпевшей неудачу при выполнении.

PGSQL_TRANSACTION_UNKNOWN (integer)

Возвращается функцией pg_transaction_status(). Означает, что соединение разорвано.

PGSQL_DIAG_SEVERITY (integer)

Передается в функцию pg_result_error_field(). Сообщает о затруднении. Возможны лишь перечисленные значения: ERROR, FATAL, или PANIC (в сообщении об ошибке), либо WARNING, NOTICE, DEBUG, INFO, или LOG (в уведомлении), либо перевод перечисленных значений в соответствии с используемой локализацией. Поле всегда определено.

PGSQL_DIAG_SQLSTATE (integer)

Передается в pg_result_error_field(). Код ошибки SQLSTATE. Код SQLSTATE определяет тип произошедшей ошибки; он может быть использован прикладной программой при выполнении специфических операций (таких как обработка ошибки) в ответ на ошибку базы данных. Это поле всегда определено и его значение не зависит от локализации.

PGSQL_DIAG_MESSAGE_PRIMARY (integer)

Передается в pg_result_error_field(). Основное удобочитаемое сообщение об ошибке (обычно одна строка). Поле всегда определено.

PGSQL_DIAG_MESSAGE_DETAIL (integer)

Передается в pg_result_error_field(). Детализация: дополнительное сообщение об ошибке, содержащее более подробную информацию о проблеме. Может содержать несколько строк.

PGSQL_DIAG_MESSAGE_HINT (integer)

Передается в pg_result_error_field(). Подсказка: указание на возможные пути устранения ошибки. Отличается от детализации ошибки тем, что это просто предложения (возможно ошибочные), а не точная информация. Может содержать несколько строк.

PGSQL_DIAG_STATEMENT_POSITION (integer)

Передается в pg_result_error_field(). Строка, содержащая десятичное целое число, указывающее на позицию курсора в исходном выражении, где произошла ошибка. Первый символ имеет индекс 1, позиции исчисляются в символах, а не в байтах.

PGSQL_DIAG_INTERNAL_POSITION (integer)

Передается в pg_result_error_field(). Определение тоже, что и для поля PG_DIAG_STATEMENT_POSITION, но используется в случаях, когда курсор указывает на команду, сгенерированную сервером БД. В таких случаях всегда появляется поле PG_DIAG_INTERNAL_QUERY.

PGSQL_DIAG_INTERNAL_QUERY (integer)

Передается в pg_result_error_field(). Текст ошибки, сгенерированной внутренней командой СУБД, в которой произошла ошибка. Это может быть, например, SQL-запрос, сформированный функцией PL/pgSQL.

PGSQL_DIAG_CONTEXT (integer)

Передается в pg_result_error_field(). Указание на контекст, где произошла ошибка. В основном содержит трассировку запрограммированных функций и автоматически сгенерированных запросов. Трассировка выводится построчно, начиная с последней строки.

PGSQL_DIAG_SOURCE_FILE (integer)

Передается в pg_result_error_field(). Имя файла исходного кода PostgreSQL, в котором отмечена ошибка.

PGSQL_DIAG_SOURCE_LINE (integer)

Передается в pg_result_error_field(). Номер строки файла исходного кода PostgreSQL, где отмечена ошибка.

PGSQL_DIAG_SOURCE_FUNCTION (integer)

Передается в pg_result_error_field(). Имя функции в исходном коде PostgreSQL, сообщающей об ошибке.

PGSQL_ERRORS_TERSE (integer)

Передается в pg_set_error_verbosity(). Дает предписание, что выдаваемые сообщения будут содержать только важность ошибки, основной текст и указатель на место, где она произошла; эта информация обычно умещается в одну строку.

PGSQL_ERRORS_DEFAULT (integer)

Передается в pg_set_error_verbosity(). В режиме по умолчанию сообщения об ошибках содержат описанную выше информацию, а также детализацию, подсказку или поля с контекстом ошибки (могут занимать несколько строк).

PGSQL_ERRORS_VERBOSE (integer)

Передается в pg_set_error_verbosity(). Задает режим, в котором в сообщения будут включены все возможные поля.

PGSQL_NOTICE_LAST (integer)

Используется pg_last_notice(). Доступно с PHP 7.1.0.

PGSQL_NOTICE_ALL (integer)

Используется pg_last_notice(). Доступно с PHP 7.1.0.

PGSQL_NOTICE_CLEAR (integer)

Используется pg_last_notice(). Доступно с PHP 7.1.0.

PGSQL_STATUS_LONG (integer)

Передается в pg_result_status(). Указывает на то, что в качестве возвращаемого значения ожидается числовой код.

PGSQL_STATUS_STRING (integer)

Передается в pg_result_status(). Указывает на то, что в качестве возвращаемого значения ожидается текстовое представление статуса.

PGSQL_CONV_IGNORE_DEFAULT (integer)

Передается в pg_convert(). Игнорировать значения по умолчанию в таблице в процессе преобразования.

PGSQL_CONV_FORCE_NULL (integer)

Передается в pg_convert(). Заменять пустые строки string на SQL NULL при преобразовании.

PGSQL_CONV_IGNORE_NOT_NULL (integer)

Передается в pg_convert(). Указывает, что не нужно конвертировать NULL в столбцы SQL NOT NULL.

PGSQL_DML_NO_CONV (integer)

Передается в pg_insert(), pg_select(), pg_update() и pg_delete(). Все параметры передаются в исходном виде. Ручное экранирование обязательно, если параметры содержат пользовательские данные. Используйте для этих целей pg_escape_string().

PGSQL_DML_EXEC (integer)

Передается в pg_insert(), pg_select(), pg_update() и pg_delete(). Выполнить запрос с помощью этих функций.

PGSQL_DML_ASYNC (integer)

Передается в pg_insert(), pg_select(), pg_update() и pg_delete(). Выполнить асинхронный запрос с помощью этих функций.

PGSQL_DML_STRING (integer)

Передается в pg_insert(), pg_select(), pg_update() и pg_delete(). Вернуть строку с выполненным запросом.

PGSQL_DML_ESCAPE (integer)

Передается в pg_insert(), pg_select(), pg_update() и pg_delete(). Применить экранирование ко всем параметрам вместо внутреннего вызова pg_convert(). Эта опция пропускает просмотр метаданных. Запрос может быть таким же быстрым, как и pg_query() и pg_send_query().

PGSQL_POLLING_FAILED (integer)

Возвращается функцией pg_connect_poll() и указывает на то, что попытка соединения провалилась.

PGSQL_POLLING_READING (integer)

Возвращается функцией pg_connect_poll() и указывает на то, что соединение ожидает, когда сокет PostgreSQL станет доступным для чтения.

PGSQL_POLLING_WRITING (integer)

Возвращается функцией pg_connect_poll() и указывает на то, что соединение ожидает, когда сокет PostgreSQL станет доступным для записи.

PGSQL_POLLING_OK (integer)

Возвращается функцией pg_connect_poll() и указывает на то, что соединение готово к использованию.

PGSQL_POLLING_ACTIVE (integer)

Возвращается функцией pg_connect_poll() и указывает на то, что соединение сейчас активно.

PGSQL_DIAG_SEVERITY_NONLOCALIZED (integer)

Важность; Возможны следующие значения: ERROR, FATAL или PANIC (в сообщении ошибке), либо WARNING, NOTICE, DEBUG, INFO или LOG (в сообщении предупреждении). Это идентично полю PG_DIAG_SEVERITY за исключением того, содержимое не локализовано. Доступно только в версии 9.6 или новее.