ConFoo 2025

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

Модуль определяет перечисленные константы и открывает доступ к константам только тогда, когда модуль либо собрали в 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.3.0.
PGSQL_TRACE_REGRESS_MODE (int)
Константу указывают при вызове функции pg_trace(), поля наподобие OIDs будут включены в сообщение трассировки. Доступна с PHP 8.3.0.
Добавить

Примечания пользователей

Пользователи ещё не добавляли примечания для страницы
To Top