Предопределённые константы
Модуль определяет перечисленные ниже константы и открывает к ним доступ только тогда, когда модуль либо собрали в PHP, либо динамически загрузили во время исполнения кода.
PGSQL_LIBPQ_VERSION
(string) - Короткое обозначение версии модуля libpq, содержащее только цифры и точки.
PGSQL_LIBPQ_VERSION_STR
(string) - До PHP 8.0.0 — длинное обозначение версии модуля libpq, которое включает информацию о компиляторе. Начиная с PHP 8.0.0, значение идентично
PGSQL_LIBPQ_VERSION
, а использование PGSQL_LIBPQ_VERSION_STR
устарело. PGSQL_ASSOC
(int) - Передаётся в функцию pg_fetch_array(). Возвращает ассоциативный массив 'имя поля' => 'значение поля'.
PGSQL_NUM
(int) - Передаётся в функцию pg_fetch_array(). Возвращает нумерованный массив 'номер поля' => 'значение поля'.
PGSQL_BOTH
(int) - Передаётся в функцию pg_fetch_array(). Возвращает массив значений поля, нумерованный (по номеру поля) и ассоциативный (по имени поля).
PGSQL_CONNECT_FORCE_NEW
(int) - Передаётся в функцию pg_connect() для принудительного создания нового подключения вместо использования идентичного существующего.
PGSQL_CONNECT_ASYNC
(int) - Передаётся в функцию pg_connect() для создания асинхронного соединения.
PGSQL_CONNECTION_AUTH_OK
(int) PGSQL_CONNECTION_AWAITING_RESPONSE
(int) PGSQL_CONNECTION_BAD
(int) - Возвращается функцией pg_connection_status(), указывает на неработоспособность соединения с базой данных.
PGSQL_CONNECTION_MADE
(int) PGSQL_CONNECTION_OK
(int) - Возвращается функцией pg_connection_status(), указывает на нормальное (рабочее) состояние соединения с базой данных.
PGSQL_CONNECTION_SETENV
(int) PGSQL_CONNECTION_SSL_STARTUP
(int) PGSQL_CONNECTION_STARTED
(int) PGSQL_SEEK_SET
(int) - Передаётся в функцию pg_lo_seek(). Операция поиска начнёт работу с начала объекта.
PGSQL_SEEK_CUR
(int) - Передаётся в функцию pg_lo_seek(). Операция поиска начнёт работу с текущей позиции.
PGSQL_SEEK_END
(int) - Передаётся в функцию pg_lo_seek(). Операция поиска начнёт работу с конца объекта.
PGSQL_EMPTY_QUERY
(int) - Возвращается функцией pg_result_status(). Означает, что отправленная на сервер строка была пустой.
PGSQL_COMMAND_OK
(int) - Возвращается функцией pg_result_status(). Означает успешное завершение команды, не возвращающей данных.
PGSQL_TUPLES_OK
(int) - Возвращается функцией pg_result_status(). Означает успешное завершение команды, возвращающей какие-либо данные (например,
SELECT
или SHOW
). PGSQL_COPY_OUT
(int) - Возвращается функцией pg_result_status(). Сообщает, что было начато копирование данных с сервера.
PGSQL_COPY_IN
(int) - Возвращается функцией pg_result_status(). Сообщает, чтобы начато копирование данных на сервер.
PGSQL_BAD_RESPONSE
(int) - Возвращается функцией pg_result_status(). Сообщает, что ответ от сервера не был распознан.
PGSQL_NONFATAL_ERROR
(int) - Возвращается функцией pg_result_status(). Сообщает, что произошла некритическая (уведомление или предупреждение) ошибка.
PGSQL_FATAL_ERROR
(int) - Возвращается функцией pg_result_status(). Сообщает, что произошла критическая ошибка.
PGSQL_TRANSACTION_IDLE
(int) - Возвращается функцией pg_transaction_status(). Означает, что соединение на данный момент бездействует и не находится в рамках транзакции.
PGSQL_TRANSACTION_ACTIVE
(int) - Возвращается функцией pg_transaction_status(). Означает состояние, когда команда находится в процессе выполнения. Запрос через соединение отправлен, но выполнение ещё не завершено.
PGSQL_TRANSACTION_INTRANS
(int) - Возвращается функцией pg_transaction_status(). Означает, что соединение простаивает и находится в рамках транзакции.
PGSQL_TRANSACTION_INERROR
(int) - Возвращается функцией pg_transaction_status(). Означает, что соединение простаивает и находится в рамках транзакции потерпевшей неудачу при выполнении.
PGSQL_TRANSACTION_UNKNOWN
(int) - Возвращается функцией pg_transaction_status(). Означает, что соединение разорвано.
PGSQL_DIAG_SEVERITY
(int) - Передаётся в функцию pg_result_error_field(). Сообщает о затруднении. Возможны лишь перечисленные значения:
ERROR
, FATAL
, или PANIC
(в сообщении об ошибке), либо WARNING
, NOTICE
, DEBUG
, INFO
, или LOG
(в уведомлении), либо перевод перечисленных значений в соответствии с текущей локализацией. Поле всегда определено. PGSQL_DIAG_SQLSTATE
(int) - Передаётся в функцию pg_result_error_field(). Код ошибки SQLSTATE. Код SQLSTATE определяет тип произошедшей ошибки; он может быть использован прикладной программой при выполнении специфических операций (таких как обработка ошибки) в ответ на ошибку базы данных. Это поле всегда определено и его значение не зависит от локализации.
PGSQL_DIAG_MESSAGE_PRIMARY
(int) - Передаётся в функцию pg_result_error_field(). Основное удобочитаемое сообщение об ошибке (обычно одна строка). Поле всегда определено.
PGSQL_DIAG_MESSAGE_DETAIL
(int) - Передаётся в функцию pg_result_error_field(). Детализация: дополнительное сообщение об ошибке, содержащее более подробную информацию о проблеме. Может содержать несколько строк.
PGSQL_DIAG_MESSAGE_HINT
(int) - Передаётся в функцию pg_result_error_field(). Подсказка: указание на возможные пути устранения ошибки. Отличается от детализации ошибки тем, что это просто предложения (возможно ошибочные), а не точная информация. Может содержать несколько строк.
PGSQL_DIAG_STATEMENT_POSITION
(int) - Передаётся в функцию pg_result_error_field(). Строка, содержащая целое десятичное число, указывающее на позицию курсора в исходном выражении, в котором произошла ошибка. Первый символ имеет индекс 1, позиции измеряются в символах, а не в байтах.
PGSQL_DIAG_INTERNAL_POSITION
(int) - Передаётся в функцию pg_result_error_field(). Эта константа определена так же, как поле
PG_DIAG_STATEMENT_POSITION
, но эту константу применяют, когда позиция курсора указывает на команду, сгенерированную сервером БД. Поле PG_DIAG_INTERNAL_QUERY
будет появляться каждый раз, когда появляется это поле. PGSQL_DIAG_INTERNAL_QUERY
(int) - Передаётся в функцию pg_result_error_field(). Текст ошибки, сгенерированной внутренней командой СУБД, в которой произошла ошибка. Это может быть, например, SQL-запрос, сформированный функцией PL/pgSQL.
PGSQL_DIAG_CONTEXT
(int) - Передаётся в функцию pg_result_error_field(). Указание на контекст, где произошла ошибка. В основном содержит трассировку запрограммированных функций и автоматически сгенерированных запросов. Трассировка выводится построчно, начиная с последней строки.
PGSQL_DIAG_SOURCE_FILE
(int) - Передаётся в функцию pg_result_error_field(). Имя файла исходного кода PostgreSQL, в котором отмечена ошибка.
PGSQL_DIAG_SOURCE_LINE
(int) - Передаётся в функцию pg_result_error_field(). Номер строки файла исходного кода PostgreSQL, где отмечена ошибка.
PGSQL_DIAG_SOURCE_FUNCTION
(int) - Передаётся в функцию pg_result_error_field(). Имя функции в исходном коде PostgreSQL, сообщающей об ошибке.
PGSQL_DIAG_SCHEMA_NAME
(int) - Добавлено в PHP 7.3.0.
PGSQL_DIAG_TABLE_NAME
(int) - Добавлено в PHP 7.3.0.
PGSQL_DIAG_COLUMN_NAME
(int) - Добавлено в PHP 7.3.0.
PGSQL_DIAG_DATATYPE_NAME
(int) - Добавлено в PHP 7.3.0.
PGSQL_DIAG_CONSTRAINT_NAME
(int) - Добавлено в PHP 7.3.0.
PGSQL_ERRORS_TERSE
(int) - Передаётся в функцию pg_set_error_verbosity(). Даёт предписание, что выдаваемые сообщения будут содержать только важность ошибки, основной текст и указатель на место, где она произошла; эта информация обычно умещается в одну строку.
PGSQL_ERRORS_DEFAULT
(int) - Передаётся в функцию pg_set_error_verbosity(). В режиме по умолчанию сообщения об ошибках содержат описанную выше информацию, а также детализацию, подсказку или поля с контекстом ошибки (могут занимать несколько строк).
PGSQL_ERRORS_VERBOSE
(int) - Передаётся в функцию pg_set_error_verbosity(). Задаёт режим, в котором в сообщения будут включены все возможные поля.
PGSQL_NOTICE_LAST
(int) - Указывается в функции pg_last_notice(). Доступно с PHP 7.1.0.
PGSQL_NOTICE_ALL
(int) - Используется pg_last_notice(). Доступно с PHP 7.1.0.
PGSQL_NOTICE_CLEAR
(int) - Используется pg_last_notice(). Доступно с PHP 7.1.0.
PGSQL_STATUS_LONG
(int) - Передаётся в функцию pg_result_status(). Указывает на то, что в качестве возвращаемого значения ожидается числовой код.
PGSQL_STATUS_STRING
(int) - Передаётся в функцию pg_result_status(). Указывает на то, что в качестве возвращаемого значения ожидается текстовое представление статуса.
PGSQL_CONV_IGNORE_DEFAULT
(int) - Передаётся в функцию pg_convert(). Игнорировать значения по умолчанию в таблице в процессе преобразования.
PGSQL_CONV_FORCE_NULL
(int) - Передаётся в функцию pg_convert(). Заменять пустые строки string на SQL
NULL
при преобразовании. PGSQL_CONV_IGNORE_NOT_NULL
(int) - Передаётся в функцию pg_convert(). Указывает, что не нужно конвертировать
null
в столбцы SQL NOT NULL
. PGSQL_DML_NO_CONV
(int) - Передаётся в функцию pg_insert(), pg_select(), pg_update() и pg_delete(). Все параметры передаются в исходном виде. Ручное экранирование обязательно, если параметры содержат пользовательские данные. Используйте для этих целей pg_escape_string().
PGSQL_DML_EXEC
(int) - Передаётся в функцию pg_insert(), pg_select(), pg_update() и pg_delete(). Выполнить запрос с помощью этих функций.
PGSQL_DML_ASYNC
(int) - Передаётся в функцию pg_insert(), pg_select(), pg_update() и pg_delete(). Выполнить асинхронный запрос с помощью этих функций.
PGSQL_DML_STRING
(int) - Передаётся в функцию pg_insert(), pg_select(), pg_update() и pg_delete(). Вернуть строку с выполненным запросом.
PGSQL_DML_ESCAPE
(int) - Передаётся в функцию pg_insert(), pg_select(), pg_update() и pg_delete(). Применить экранирование ко всем параметрам вместо внутреннего вызова pg_convert(). Эта опция пропускает просмотр метаданных. Запрос может быть таким же быстрым, как и pg_query() и pg_send_query().
PGSQL_POLLING_FAILED
(int) - Возвращается функцией pg_connect_poll() и указывает на то, что попытка соединения провалилась.
PGSQL_POLLING_READING
(int) - Возвращается функцией pg_connect_poll() и указывает на то, что соединение ожидает, когда сокет PostgreSQL станет доступным для чтения.
PGSQL_POLLING_WRITING
(int) - Возвращается функцией pg_connect_poll() и указывает на то, что соединение ожидает, когда сокет PostgreSQL станет доступным для записи.
PGSQL_POLLING_OK
(int) - Возвращается функцией pg_connect_poll() и указывает на то, что соединение готово к использованию.
PGSQL_POLLING_ACTIVE
(int) - Возвращается функцией pg_connect_poll() и указывает на то, что соединение сейчас активно.
PGSQL_DIAG_SEVERITY_NONLOCALIZED
(int) - Важность; Возможны следующие значения: ERROR, FATAL или PANIC (в сообщении ошибке), либо WARNING, NOTICE, DEBUG, INFO или LOG (в сообщении предупреждении). Это идентично полю PG_DIAG_SEVERITY за исключением того, содержимое не локализовано. Доступно только в версии 9.6 или новее / PHP 7.3.0 или новее.
PGSQL_SHOW_CONTEXT_NEVER
(int) - Константу указывают при вызове функции pg_set_error_context_visibility(), скрывает показ контекста. Доступна с PHP 8.3.0.
PGSQL_SHOW_CONTEXT_ERRORS
(int) - Константу указывают при вызове функции pg_set_error_context_visibility(), поля контекста будут включены только в сообщения об ошибках. Это поведение по умолчанию. Доступна с PHP 8.3.0.
PGSQL_SHOW_CONTEXT_ALWAYS
(int) - Константу указывают при вызове функции pg_set_error_context_visibility(), поля контекста будут включены в сообщения об ошибках, уведомления и предупреждения. Доступна с PHP 8.3.0.
PGSQL_TRACE_SUPPRESS_TIMESTAMPS
(int) - Константу указывают при вызове функции pg_trace(), метка времени не будет включена в сообщения трассировки. Доступна с PHP 8.3.0.
PGSQL_TRACE_REGRESS_MODE
(int) - Константу указывают при вызове функции pg_trace(), поля наподобие OIDs будут включены в сообщение трассировки. Доступна с PHP 8.3.0.