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

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

Нашли ошибку?