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

Следующие константы определяются модулем и доступны, только если модуль либо собрали в 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_TUPLES_CHUNK (int)

Возвращается функцией pg_result_status(). Указывает на успешное выполнение команды, которая возвращает данные в режиме извлечения результов по частям. Возвращается для команд SELECT, когда режим извлечения результатов по частям установили функцией pg_set_chunked_rows_size() Результирующий набор делится на несколько фрагментов, каждый из которых содержит предопределённое количество строк. Константа доступна с PHP 8.4.0 и libpq 17.

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_ERRORS_SQLSTATE (int)

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

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.4.20.

PGSQL_TRACE_REGRESS_MODE (int)

Константу указывают при вызове функции pg_trace(), поля наподобие OIDs включаются в сообщение трассировки. Доступна с PHP 8.3.0.