Update query.xml (#514)

This commit is contained in:
MIKHAIL ALFEROV
2023-11-26 12:00:45 +03:00
committed by GitHub
parent 792cd48301
commit eb55b45ba0

View File

@ -38,13 +38,14 @@
</para>
<note>
<para>
В случае, если длина выражения, которое передаётся в
<function>mysqli_query</function>, больше, чем
<literal>max_allowed_packet</literal> сервера, возвращаемые коды ошибки могут
различаться в зависимости от используемого драйвера. А это может быть либо
родной MySQL драйвер (<literal>mysqlnd</literal>), либо клиентская библиотека
MySQL (<literal>libmysqlclient</literal>). Поведение функции будет следующим:
Если длина передаваемого в функцию
<function>mysqli_query</function> выражения больше
значения системной переменной <literal>max_allowed_packet</literal> сервера, будет сгенерирована ошибка.
MySQL-драйвер (<literal>mysqlnd</literal>) и клиентская библиотека
MySQL (<literal>libmysqlclient</literal>) выбрасывают разные коды ошибок.
Поведение функции будет следующим:
</para>
<itemizedlist>
<listitem>
<para>
@ -90,20 +91,20 @@
как результат будет возвращён сервером MySQL.
</para>
<para>
<constant>MYSQLI_STORE_RESULT</constant> (по умолчанию) - возвращает объект
<constant>MYSQLI_STORE_RESULT</constant> (по умолчанию) возвращает объект
<classname>mysqli_result</classname> с буферизованным набором результатов.
</para>
<para>
<constant>MYSQLI_USE_RESULT</constant> - возвращает объект
<constant>MYSQLI_USE_RESULT</constant> возвращает объект
<classname>mysqli_result</classname> с небуферизованным набором результатов.
Пока есть отложенные записи, ожидающие выборки, линия соединения будет занята
и все последующие вызовы будут возвращать ошибку <literal>Commands out of sync</literal>.
Чтобы избежать ошибки, все записи должны быть получены с сервера или набор результатов должен быть отброшен путём вызова <function>mysqli_free_result</function>.
</para>
<para>
<constant>MYSQLI_ASYNC</constant> (доступно с mysqlnd) - запрос выполняется асинхронно, набор результатов сразу не возвращается.
Затем используется <function>mysqli_poll</function> для получения результатов по этим запросам.
Используется в сочетании с константой
<constant>MYSQLI_ASYNC</constant> (доступно с mysqlnd) запрос выполняется асинхронно, набор результатов сразу не возвращается.
Затем вызывают функцию <function>mysqli_poll</function> для получения результатов по этим запросам.
Можно использовать в сочетании с константой
<constant>MYSQLI_STORE_RESULT</constant> или
<constant>MYSQLI_USE_RESULT</constant>.
</para>
@ -118,7 +119,7 @@
<para>
Возвращает &false; в случае возникновения ошибки. В случае успешного выполнения запросов,
которые создают набор результатов, таких как <literal>SELECT, SHOW, DESCRIBE</literal> или
<literal>EXPLAIN</literal>, <function>mysqli_query</function> вернёт объект <classname>mysqli_result</classname>.
<literal>EXPLAIN</literal>, функция <function>mysqli_query</function> вернёт объект <classname>mysqli_result</classname>.
Для остальных успешных запросов <function>mysqli_query</function> вернёт &true;.
</para>
</refsect1>