Предопределенные константы
Перечисленные ниже константы определены данным расширением и могут быть
доступны только в том случае, если PHP был собран с
поддержкой этого расширения или же в том случае, если
данное расширение было подгружено во время выполнения.
-
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_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_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 колонки таблиц.