archived-doc-ru/reference/pgsql/constants.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 3c6c95fcfd7d9eaa603df40327693ea8dff89d53 Maintainer: aur Status: ready -->
<!-- Reviewed: no -->
<appendix xml:id="pgsql.constants" xmlns="http://docbook.org/ns/docbook">
 &reftitle.constants;
 &extension.constants;

 <variablelist>
  <varlistentry xml:id="constant.pgsql-libpq-version">
   <term>
    <constant>PGSQL_LIBPQ_VERSION</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     Короткое обозначение версии модуля libpq, содержащее только цифры и точки.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-libpq-version-str">
   <term>
    <constant>PGSQL_LIBPQ_VERSION_STR</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     До PHP 8.0.0 — длинное обозначение версии модуля libpq, которое включает информацию о компиляторе.
     Начиная с PHP 8.0.0, значение идентично <constant>PGSQL_LIBPQ_VERSION</constant>,
     а использование <constant>PGSQL_LIBPQ_VERSION_STR</constant> устарело.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-assoc">
   <term>
    <constant>PGSQL_ASSOC</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_fetch_array</function>. Возвращает ассоциативный массив
     'имя поля' => 'значение поля'.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-num">
   <term>
    <constant>PGSQL_NUM</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_fetch_array</function>. Возвращает нумерованный
     массив 'номер поля' => 'значение поля'.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-both">
   <term>
    <constant>PGSQL_BOTH</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_fetch_array</function>. Возвращает массив значений поля,
     нумерованный (по номеру поля) и ассоциативный (по имени поля).
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-connect-force-new">
   <term>
    <constant>PGSQL_CONNECT_FORCE_NEW</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_connect</function> для принудительного создания
     нового подключения вместо использования идентичного существующего.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-connect-async">
   <term>
    <constant>PGSQL_CONNECT_ASYNC</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_connect</function> для создания асинхронного соединения.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-connection-auth-ok">
   <term>
    <constant>PGSQL_CONNECTION_AUTH_OK</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>

    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-connection-awaiting-response">
   <term>
    <constant>PGSQL_CONNECTION_AWAITING_RESPONSE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>

    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-connection-bad">
   <term>
    <constant>PGSQL_CONNECTION_BAD</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Возвращается функцией <function>pg_connection_status</function>, указывает на
     неработоспособность соединения с базой данных.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-connection-made">
   <term>
    <constant>PGSQL_CONNECTION_MADE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>

    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-connection-ok">
   <term>
    <constant>PGSQL_CONNECTION_OK</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Возвращается функцией <function>pg_connection_status</function>,
     указывает на нормальное (рабочее) состояние соединения с базой данных.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-connection-setenv">
   <term>
    <constant>PGSQL_CONNECTION_SETENV</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>

    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-connection-ssl-startup">
   <term>
    <constant>PGSQL_CONNECTION_SSL_STARTUP</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>

    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-connection-started">
   <term>
    <constant>PGSQL_CONNECTION_STARTED</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>

    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-seek-set">
   <term>
    <constant>PGSQL_SEEK_SET</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_lo_seek</function>. Операция поиска начнёт работу
     с начала объекта.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-seek-cur">
   <term>
    <constant>PGSQL_SEEK_CUR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_lo_seek</function>. Операция поиска начнёт работу
     с текущей позиции.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-seek-end">
   <term>
    <constant>PGSQL_SEEK_END</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_lo_seek</function>. Операция поиска начнёт работу
     с конца объекта.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-empty-query">
   <term>
    <constant>PGSQL_EMPTY_QUERY</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Возвращается функцией <function>pg_result_status</function>. Означает, что отправленная на
     сервер строка была пустой.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-command-ok">
   <term>
    <constant>PGSQL_COMMAND_OK</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Возвращается функцией <function>pg_result_status</function>. Означает успешное
     завершение команды, не возвращающей данных.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-tuples-ok">
   <term>
    <constant>PGSQL_TUPLES_OK</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Возвращается функцией <function>pg_result_status</function>. Означает успешное
     завершение команды, возвращающей какие-либо данные
     (например, <literal>SELECT</literal> или <literal>SHOW</literal>).
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-tuples-chunk">
   <term>
    <constant>PGSQL_TUPLES_CHUNK</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Возвращается функцией <function>pg_result_status</function>.
     Указывает на успешное выполнение команды, которая возвращает данные в режиме извлечения результов по частям.
     Возвращается для команд <literal>SELECT</literal>,
     когда режим извлечения результатов по частям установили функцией <function>pg_set_chunked_rows_size</function>
     Результирующий набор делится на несколько фрагментов, каждый из которых содержит предопределённое количество строк.
     Константа доступна с PHP 8.4.0 и libpq 17.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-copy-out">
   <term>
    <constant>PGSQL_COPY_OUT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Возвращается функцией <function>pg_result_status</function>.
     Сообщает, что началось копирование данных с сервера.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-copy-in">
   <term>
    <constant>PGSQL_COPY_IN</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Возвращается функцией <function>pg_result_status</function>.
     Сообщает, чтобы начато копирование данных на сервер.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-bad-response">
   <term>
    <constant>PGSQL_BAD_RESPONSE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Возвращается функцией <function>pg_result_status</function>.
     Сообщает, что ответ от сервера не был распознан.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-nonfatal-error">
   <term>
    <constant>PGSQL_NONFATAL_ERROR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Возвращается функцией <function>pg_result_status</function>.
     Сообщает, что произошла некритическая (уведомление или предупреждение) ошибка.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-fatal-error">
   <term>
    <constant>PGSQL_FATAL_ERROR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Возвращается функцией <function>pg_result_status</function>.
     Сообщает, что произошла критическая ошибка.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-transaction-idle">
   <term>
    <constant>PGSQL_TRANSACTION_IDLE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Возвращается функцией <function>pg_transaction_status</function>.
     Означает, что соединение на данный момент бездействует и не находится в рамках транзакции.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-transaction-active">
   <term>
    <constant>PGSQL_TRANSACTION_ACTIVE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Возвращается функцией <function>pg_transaction_status</function>. Означает состояние,
     когда команда находится в процессе выполнения. Запрос через соединение отправлен, но
     выполнение ещё не завершено.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-transaction-intrans">
   <term>
    <constant>PGSQL_TRANSACTION_INTRANS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Возвращается функцией <function>pg_transaction_status</function>. Означает, что соединение
     простаивает и находится в рамках транзакции.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-transaction-inerror">
   <term>
    <constant>PGSQL_TRANSACTION_INERROR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Возвращается функцией <function>pg_transaction_status</function>.
     Означает, что соединение простаивает и находится в рамках транзакции потерпевшей неудачу
     при выполнении.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-transaction-unknown">
   <term>
    <constant>PGSQL_TRANSACTION_UNKNOWN</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Возвращается функцией <function>pg_transaction_status</function>.
     Означает, что соединение разорвано.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-severity">
   <term>
    <constant>PGSQL_DIAG_SEVERITY</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_result_error_field</function>.
     Сообщает о затруднении. Возможны лишь перечисленные значения: <literal>ERROR</literal>,
     <literal>FATAL</literal>, или <literal>PANIC</literal> (в сообщении об ошибке), либо
     <literal>WARNING</literal>, <literal>NOTICE</literal>, <literal>DEBUG</literal>,
     <literal>INFO</literal>, или <literal>LOG</literal> (в уведомлении), либо перевод
     перечисленных значений в соответствии с текущей локализацией. Поле всегда определено.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-sqlstate">
   <term>
    <constant>PGSQL_DIAG_SQLSTATE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_result_error_field</function>.
     Код ошибки SQLSTATE. Код SQLSTATE определяет тип произошедшей ошибки; он может быть использован
     прикладной программой при выполнении специфических операций (таких как обработка ошибки)
     в ответ на ошибку базы данных.
     Это поле всегда определено и его значение не зависит от локализации.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-message-primary">
   <term>
    <constant>PGSQL_DIAG_MESSAGE_PRIMARY</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_result_error_field</function>.
     Основное удобочитаемое сообщение об ошибке (обычно одна строка). Поле всегда определено.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-message-detail">
   <term>
    <constant>PGSQL_DIAG_MESSAGE_DETAIL</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_result_error_field</function>.
     Детализация: дополнительное сообщение об ошибке, содержащее более подробную
     информацию о проблеме. Может содержать несколько строк.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-message-hint">
   <term>
    <constant>PGSQL_DIAG_MESSAGE_HINT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_result_error_field</function>.
     Подсказка: указание на возможные пути устранения ошибки. Отличается от детализации ошибки тем, что
     это просто предложения (возможно ошибочные), а не точная информация. Может содержать несколько строк.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-statement-position">
   <term>
    <constant>PGSQL_DIAG_STATEMENT_POSITION</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_result_error_field</function>.
     Строка, содержащая целое десятичное число, указывающее на позицию курсора в исходном выражении,
     в котором произошла ошибка.
     Первый символ имеет индекс 1, позиции измеряются в символах, а не в байтах.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-internal-position">
   <term>
    <constant>PGSQL_DIAG_INTERNAL_POSITION</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_result_error_field</function>.
     Эта константа определена так же, как поле <constant>PG_DIAG_STATEMENT_POSITION</constant>,
     но эту константу применяют, когда позиция курсора указывает на команду, сгенерированную сервером БД.
     Поле <constant>PG_DIAG_INTERNAL_QUERY</constant> будет появляться каждый раз, когда появляется это поле.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-internal-query">
   <term>
    <constant>PGSQL_DIAG_INTERNAL_QUERY</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_result_error_field</function>.
     Текст ошибки, сгенерированной внутренней командой СУБД, в которой произошла ошибка. Это может быть,
     например, SQL-запрос, сформированный функцией PL/pgSQL.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-context">
   <term>
    <constant>PGSQL_DIAG_CONTEXT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_result_error_field</function>.
     Указание на контекст, где произошла ошибка. В основном содержит трассировку
     запрограммированных функций и автоматически сгенерированных запросов. Трассировка
     выводится построчно, начиная с последней строки.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-source-file">
   <term>
    <constant>PGSQL_DIAG_SOURCE_FILE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_result_error_field</function>.
     Имя файла исходного кода PostgreSQL, в котором отмечена ошибка.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-source-line">
   <term>
    <constant>PGSQL_DIAG_SOURCE_LINE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_result_error_field</function>.
     Номер строки файла исходного кода PostgreSQL, где отмечена ошибка.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-source-function">
   <term>
    <constant>PGSQL_DIAG_SOURCE_FUNCTION</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_result_error_field</function>.
     Имя функции в исходном коде PostgreSQL, сообщающей об ошибке.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-schema-name">
   <term>
    <constant>PGSQL_DIAG_SCHEMA_NAME</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Добавлено в PHP 7.3.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-table-name">
   <term>
    <constant>PGSQL_DIAG_TABLE_NAME</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Добавлено в PHP 7.3.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-column-name">
   <term>
    <constant>PGSQL_DIAG_COLUMN_NAME</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Добавлено в PHP 7.3.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-datatype-name">
   <term>
    <constant>PGSQL_DIAG_DATATYPE_NAME</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Добавлено в PHP 7.3.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-diag-constraint-name">
   <term>
    <constant>PGSQL_DIAG_CONSTRAINT_NAME</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Добавлено в PHP 7.3.0.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.pgsql-errors-terse">
   <term>
    <constant>PGSQL_ERRORS_TERSE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_set_error_verbosity</function>.
     Даёт предписание, что выдаваемые сообщения будут содержать только важность ошибки, основной текст
     и указатель на место, где она произошла; эта информация обычно умещается в одну строку.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-errors-default">
   <term>
    <constant>PGSQL_ERRORS_DEFAULT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_set_error_verbosity</function>.
     В режиме по умолчанию сообщения об ошибках содержат описанную выше информацию, а также
     детализацию, подсказку или поля с контекстом ошибки (могут занимать несколько строк).
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-errors-verbose">
   <term>
    <constant>PGSQL_ERRORS_VERBOSE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_set_error_verbosity</function>.
     Задаёт режим, в котором в сообщения будут включены все возможные поля.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-errors-sqlstate">
   <term>
    <constant>PGSQL_ERRORS_SQLSTATE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_set_error_verbosity</function>.
     Включает только серьёзность ошибки и код ошибки <literal>SQLSTATE</literal>.
     Если код ошибки отсутствует, вывод аналогичен
     режиму <constant>PGSQL_ERRORS_TERSE</constant>.
     До PostgreSQL 11.1 вывод был таким же, как и в режиме
     <constant>PGSQL_ERRORS_TERSE</constant>.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.pgsql-notice-last">
   <term>
    <constant>PGSQL_NOTICE_LAST</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Указывается в функции <function>pg_last_notice</function>.
     Доступно с PHP 7.1.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-notice-all">
   <term>
    <constant>PGSQL_NOTICE_ALL</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Используется <function>pg_last_notice</function>.
     Доступно с PHP 7.1.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-notice-clear">
   <term>
    <constant>PGSQL_NOTICE_CLEAR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Используется <function>pg_last_notice</function>.
     Доступно с PHP 7.1.0.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.pgsql-status-long">
   <term>
    <constant>PGSQL_STATUS_LONG</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_result_status</function>. Указывает на то, что в качестве
     возвращаемого значения ожидается числовой код.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-status-string">
   <term>
    <constant>PGSQL_STATUS_STRING</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_result_status</function>.  Указывает на то, что в качестве
     возвращаемого значения ожидается текстовое представление статуса.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.pgsql-conv-ignore-default">
   <term>
    <constant>PGSQL_CONV_IGNORE_DEFAULT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_convert</function>.
     Игнорировать значения по умолчанию в таблице в процессе преобразования.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-conv-force-null">
   <term>
    <constant>PGSQL_CONV_FORCE_NULL</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_convert</function>.
     Заменять пустые строки  <type>string</type> на SQL <literal>NULL</literal> при преобразовании.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-conv-ignore-not-null">
   <term>
    <constant>PGSQL_CONV_IGNORE_NOT_NULL</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_convert</function>.
     Указывает, что не нужно конвертировать &null; в столбцы SQL <literal>NOT NULL</literal>.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.pgsql-dml-no-conv">
   <term>
    <constant>PGSQL_DML_NO_CONV</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_insert</function>, <function>pg_select</function>,
     <function>pg_update</function> и <function>pg_delete</function>.
     Все параметры передаются в исходном виде. Ручное экранирование обязательно,
     если параметры содержат пользовательские данные. Используйте для этих
     целей <function>pg_escape_string</function>.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-dml-exec">
   <term>
    <constant>PGSQL_DML_EXEC</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_insert</function>, <function>pg_select</function>,
     <function>pg_update</function> и <function>pg_delete</function>.
     Выполнить запрос с помощью этих функций.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-dml-async">
   <term>
    <constant>PGSQL_DML_ASYNC</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_insert</function>, <function>pg_select</function>,
     <function>pg_update</function> и <function>pg_delete</function>.
     Выполнить асинхронный запрос с помощью этих функций.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-dml-string">
   <term>
    <constant>PGSQL_DML_STRING</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_insert</function>, <function>pg_select</function>,
     <function>pg_update</function> и <function>pg_delete</function>.
     Вернуть строку с выполненным запросом.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-dml-escape">
   <term>
    <constant>PGSQL_DML_ESCAPE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Передаётся в функцию <function>pg_insert</function>, <function>pg_select</function>,
     <function>pg_update</function> и <function>pg_delete</function>.
     Применить экранирование ко всем параметрам вместо внутреннего вызова <function>pg_convert</function>.
     Эта опция пропускает просмотр метаданных. Запрос может быть таким же быстрым, как и
     <function>pg_query</function> и <function>pg_send_query</function>.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-polling-failed">
   <term>
    <constant>PGSQL_POLLING_FAILED</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Возвращается функцией <function>pg_connect_poll</function> и указывает на то, что
     попытка соединения провалилась.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-polling-reading">
   <term>
    <constant>PGSQL_POLLING_READING</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Возвращается функцией <function>pg_connect_poll</function> и указывает на то, что
     соединение ожидает, когда сокет PostgreSQL станет доступным для чтения.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-polling-writing">
   <term>
    <constant>PGSQL_POLLING_WRITING</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Возвращается функцией <function>pg_connect_poll</function> и указывает на то, что
     соединение ожидает, когда сокет PostgreSQL станет доступным для записи.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-polling-ok">
   <term>
    <constant>PGSQL_POLLING_OK</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Возвращается функцией <function>pg_connect_poll</function> и указывает на то, что
     соединение готово к использованию.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-polling-active">
   <term>
    <constant>PGSQL_POLLING_ACTIVE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Возвращается функцией <function>pg_connect_poll</function> и указывает на то, что
     соединение сейчас активно.
    </simpara>
   </listitem>
  </varlistentry>
    <varlistentry xml:id="constant.pgsql-diag-severity-nonlocalized">
   <term>
    <constant>PGSQL_DIAG_SEVERITY_NONLOCALIZED</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
    Важность; Возможны следующие значения: ERROR, FATAL или PANIC (в сообщении ошибке),
    либо WARNING, NOTICE, DEBUG, INFO или LOG (в сообщении предупреждении).
    Это идентично полю PG_DIAG_SEVERITY за исключением того, содержимое не локализовано.
    Доступно только в версии 9.6 или новее / PHP 7.3.0 или новее.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-show-context-never">
   <term>
    <constant>PGSQL_SHOW_CONTEXT_NEVER</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Константу указывают при вызове функции <function>pg_set_error_context_visibility</function>,
     скрывает показ контекста.
     Доступна с PHP 8.3.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-show-context-errors">
   <term>
    <constant>PGSQL_SHOW_CONTEXT_ERRORS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Константу указывают при вызове функции <function>pg_set_error_context_visibility</function>,
     поля контекста будут включены только в сообщения об ошибках.
     Это поведение по умолчанию.
     Доступна с PHP 8.3.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-show-context-always">
   <term>
    <constant>PGSQL_SHOW_CONTEXT_ALWAYS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Константу указывают при вызове функции <function>pg_set_error_context_visibility</function>,
     поля контекста будут включены в сообщения об ошибках, уведомления и предупреждения.
     Доступна с PHP 8.3.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.pgsql-trace-suppress-timestamps">
   <term>
    <constant>PGSQL_TRACE_SUPPRESS_TIMESTAMPS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Константу указывают при вызове функции <function>pg_trace</function>,
     метка времени не будет включена в сообщения трассировки.
     Доступна с PHP 8.3.0.
    </simpara>
   </listitem>
   </varlistentry>
  <varlistentry xml:id="constant.pgsql-trace-regress-mode">
   <term>
    <constant>PGSQL_TRACE_REGRESS_MODE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Константу указывают при вызове функции <function>pg_trace</function>,
     поля наподобие OIDs будут включены в сообщение трассировки.
     Доступна с PHP 8.3.0.
    </simpara>
   </listitem>
   </varlistentry>
 </variablelist>
</appendix>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->