language-snippets.ent

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 21e1338e9721534c00085ff3cff25e2dd2e84dc9 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->

<!ENTITY installation.enabled.disable 'Модуль включён по умолчанию. Он может быть отключён во время выполнения опцией:'>

<!-- Not used in EN anymore -->
<!ENTITY changelog.randomseed '<row xmlns="http://docbook.org/ns/docbook">
<entry>4.2.0</entry><entry>Генератор случайных чисел инициализируется автоматически.</entry></row>'>

<!ENTITY warn.deprecated.feature-5-3-0.removed-6-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>С версии PHP 5.3.0 эта возможность
признана <emphasis>УСТАРЕВШЕЙ</emphasis>. Крайне не рекомендуется на неё полагаться.</simpara></warning>'>

<!ENTITY warn.deprecated.function-5-3-0.removed-6-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>С версии PHP 5.3.0 эта функция
признана <emphasis>УСТАРЕВШЕЙ</emphasis>. Крайне не рекомендуется на неё полагаться.</simpara></warning>'>

<!-- Cautions -->
<!ENTITY caution.cryptographically-insecure '<caution xmlns="http://docbook.org/ns/docbook">
 <para>
  Функция не создаёт криптографически безопасные значения и <emphasis>не должна</emphasis> использоваться
  в криптографических целях или целях, которые требуют, чтобы возвращаемые значения были недоступны для разгадывания.
 </para>
 <para>
  Если нужна криптографически безопасная случайная последовательность,
  можно использовать класс <classname>Random\Randomizer</classname>
  с движком <classname>Random\Engine\Secure</classname>.
  Для простых сценариев существуют функции <function>random_int</function> и <function>random_bytes</function>
  с удобным API криптографически безопасного генератора псевдослучайных чисел (<acronym>CSPRNG</acronym>),
  поддерживаемого операционной системой.
 </para>
</caution>'>

<!ENTITY caution.mt19937-tiny-seed '<caution xmlns="http://docbook.org/ns/docbook">
 <para>
  Поскольку механизм Mt19937 ("Mersenne Twister") принимает в качестве значения только одно
  32-битное целое число, количество возможных случайных последовательностей ограничено всего
  2<superscript>32</superscript> (то есть 4 294 967 296), несмотря на огромный период Mt19937,
  равный 2<superscript>19937</superscript>-1.
 </para>
 <para>
  Если полагаться на неявное или явное случайное значение, дубликаты появятся гораздо раньше.
  Дублированные значения ожидаются с 50&#37; вероятностью после менее чем 80 000 случайно сгенерированных
  значений в соответствии с проблемой дня рождения. Вероятность дублирования значений составляет 10&#37;
  после случайной генерации примерно 30 000 значений.
 </para>
 <para>
  Это делает Mt19937 непригодным для применения в тех случаях,
  когда дублирование последовательностей не должно происходить
  с более чем ничтожной вероятностью. Если требуется воспроизводимое значение,
  то движки <classname>Random\Engine\Xoshiro256StarStar</classname>
  и <classname>Random\Engine\PcgOneseq128XslRr64</classname>
  поддерживают гораздо большие значения, которые вряд ли столкнутся случайно.
  Если воспроизводимость не требуется, механизм <classname>Random\Engine\Secure</classname>
  обеспечивает криптографически безопасную случайную последовательность.
 </para>
</caution>'>

<!-- Notes -->
<!ENTITY note.bin-safe '<note xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция
безопасна для обработки данных в двоичной форме.</simpara></note>'>

<!ENTITY note.clearstatcache '<note xmlns="http://docbook.org/ns/docbook"><simpara>Результаты
этой функции кешируются. Более подробную информацию смотрите в разделе
<function>clearstatcache</function>.</simpara></note>'>

<!ENTITY note.context-support '<para xmlns="http://docbook.org/ns/docbook">Ресурс (<type>resource</type>)
с <link linkend="stream.contexts">контекстом потока</link>.</para>'>

<!ENTITY note.exec-bg '<note xmlns="http://docbook.org/ns/docbook"><para>Если нужно
вызвать эту функцию в программе, работающей в качестве демона, проверяют,
что стандартный вывод функции направлен в файл или другой поток, иначе
PHP зависнет вплоть до конца выполнения программы.</para></note>'>

<!ENTITY note.exec-bypass-shell '<note xmlns="http://docbook.org/ns/docbook"><para>В Windows
функция <function>exec</function> для запуска команды запускает командную строку cmd.exe. Если
нужно запустить внешнюю программу без запуска командной строки cmd.exe,
вызывают функцию <function>proc_open</function> с установленной опцией
<parameter>bypass_shell</parameter>.</para></note>'>

<!ENTITY note.extractto-windows '<note xmlns="http://docbook.org/ns/docbook">
 <para>
  Файловые системы Windows NTFS
  не поддерживают некоторые символы в именах файлов, а именно <literal>&lt;|&gt;*?":</literal>.
  Имена файлов с точкой в конце также не поддерживаются. В отличие от некоторых инструментов извлечения, этот метод
  не поддерживает замену этих символов на подчёркивание, а вместо этого возникает ошибка при извлечении таких файлов.
 </para>
</note>
'>

<!ENTITY note.func-callback '<note xmlns="http://docbook.org/ns/docbook"><simpara>В качестве
аргумента вместо имени функции может быть передан массив, содержащий ссылку на объект
и имя метода.</simpara></note>'>

<!ENTITY note.func-callback-exceptions '<note xmlns="http://docbook.org/ns/docbook"><para>Callback-функции,
зарегистрированные такими функциями как <function>call_user_func</function>
и <function>call_user_func_array</function>, не будут вызваны при наличии не пойманного исключения,
брошенного в предыдущей callback-функции.</para></note>'>

<!ENTITY note.funcbyref '<note xmlns="http://docbook.org/ns/docbook"><para>Если аргументы
были переданы по ссылке, то все изменения аргументов будут отражены на возвращаемых функцией значениях.
В PHP 7 также будут возвращены текущие значения, если аргументы переданы по значению</para></note>'>

<!ENTITY note.funcnoparam '<note xmlns="http://docbook.org/ns/docbook"><para>Так как для определения
параметров этой функции необходим контекст выполнения, она не может быть передана
в качестве параметра в версиях PHP до 5.3.0. Если функцию всё же необходимо передать,
то нужно присвоить её переменной, которую уже можно использовать при передаче.</para></note>'>

<!ENTITY note.func-named-params '<note xmlns="http://docbook.org/ns/docbook"><para>Начиная с PHP 8.0.0
семейство функций func_*() предназначено для большей прозрачности в отношении именованных аргументов,
обрабатывая аргументы так, как если бы все они были переданы позиционно,
а отсутствующие аргументы заменяются их значениями по умолчанию.
Функция игнорирует набор неизвестных именованных вариативных аргументов.
К собранным неизвестным именованным аргументам можно получить доступ только через вариативный параметр.</para></note>'>

<!ENTITY note.line-endings '<note xmlns="http://docbook.org/ns/docbook"><simpara>Если возникают проблемы
с распознаванием PHP концов строк при чтении или создании файлов на Macintosh-совместимом компьютере,
включение опции <link linkend="ini.auto-detect-line-endings">auto_detect_line_endings</link>
может помочь решить проблему. </simpara></note>'>

<!ENTITY note.no-remote '<note xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция
неприменима для работы с <link linkend="features.remote-files">удалёнными файлами</link>,
поскольку файл должен быть доступен через файловую систему сервера.</simpara></note>'>

<!ENTITY note.not-bin-safe '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция (пока)
небезопасна для обработки данных в двоичной форме!</simpara></warning>'>

<!ENTITY note.no-key-association '<note xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция
присваивает новые ключи элементам <parameter>array</parameter>. Она удалит
все существующие ключи, а не просто переупорядочит их.</simpara></note>'>

<!ENTITY note.no-windows '<note xmlns="http://docbook.org/ns/docbook"><simpara>Для Windows-платформ
эта функция не реализована.</simpara></note>'>

<!ENTITY note.no-windows.extension '<note xmlns="http://docbook.org/ns/docbook"><simpara>Для Windows-платформ
этот модуль недоступен.</simpara></note>'>

<!ENTITY note.no-zts '<note xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция недоступна
в интерпретаторах PHP, собранных с поддержкой ZTS (Zend Thread Safety). Используйте <command>php -i</command>
или встроенную константу <constant>PHP_ZTS</constant>, чтобы узнать, собран ли PHP с ZTS.</simpara></note>'>

<!ENTITY note.randomseed '<note xmlns="http://docbook.org/ns/docbook"><simpara>Нет необходимости
инициализировать генератор случайных чисел функциями <function>srand</function>
или <function>mt_srand</function>, поскольку это происходит автоматически.</simpara></note>'>

<!ENTITY note.is-superglobal '<note xmlns="http://docbook.org/ns/docbook">
 <para>
  Это «суперглобальная»
  или автоматическая глобальная переменная. Это просто означает, что она доступна во всех контекстах скрипта.
  Нет необходимости выполнять <command>global $variable;</command> для доступа к ней внутри метода или функции.
 </para>
</note>
'>

<!ENTITY note.uses-ob '<note xmlns="http://docbook.org/ns/docbook"><para>Поскольку
в сигнатуре функции есть параметр <parameter>return</parameter>,
она будет использовать внутреннюю буферизацию вывода, поэтому эту функцию нельзя
указывать в качестве callback-функции при вызове функции <function>ob_start</function>.</para></note>'>

<!ENTITY note.uses-ob-php70 '<note xmlns="http://docbook.org/ns/docbook"><para>Поскольку
в сигнатуре функции есть параметр <parameter>return</parameter>,
она будет использовать внутреннюю буферизацию вывода до PHP 7.1.0, поэтому её нельзя использовать в качестве
callback-функции при вызове функции <function>ob_start</function>.</para></note>'>

<!ENTITY note.filesystem-time-res '<note xmlns="http://docbook.org/ns/docbook"><para>Учтите,
что обработка времени может отличаться в различных файловых системах.</para></note>'>

<!ENTITY note.uses-autoload '<note xmlns="http://docbook.org/ns/docbook"><para>Вызов этой функции
будет использовать все зарегистрированные <link linkend="language.oop5.autoload">функции автозагрузки</link>,
если класс ещё не известен.</para></note>'>

<!ENTITY note.network.header.sapi '<note xmlns="http://docbook.org/ns/docbook"><para>Доступ
к заголовкам и их вывод будет осуществляться только в случае,
если в используемом вами SAPI есть их поддержка.</para></note>'>

<!ENTITY note.sigchild '<note xmlns="http://docbook.org/ns/docbook"><para>Если PHP собран
с опцией --enable-sigchild, возвращаемое значение этой функции не определено.</para></note>'>

<!ENTITY note.sort-unstable '<note xmlns="http://docbook.org/ns/docbook">
<para>Функция сохраняет первоначальный порядок элементов, если
при сравнении значения двух элементов равны. До PHP 8.0.0 порядок элементов
в отсортированном массиве оставался неопределённым.</para></note>'>

<!ENTITY note.reset-index "<note xmlns='http://docbook.org/ns/docbook'>
 <para>
    Функция сбрасывает внутренний указатель массива на первый элемент.
 </para>
</note>
">

<!ENTITY note.resource-migration-8.0-dead-function '<note xmlns="http://docbook.org/ns/docbook">
 <para>
  Использование функции больше не имеет смысла. До PHP 8.0.0 она использовалась для закрытия ресурса.
 </para>
</note>
'>

<!-- Tips -->

<!ENTITY tip.fopen-wrapper '<tip xmlns="http://docbook.org/ns/docbook"><simpara>В эту функцию в качестве имени файла
можно передавать URL-адреса, если была включена директива <link linkend="ini.allow-url-fopen">fopen wrappers</link>.
Подробнее о том, как указать имя файла, рассказано в описании функции <function>fopen</function>.
В разделе «<xref linkend="wrappers"/>» также даны ссылки на информацию о способностях поддерживаемых обёрток,
замечания по работе с ними и список
предопределённых переменных, которые они дают.</simpara></tip>'>

<!ENTITY tip.fopen-wrapper.stat '<tip xmlns="http://docbook.org/ns/docbook"><simpara>Начиная с
PHP 5.0.0, эта функция также может быть использована с <emphasis>некоторыми</emphasis> обёртками url.
Список обёрток, поддерживаемых семейством функций <function>stat</function>,
смотрите в разделе <xref linkend="wrappers"/>.</simpara></tip>'>

<!ENTITY tip.ob-capture '<tip xmlns="http://docbook.org/ns/docbook"><simpara>Как и всё, что выводит результат в браузер,
<link linkend="book.outcontrol">функции контроля вывода</link> можно вызывать, чтобы перехватить
выводимые этой функцией данные и сохранять их, например в строку (<type>string</type>).</simpara></tip>'>

<!ENTITY tip.userlandnaming '<tip xmlns="http://docbook.org/ns/docbook">
<simpara>
 Смотрите также «<xref linkend="userlandnaming" />».
</simpara>
</tip>'
>


<!-- Warnings -->

<!ENTITY warn.escapeshell '<warning xmlns="http://docbook.org/ns/docbook"><para>Если
нужно передавать функции пользовательские данные,
вызывают функции <function>escapeshellarg</function> или <function>escapeshellcmd</function>,
чтобы пользователи не смогли обмануть систему, запустив произвольную команду.</para></warning>'>

<!ENTITY warn.experimental '<warning xmlns="http://docbook.org/ns/docbook">
<simpara>
Этот <emphasis>ЭКСПЕРИМЕНТАЛЬНЫЙ</emphasis> модуль. Поведение модуля, включая имена функций
и документацию, которая относится к модулю, может измениться в следующих версиях PHP без уведомления.
Модулем пользуются на свой страх и риск.
</simpara>
</warning>'>

<!ENTITY warn.deprecated.feature-5-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>С версии PHP 5.3.0 эта возможность
признана <emphasis>УСТАРЕВШЕЙ</emphasis>. Крайне не рекомендуется на неё полагаться.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-3-0.removed-5-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Эта возможность была
объявлена <emphasis>УСТАРЕВШЕЙ</emphasis> начиная с PHP 5.3.0 и
была <emphasis>УДАЛЕНА</emphasis> в PHP 5.4.0.</simpara></warning>'>

<!ENTITY warn.deprecated.function-5-3-0.removed-5-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция была
объявлена <emphasis>УСТАРЕВШЕЙ</emphasis> начиная с PHP 5.3.0 и
была <emphasis>УДАЛЕНА</emphasis> в PHP 5.4.0.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-5-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Эта возможность была
объявлена <emphasis>УСТАРЕВШЕЙ</emphasis> начиная с PHP 5.5.0. Крайне не
рекомендуется полагаться на неё в будущем.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-6-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Эта возможность была
объявлена <emphasis>УСТАРЕВШЕЙ</emphasis> начиная с PHP 5.6.0. Крайне не
рекомендуется полагаться на неё в будущем.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Эта возможность была
объявлена <emphasis>УСТАРЕВШЕЙ</emphasis> начиная с PHP 7.0.0. Крайне не
рекомендуется полагаться на неё в будущем.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-1-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Эта возможность была объявлена
<emphasis>УСТАРЕВШЕЙ</emphasis> начиная с PHP 7.1.0. Крайне не
рекомендуется полагаться на неё в будущем.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-1-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция объявлена
<emphasis>УСТАРЕВШЕЙ</emphasis> начиная с PHP 7.1.0. Использовать эту
функции крайне не рекомендуется.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-0-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция объявлена
<emphasis>УСТАРЕВШЕЙ</emphasis> начиная с PHP 7.0.0 и была
<emphasis>УДАЛЕНА</emphasis> в версии PHP 8.0.0. Использовать эту
функцию крайне не рекомендуется.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-1-0.removed-7-2-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция объявлена
<emphasis>УСТАРЕВШЕЙ</emphasis> начиная с PHP 7.1.0 и была
<emphasis>УДАЛЕНА</emphasis> в версии PHP 7.2.0. Использовать эту
функцию крайне не рекомендуется.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-2-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Эта функциональность объявлена
<emphasis>УСТАРЕВШЕЙ</emphasis> начиная с PHP 7.2.0 и её крайне не рекомендуется использовать.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-2-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Эта функциональность объявлена
<emphasis>УСТАРЕВШЕЙ</emphasis> начиная с PHP 7.2.0 и была <emphasis>УДАЛЕНА</emphasis> в версии PHP 8.0.0. Использовать эту
функцию крайне не рекомендуется.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-2-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция объявлена
<emphasis>УСТАРЕВШЕЙ</emphasis> начиная с PHP 7.2.0 и её использование крайне не рекомендовано.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-2-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция объявлена
<emphasis>УСТАРЕВШЕЙ</emphasis> начиная с PHP 7.2.0 и была <emphasis>УДАЛЕНА</emphasis> в версии PHP 8.0.0. Использовать эту
функцию крайне не рекомендуется.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Эта функциональность объявлена
<emphasis>УСТАРЕВШЕЙ</emphasis> начиная с PHP 7.3.0 и её крайне не рекомендуется использовать.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция объявлена
<emphasis>УСТАРЕВШЕЙ</emphasis> начиная с PHP 7.3.0 и её использование крайне не рекомендовано.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-3-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция объявлена
<emphasis>УСТАРЕВШЕЙ</emphasis> начиная с PHP 7.3.0 и была <emphasis>УДАЛЕНА</emphasis> в версии PHP 8.0.0. Использовать эту
функцию крайне не рекомендуется.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Эта функциональность объявлена
<emphasis>УСТАРЕВШЕЙ</emphasis> начиная с PHP 7.4.0 и её крайне не рекомендуется использовать.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция объявлена
<emphasis>УСТАРЕВШЕЙ</emphasis> начиная с PHP 7.4.0 и её использование крайне не рекомендовано.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-4-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция
<emphasis>УСТАРЕЛА</emphasis> начиная с PHP 7.4.0 и была <emphasis>УДАЛЕНА</emphasis> в PHP 8.0.0. Использовать эту
функцию крайне не рекомендуется.</simpara></warning>'>

<!ENTITY warn.feature.removed-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook">
<simpara>Данная функциональность была <emphasis>УДАЛЕНА</emphasis> в PHP 8.0.0.</simpara>
</warning>'>

<!ENTITY warn.deprecated.function-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция была
<emphasis>УДАЛЕНА</emphasis> в PHP 8.0.0. Использование этой функции не рекомендуется.</simpara></warning>'>

<!ENTITY warn.deprecated.function-8-1-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Функция объявлена
<emphasis>УСТАРЕВШЕЙ</emphasis> начиная с PHP 8.1.0. Использовать эту
функцию крайне не рекомендуется.</simpara></warning>'>

<!ENTITY warn.deprecated.function-8-2-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Функция объявлена
<emphasis>УСТАРЕВШЕЙ</emphasis> начиная с PHP 8.2.0. Использовать эту
функцию крайне не рекомендуется.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-8-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Эта функциональность объявлена
<emphasis>УСТАРЕВШЕЙ</emphasis> начиная с PHP 8.3.0 и её крайне не рекомендуется использовать.</simpara></warning>'>

<!ENTITY warn.deprecated.function-8-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Функция объявлена
<emphasis>УСТАРЕВШЕЙ</emphasis> начиная с PHP 8.3.0. Использовать эту
функцию крайне не рекомендуется.</simpara></warning>'>

<!ENTITY removed.php.future 'Эта возможность устарела и <emphasis xmlns="http://docbook.org/ns/docbook">будет</emphasis>
<emphasis xmlns="http://docbook.org/ns/docbook">удалена</emphasis> в будущем.'>

<!ENTITY warn.deprecated.function.removed-5-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция <emphasis>УСТАРЕЛА</emphasis>
и была <emphasis>УДАЛЕНА</emphasis> в PHP 5.3.0.</simpara></warning>'>

<!ENTITY warn.deprecated.function.removed-5-5-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция была помечена
<emphasis>УСТАРЕВШЕЙ</emphasis> и была <emphasis>УДАЛЕНА</emphasis> в PHP 5.5.0.</simpara></warning>'>

<!ENTITY warn.deprecated.alias-5-3-0 '<warning xmlns="http://docbook.org/ns/docbook">
<simpara>Этот псевдоним <emphasis>УСТАРЕЛ</emphasis> начиная с PHP 5.3.0. Крайне
 не рекомендуется полагаться на этот псевдоним.</simpara></warning>'>

<!ENTITY warn.deprecated.func-5-4-0 '<warning xmlns="http://docbook.org/ns/docbook">
<simpara>Эта функция <emphasis>УСТАРЕЛА</emphasis> начиная с PHP 5.4.0.
 Использование этой функции не рекомендуется.</simpara></warning>'>

<!ENTITY warn.deprecated.alias-5-4-0 '<warning xmlns="http://docbook.org/ns/docbook">
<simpara>Этот псевдоним функции <emphasis>УСТАРЕЛ</emphasis> начиная
 с PHP 5.4.0. Использование этого псевдонима крайне не рекомендуется.</simpara></warning>'>

<!ENTITY warn.deprecated.func-5-5-0 '<warning xmlns="http://docbook.org/ns/docbook">
<simpara>Эта функция была объявлена <emphasis>УСТАРЕВШЕЙ</emphasis> начиная с PHP 5.5.0.
Крайне не рекомендуется на неё полагаться.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-5-0.removed-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Эта функциональность считается
<emphasis>УСТАРЕВШЕЙ</emphasis> с PHP 5.5.0 и <emphasis>УДАЛЕНА</emphasis> в PHP 7.0.0.</simpara></warning>'>

<!ENTITY warn.deprecated.function-5-5-0.removed-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция считается
<emphasis>DEPRECATED</emphasis> с PHP 5.5.0 и <emphasis>УДАЛЕНА</emphasis> в PHP 7.0.0.</simpara></warning>'>

<!ENTITY warn.deprecated.function-4-1-0.removed-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция считается
<emphasis>УСТАРЕВШЕЙ</emphasis> с PHP 4.1.0 и <emphasis>УДАЛЕНА</emphasis> в PHP 7.0.0.</simpara></warning>'>

<!ENTITY warn.deprecated.function-5-3-0.removed-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция считается
<emphasis>УСТАРЕВШЕЙ</emphasis> с PHP 5.3.0 и <emphasis>УДАЛЕНА</emphasis> в PHP 7.0.0.</simpara></warning>'>

<!ENTITY warn.deprecated.alias-5-3-0.removed-7-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Этот псевдоним считается
<emphasis>УСТАРЕВШИМ</emphasis> с PHP 5.3.0 и <emphasis>УДАЛЁН</emphasis> в PHP 7.0.0.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-6-0.removed-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Эта функциональность считается
<emphasis>УСТАРЕВШЕЙ</emphasis> с PHP 5.6.0 и <emphasis>УДАЛЕНА</emphasis> в PHP 7.0.0.</simpara></warning>'>

<!ENTITY warn.removed.function-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция
<emphasis>УДАЛЕНА</emphasis> в PHP 7.0.0.</simpara></warning>'>

<!ENTITY warn.removed.function-7-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция была
<emphasis>УДАЛЕНА</emphasis> в PHP 7.4.0.</simpara></warning>'>

<!ENTITY warn.deprecated.alias-7-2-0.removed-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Псевдоним объявлен
<emphasis>УСТАРЕВШИМ</emphasis> в PHP 7.2.0 и <emphasis>УДАЛЁН</emphasis> в PHP 8.0.0.</simpara></warning>'>

<!ENTITY warn.deprecated.alias-7-4-0.removed-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Псевдоним объявлен
<emphasis>УСТАРЕВШИМ</emphasis> в PHP 7.4.0 и <emphasis>УДАЛЁН</emphasis> в PHP 8.0.0.</simpara></warning>'>

<!ENTITY warn.deprecated.alias-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Псевдоним объявлен
<emphasis>УСТАРЕВШИМ</emphasis> в PHP 8.0.0.</simpara></warning>'>

<!ENTITY warn.removed.alias-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Псевдоним
<emphasis>УДАЛЁН</emphasis> в PHP 8.0.0.</simpara></warning>'>

<!ENTITY warn.experimental.func '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
Эта <emphasis>ЭКСПЕРИМЕНТАЛЬНАЯ</emphasis> функция. Поведение функции,
её имя и документация, которая к относится к функции, могут измениться в следующих версиях PHP без уведомления.
Функцию включают в код на свой страх и риск.</simpara></warning>'>

<!ENTITY warn.imaprecodeyaz '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Модуль
<link linkend="book.imap">IMAP</link> не может использоваться вместе
с модулями <link linkend="book.recode">перекодировки</link>
и <link linkend="book.yaz">YAZ</link>. Причина этого в том, что они оба используют
одни и те же внутренние символы. Замечание: Версии Yaz 2.0 и выше избавлены от этого недостатка.</simpara></warning>'>

<!ENTITY warn.install.cgi '<warning xmlns="http://docbook.org/ns/docbook"><para>Используя
установку CGI, сервер открыт перед несколькими возможными уязвимостями. Пожалуйста,
ознакомьтесь с разделом «<link linkend="security.cgi-bin">Безопасность CGI</link>»
чтобы узнать, как можно защитить себя от таких атак.</para></warning>'>

<!ENTITY warn.passwordhashing '<warning xmlns="http://docbook.org/ns/docbook">
<para>
 Не рекомендуется использовать эту функцию для безопасного хранения
 паролей ввиду высокой скорости работы этого алгоритма. Подробнее об этом рассказано
 в разделе «<link linkend="faq.passwords.fasthash">Ответы
 на часто задаваемые вопросы по хешированию паролей</link>».
</para>
</warning>
'>

<!ENTITY warn.ssl-non-standard '<warning xmlns="http://docbook.org/ns/docbook"><para>При использовании SSL,
Microsoft IIS нарушает протокол, закрывая соединение без отправки индикатора <literal>close_notify</literal>.
PHP сообщит об этом как «SSL: Fatal Protocol Error» в тот момент, когда будет достигнут конца данных.
Чтобы обойти это, нужно установить директиву <link linkend="ini.error-reporting">error_reporting</link> на уровень,
исключающий E_WARNING. PHP умеет определять, что на стороне сервера проблемный IIS
при открытии потока обёрткой <literal>https://</literal> и не выводит предупреждение.
Если разработчик создаёт сокет <literal>ssl://</literal>
через вызов функции <function>fsockopen</function>,
он сам отвечает за определение и подавление этого предупреждения.</para></warning>'>

<!ENTITY warn.undocumented.class '
<warning xmlns="http://docbook.org/ns/docbook">
 <simpara>
  К настоящему времени этот класс ещё не был документирован; для ознакомления доступен только список свойств и методов.
 </simpara>
</warning>
'>

<!ENTITY warn.undocumented.func '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Функцию пока не задокументировали;
для знакомства доступен только список аргументов.</simpara></warning>'>

<!-- Deprecation and removal warnings designed for use with a list of
     alternatives. See en/reference/regex/functions/ereg.xml and
     en/reference/regex/reference.xml for examples of these in action. -->

<!ENTITY warn.deprecated.function.4-1-0.removed.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Эта функция объявлена <emphasis>УСТАРЕВШЕЙ</emphasis> в PHP 4.1.0
 и <emphasis>УДАЛЕНА</emphasis> в PHP 7.0.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Есть следующие альтернативы:
</para>
'>

<!ENTITY warn.deprecated.feature.5-3-0.removed.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Эта функциональность объявлена <emphasis>УСТАРЕВШЕЙ</emphasis> в PHP 5.3.0
 и <emphasis>УДАЛЕНА</emphasis> в PHP 7.0.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Есть следующие альтернативы:
</para>
'>

<!ENTITY warn.deprecated.function.5-3-0.removed.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Эта функция объявлена <emphasis>УСТАРЕВШЕЙ</emphasis> в PHP 5.3.0
 и <emphasis>УДАЛЕНА</emphasis> PHP 7.0.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Есть следующие альтернативы:
</para>
'>

<!ENTITY warn.deprecated.function.5-5-0.removed.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Эта функция объявлена <emphasis>УСТАРЕВШЕЙ</emphasis> в PHP 5.5.0
 и <emphasis>УДАЛЕНА</emphasis> PHP 7.0.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Есть следующие альтернативы:
</para>
'>

<!ENTITY warn.removed.feature.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Эта функциональность <emphasis>УДАЛЕНА</emphasis> в PHP 7.0.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Есть следующие альтернативы:
</para>
'>

<!ENTITY warn.removed.function.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Эта функция <emphasis>УДАЛЕНА</emphasis> в PHP 7.0.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Есть следующие альтернативы:
</para>
'>

<!ENTITY warn.deprecated.feature.7-1-0.removed.7-2-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Эта функциональность объявлена <emphasis>УСТАРЕВШЕЙ</emphasis> в PHP 7.1.0 и
 <emphasis>УДАЛЕНА</emphasis> в PHP 7.2.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Есть следующие альтернативы:
</para>
'>

<!ENTITY warn.deprecated.function.7-1-0.removed.7-2-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Эта функция объявлена <emphasis>УСТАРЕВШЕЙ</emphasis> в PHP 7.1.0 и
 <emphasis>УДАЛЕНА</emphasis> в PHP 7.2.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Есть следующие альтернативы:
</para>
'>

<!ENTITY warn.deprecated.function-8-1-0.alternatives '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Функция объявлена
<emphasis>УСТАРЕВШЕЙ</emphasis> в PHP 8.1.0. Полагаться на эту функцию
крайне не рекомендуется.</simpara></warning>
<para xmlns="http://docbook.org/ns/docbook">
 Есть следующие альтернативы:
</para>
'>

<!-- Misc -->

<!ENTITY version.exists.asof 'Существует начиная с PHP '>

<!ENTITY version.trunk.changelog 'В будущем'>

<!ENTITY no.function.parameters '
<para xmlns="http://docbook.org/ns/docbook">
 У этой функции нет параметров.
</para>
'>

<!ENTITY example.outputs '
<para xmlns="http://docbook.org/ns/docbook">
 Результат выполнения приведённого примера:
</para>
'>

<!ENTITY example.outputs.5 '
<para xmlns="http://docbook.org/ns/docbook">
 Результат выполнения приведённого примера в PHP 5:
</para>
'>

<!ENTITY example.outputs.53 '
<para xmlns="http://docbook.org/ns/docbook">
 Результат выполнения приведённого примера в PHP 5.3:
</para>
'>

<!ENTITY example.outputs.54 '
<para xmlns="http://docbook.org/ns/docbook">
 Результат выполнения приведённого примера в PHP 5.4:
</para>
'>

<!ENTITY example.outputs.55 '
<para xmlns="http://docbook.org/ns/docbook">
 Результат выполнения приведённого примера в PHP 5.5:
</para>
'>

<!ENTITY example.outputs.56 '
<para xmlns="http://docbook.org/ns/docbook">
 Результат выполнения приведённого примера в PHP 5.6:
</para>
'>

<!ENTITY example.outputs.7 '
<para xmlns="http://docbook.org/ns/docbook">
 Результат выполнения приведённого примера в PHP 7:
</para>
'>

<!ENTITY example.outputs.70 '
<para xmlns="http://docbook.org/ns/docbook">
 Результат выполнения приведённого примера в PHP 7.0:
</para>
'>

<!ENTITY example.outputs.71 '
<para xmlns="http://docbook.org/ns/docbook">
 Результат выполнения приведённого примера в PHP 7.1:
</para>
'>

<!ENTITY example.outputs.72 '
<para xmlns="http://docbook.org/ns/docbook">
 Результат выполнения приведённого примера в PHP 7.2:
</para>
'>

<!ENTITY example.outputs.73 '
<para xmlns="http://docbook.org/ns/docbook">
 Результат выполнения приведённого примера в PHP 7.3:
</para>
'>

<!ENTITY example.outputs.8 '
<para xmlns="http://docbook.org/ns/docbook">
 Результат выполнения приведённого примера в PHP 8:
</para>
'>

<!ENTITY example.outputs.8.similar '
<para xmlns="http://docbook.org/ns/docbook">
 Результат выполнения приведённого примера в PHP 8 аналогичен:
</para>
'>

<!ENTITY example.outputs.80 '
<para xmlns="http://docbook.org/ns/docbook">
 Результат выполнения приведённого примера в PHP 8.0:
</para>
'>

<!ENTITY example.outputs.81 '
<para xmlns="http://docbook.org/ns/docbook">
 Результат выполнения приведённого примера в PHP 8.1:
</para>
'>

<!ENTITY example.outputs.82 '
<para xmlns="http://docbook.org/ns/docbook">
 Результат выполнения приведённого примера в PHP 8.2:
</para>
'>

<!ENTITY example.outputs.82.similar '
<para xmlns="http://docbook.org/ns/docbook">
 Результат выполнения приведённого примера в PHP 8.2 аналогичен:
</para>
'>

<!ENTITY example.outputs.83 '
<para xmlns="http://docbook.org/ns/docbook">
 Результат выполнения приведённого примера в PHP 8.3:
</para>
'>

<!ENTITY example.outputs.83.similar '
<para xmlns="http://docbook.org/ns/docbook">
 Результат выполнения приведённого примера в PHP 8.3 аналогичен:
</para>
'>

<!ENTITY example.outputs.32bit '
<para xmlns="http://docbook.org/ns/docbook">
 Результат выполнения приведённого примера на 32-битных машинах:
</para>
'>

<!ENTITY example.outputs.64bit '
<para xmlns="http://docbook.org/ns/docbook">
 Результат выполнения приведённого примера на 64-битных машинах:
</para>
'>

<!ENTITY example.outputs.similar '
<para xmlns="http://docbook.org/ns/docbook">
 Вывод приведённого примера будет похож на:
</para>
'>

<!ENTITY examples.outputs '
<para xmlns="http://docbook.org/ns/docbook">
 Результат выполнения приведённых примеров:
</para>
'>

<!ENTITY examples.outputs.32bit '
<para xmlns="http://docbook.org/ns/docbook">
 Результат выполнения приведённых примеров на 32-битных машинах:
</para>
'>

<!ENTITY examples.outputs.64bit '
<para xmlns="http://docbook.org/ns/docbook">
 Результат выполнения приведённых примеров на 64-битных машинах:
</para>
'>

<!ENTITY examples.outputs.similar '
<para xmlns="http://docbook.org/ns/docbook">
 Вывод приведённых примеров будет похож на:
</para>
'>

<!ENTITY array.resetspointer '<note xmlns="http://docbook.org/ns/docbook"><simpara>При вызове функция
<link xmlns="http://docbook.org/ns/docbook" linkend="function.reset">сбрасывает</link> указатель массива, переданного параметром.</simpara></note>'>

<!ENTITY array.changelog.by-ref '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  Теперь функция выдаст ошибку уровня <constant>E_WARNING</constant>,
  если параметр callback-функции, переданной в параметр <parameter>callback</parameter>,
  ожидает передачу значения по ссылке.
 </entry>
</row>'>

<!ENTITY array.changelog.require-only-one '<row xmlns="http://docbook.org/ns/docbook">
  <entry>8.0.0</entry>
  <entry>
   Теперь разрешается вызывать функцию только с одним параметром.
   Раньше требовалось не менее двух параметров.
  </entry>
</row>'>

<!ENTITY seealso.array.sorting '<link xmlns="http://docbook.org/ns/docbook" linkend="array.sorting">Сравнение функций сортировки массивов</link>'>

<!ENTITY sort.flags.parameter '<varlistentry xmlns="http://docbook.org/ns/docbook">
  <term><parameter>flags</parameter></term>
  <listitem>
   <para>
    Необязательный второй параметр <parameter>flags</parameter> изменяет поведение сортировки и может принимать следующие значения:
   </para>
   <para>
    Флаги типов сортировки:
    <itemizedlist>
     <listitem>
      <simpara><constant>SORT_REGULAR</constant> — обычное сравнение элементов;
      подробности описаны в разделе <link linkend="language.operators.comparison">операторы сравнения</link></simpara>
     </listitem>
     <listitem>
      <simpara><constant>SORT_NUMERIC</constant> — числовое сравнение элементов</simpara>
     </listitem>
     <listitem>
      <simpara><constant>SORT_STRING</constant> — строковое сравнение элементов</simpara>
     </listitem>
     <listitem>
      <simpara>
       <constant>SORT_LOCALE_STRING</constant> — сравнение элементов как
       строк на основе текущего языкового стандарта. Флаг использует языковой стандарт,
       который можно изменить функцией <function>setlocale</function>
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       <constant>SORT_NATURAL</constant> — сравнение элементов как строки,
       используя "естественный порядок", например <function>natsort</function>
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       <constant>SORT_FLAG_CASE</constant> — можно объединять
       (побитовое ИЛИ) с
       <constant>SORT_STRING</constant> или
       <constant>SORT_NATURAL</constant> для сортировки строк без учёта регистра
      </simpara>
     </listitem>
    </itemizedlist>
   </para>
  </listitem>
 </varlistentry>
'>

<!ENTITY sort.callback.description '<para xmlns="http://docbook.org/ns/docbook">
 &return.callbacksort;
</para>
&callback.cmp;
<caution xmlns="http://docbook.org/ns/docbook">
 <para>
  Возвращение <emphasis>нецелых</emphasis> значений из функции сравнения,
  таких как число с плавающей точкой (<type>float</type>), приведёт к внутреннему
  приведению возвращаемого значения callback-функции к целому числу (<type>int</type>).
  Таким образом, значения <literal>0.99</literal> и <literal>0.1</literal> будут
  приведены к целочисленному значению <literal>0</literal>,
  что позволит сравнить эти значения как равные.
 </para>
</caution>'>

<!ENTITY sort.callback.description.presort '<caution xmlns="http://docbook.org/ns/docbook">
 <para>
  Callback-функция сортировки должна обрабатывать любое значение из любого массива в любом порядке,
  независимо от того, в каком порядке они были предоставлены вначале.
  Причина этого в том, что каждый отдельный массив сначала сортируется перед сравнением с другими массивами.

  Например:
  <programlisting role="php">
<![CDATA[
<?php

$arrayA = ["string", 1];
$arrayB = [["value" => 1]];
// $item1 and $item2 can be any of "string", 1 or ["value" => 1]
$compareFunc = static function ($item1, $item2) {
    $value1 = is_string($item1) ? strlen($item1) : (is_array($item1) ? $item1["value"] : $item1);
    $value2 = is_string($item2) ? strlen($item2) : (is_array($item2) ? $item2["value"] : $item2);
    return $value1 <=> $value2;
};

?>
]]>
  </programlisting>
 </para>
</caution>'>

<!ENTITY ini.shorthandbytes '<simpara xmlns="http://docbook.org/ns/docbook">
 Если указано целое значение (<type>int</type>),
 объём измеряется байтами. Можно также использовать сокращённую запись, которая описана в <link
 linkend="faq.using.shorthandbytes">этом разделе FAQ</link>.
</simpara>
'>

<!ENTITY info.deprecated.alias 'Для обратной совместимости может быть использован следующий устаревший псевдоним: '>

<!ENTITY info.function.alias 'Псевдоним функции '>

<!ENTITY info.method.alias 'Псевдоним метода '>

<!ENTITY info.function.alias.deprecated '<simpara xmlns="http://docbook.org/ns/docbook">Эта функция-псевдоним
устарела и сохранилась только из-за обратной совместимости.
Функцию не рекомендуют использовать, поскольку не исключают риск удаления функции из PHP в будущем.</simpara>'>

<!ENTITY ext.windows.path.dll 'Чтобы модуль работал, системной переменной
<envar xmlns="http://docbook.org/ns/docbook">PATH</envar>, которую содержит операционная система Windows,
дают доступ к <acronym xmlns="http://docbook.org/ns/docbook">DLL</acronym>-файлам.
Раздел <acronym xmlns="http://docbook.org/ns/docbook">FAQ</acronym>
«<link xmlns="http://docbook.org/ns/docbook" linkend="faq.installation.addtopath">Как добавить директорию PHP в переменную PATH в Windows</link>»
рассказывает, как это сделать. Не рекомендуют копировать DLL-файлы
из директории PHP в системную папку Windows, хотя это также решает проблему (потому что системная
директория по умолчанию записана в переменной <envar xmlns="http://docbook.org/ns/docbook">PATH</envar>).
<emphasis xmlns="http://docbook.org/ns/docbook">Модулю нужны
следующие файлы в переменной <envar>PATH</envar>:</emphasis> '>

<!ENTITY manual.migration.seealso 'Смотрите также руководство по миграции для версий PHP'>

<!ENTITY style.oop 'Объектно-ориентированный стиль'>
<!ENTITY style.procedural 'Процедурный стиль'>

<!ENTITY resource '<link xmlns="http://docbook.org/ns/docbook" linkend="language.types.resource">resource</link>'>

<!ENTITY foreach '<link xmlns="http://docbook.org/ns/docbook" linkend="control-structures.foreach">foreach</link>'>

<!ENTITY match '<link xmlns="http://docbook.org/ns/docbook" linkend="control-structures.match">match</link>'>

<!ENTITY yield '<link xmlns="http://docbook.org/ns/docbook" linkend="control-structures.yield">yield</link>'>

<!ENTITY parameter.context 'Для описания <literal xmlns="http://docbook.org/ns/docbook">контекстов</literal> обратитесь
к следующему разделу руководства: <link xmlns="http://docbook.org/ns/docbook" linkend="context">контекст</link>.'>

<!ENTITY parameter.use_include_path 'Если установлено в &true;, имя файла также ищется в
<link xmlns="http://docbook.org/ns/docbook" linkend="ini.include-path">include_path</link>'>

<!-- Returns -->

<!ENTITY return.type.true '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.2.0</entry>
 <entry>
  Тип возвращаемого значения теперь &true;; ранее было <type>bool</type>.
 </entry>
</row>'>

<!ENTITY return.falseforfailure ' или &false;, если возникла ошибка'>
<!ENTITY return.falseforfailure.style.procedural '&style.procedural; возвращает &false;, если возникла ошибка.'>

<!ENTITY return.success 'Возвращает &true; в случае успешного выполнения&return.falseforfailure;.'>

<!ENTITY return.nullorfalse 'Возвращает &null; в случае успешного выполнения&return.falseforfailure;.'>

<!ENTITY return.void 'Функция не возвращает значения после выполнения.'>

<!ENTITY return.true.always 'Функция всегда возвращает &true;.'>

<!ENTITY return.callbacksort 'Функция сравнения должна возвращать целое, которое меньше,
равно или больше нуля, если первый аргумент является соответственно меньшим, равным или большим, чем второй.'>

<!ENTITY return.falseproblem '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Функция
возвращает как логическое значение &false;,
так и нелогическое значение, которое приводится к &false;.
Прочитайте раздел
«<link linkend="language.types.boolean">Логический тип</link>»,
чтобы получить дополнительную информацию.
Используйте <link linkend="language.operators.comparison">оператор ===</link>
для проверки значения, которое возвращает функция.</simpara></warning>
'>

<!-- Standard -->
<!ENTITY standard.changelog.calling-on-objects '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Вызов функции на объекте (&object;) объявлен устаревшим.
  Объект (&object;) либо сначала преобразовывают в массив (&array;)
  функцией <function>get_mangled_object_vars</function>,
  либо пользуются методами класса,
  в котором реализовали интерфейс <interfacename>Iterator</interfacename>,
  например, <classname>ArrayIterator</classname>.
 </entry>
</row>
<row xmlns="http://docbook.org/ns/docbook">
 <entry>7.4.0</entry>
 <entry>
  Экземпляры классов библиотеки
  <link xmlns="http://docbook.org/ns/docbook" linkend="book.spl">SPL</link>
  теперь обрабатываются как пустые объекты,
  у которых нет свойств, вместо вызова метода
  интерфейса <interfacename>Iterator</interfacename>
  с тем же именем, что и у этой функция.
 </entry>
</row>
'>

<!ENTITY standard.changelog.binary-safe-string-comparison '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.2.0</entry>
 <entry>
  Функция теперь возвращает <literal>-1</literal> или <literal>1</literal>;
  ранее она возвращала отрицательное или положительное число.
 </entry>
</row>
'>

<!-- FileInfo -->
<!ENTITY fileinfo.parameters.finfo '<para xmlns="http://docbook.org/ns/docbook">Экземпляр
<classname>finfo</classname>, который возвращает функция <function>finfo_open</function>.</para>'>

<!ENTITY fileinfo.changelog.finfo-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Параметр <parameter>finfo</parameter> теперь ожидает экземпляр класса <classname>finfo</classname>;
  раньше параметр ждал ресурс (&resource;).
 </entry>
</row>'>

<!-- OpenSSL -->
<!ENTITY openssl.param.x509 '<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>x509</parameter></term>
<listitem>
 <para>
  Для списка корректных значений смотрите <link linkend="openssl.certparams">Параметры ключей/сертификатов</link>.
 </para>
</listitem>
</varlistentry>'>
<!ENTITY openssl.param.csr '<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>csr</parameter></term>
<listitem>
 <para>
  Для получения списка допустимых значений смотрите <link linkend="openssl.certparams">параметры CSR</link>.
 </para>
</listitem>
</varlistentry>'>

<!ENTITY openssl.param.key '<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>key</parameter></term>
<listitem>
 <para>
  Список допустимых значений смотри: <link linkend="openssl.certparams">параметры публичного/приватного ключа</link>.
 </para>
</listitem>
</varlistentry>'>
<!-- Image (GD) Notes -->
<!ENTITY note.config.t1lib '<note xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция доступна только в
случае, если PHP был скомпилирован с опцией <option role="configure">--with-t1lib[=DIR]</option>.</simpara></note>'>

<!ENTITY note.freetype '<note xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция доступна только в случае, если
PHP был скомпилирован с поддержкой freetype (<option role="configure">--with-freetype-dir=DIR</option>)
</simpara></note>'>

<!ENTITY note.gd.notrequired '<note xmlns="http://docbook.org/ns/docbook"><para>Этой функции не требуется библиотека GD.</para></note>'>

<!ENTITY note.gd.interpolation '<note xmlns="http://docbook.org/ns/docbook"><para>Эта функция подвержена влиянию метода интерполяции, установленным функцией <function>imagesetinterpolation</function>.</para></note>'>

<!ENTITY gd.image.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>image</parameter></term><listitem><para>Объект <classname>GdImage</classname>,
который возвращает одна из функций, создающих изображения,
например, <function>imagecreatetruecolor</function>.</para></listitem></varlistentry>'>

<!ENTITY gd.font.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>font</parameter></term><listitem><para>Принимает значения
1, 2, 3, 4, 5 для встроенных шрифтов в кодировке
latin2 (более высокое число соответствует большему шрифту) или экземпляр класса <classname>GdFont</classname>,
который возвращает функция <function>imageloadfont</function>.
</para></listitem></varlistentry>'>

<!ENTITY gd.changelog.gdfont-instance '<row xmlns="http://docbook.org/ns/docbook">
  <entry>8.1.0</entry>
  <entry>
  Параметр <parameter>font</parameter> теперь принимает как экземпляр класса <classname>GdFont</classname>,
  так и целое число (&integer;); раньше параметр принимал только целое число (&integer;).
  </entry>
</row>'>

<!ENTITY gd.ttf.fontfile "
<varlistentry xmlns='http://docbook.org/ns/docbook'>
 <term><parameter>fontfile</parameter></term>
 <listitem>
  <para>
   Путь к шрифту TrueType, который вы хотите использовать.
  </para>
  <para>
   В зависимости от того, какая библиотека GD загружена в PHP, <emphasis>если
   параметр <parameter>fontfile</parameter> не начинается с символа
   <literal>/</literal>, то к имени файла будет добавлено
   расширение <literal>.ttf</literal></emphasis> и библиотека будет пытаться искать это имя файла
   по определённому библиотекой пути шрифтов.
  </para>
  <para>
   При работе с версиями библиотеки GD ниже 2.0.18
   как «разделитель путей» для отдельных файлов шрифтов использовался символ
   <literal>пробела</literal>, а не точка с запятой.
   Непреднамеренное использование этой особенности приведёт к предупреждению:
   <literal>Warning: Could not find/open font</literal>. Единственное
   решение для этих версий библиотек — переместить файлы шрифтов
   в директорию, имя которой не содержит пробелов.
  </para>
  <para>
   Часто, когда шрифт лежит в том же каталоге, что и скрипт PHP, который работает с этим шрифтом,
   помогает следующий трюк.
   <programlisting role='php'>
<![CDATA[
<?php
// Установка переменной окружения для GD
putenv('GDFONTPATH=' . realpath('.'));

// Имя шрифта для использования (обратите внимание, что расширение .ttf не указывается)
$font = 'SomeFont';
?>
]]>
   </programlisting>
  </para>
  <note>
   <para>
    Обратите внимание, что <link linkend='ini.open-basedir'>open_basedir</link>
    <emphasis>не</emphasis> применяется к <parameter>fontfile</parameter>.
   </para>
  </note>
 </listitem>
</varlistentry>
">

<!ENTITY gd.return.identifier 'Возвращает объект изображения в случае успешного выполнения или &false;, если возникла ошибка.'>

<!ENTITY gd.return.trueonerror '<caution xmlns="http://docbook.org/ns/docbook"><simpara>Однако,
если libgd не может вывести изображения, эта функция вернёт &true;.</simpara></caution>'>

<!ENTITY gd.identifier.color "Идентификатор цвета, созданный функцией
<function xmlns='http://docbook.org/ns/docbook'>imagecolorallocate</function>.">

<!ENTITY gd.value.red 'Значение красного компонента цвета.'>

<!ENTITY gd.value.green 'Значение зелёного компонента цвета.'>

<!ENTITY gd.value.blue 'Значение синего компонента цвета.'>

<!ENTITY gd.source.height 'Высота исходного изображения.'>

<!ENTITY gd.source.width 'Ширина исходного изображения.'>

<!ENTITY gd.image.path 'Путь, или открытый потоковый ресурс (который автоматически закрывается после завершения функции), для сохранения файла. Если не установлен или равен &null;, изображение будет выведено в поток вывода в бинарном виде.'>

<!ENTITY gd.image.new 'Создаёт новое изображение из файла или URL'>

<!ENTITY gd.image.source 'Ресурс исходного изображения.'>

<!ENTITY gd.image.destination 'Ресурс целевого изображения.'>

<!ENTITY gd.image.output 'Выводит изображение в браузер или пишет в файл'>

<!ENTITY gd.image.colors 'Если изображение было создано из файла, то будут распознаны только цвета, используемые в изображении. Цвета, которые используются только в палитре, распознаны не будут.'>

<!ENTITY gd.font.size 'Размер шрифта в типографских пунктах.'>

<!ENTITY gd.constants.types '<simpara xmlns="http://docbook.org/ns/docbook">
Возвращается как значение функции <function>imagetypes</function>.
</simpara>'>

<!ENTITY gd.constants.color '<simpara xmlns="http://docbook.org/ns/docbook">Специальный вариант цвета, который может быть использован вместо определённого с помощью
<function>imagecolorallocate</function> и <function>imagecolorallocatealpha</function>.
</simpara>'>

<!ENTITY gd.constants.affine '<simpara xmlns="http://docbook.org/ns/docbook">Константа типа аффинного преобразования; константу указывают в качестве значения аргумента функции <function>imageaffinematrixget</function> .</simpara>'>

<!ENTITY gd.constants.arc '<simpara xmlns="http://docbook.org/ns/docbook">Константа стиля, константу указывают в качестве значения аргумента функции <function>imagefilledarc</function>.</simpara>'>

<!ENTITY gd.constants.gd2 '<simpara xmlns="http://docbook.org/ns/docbook">Константа типа, константу указывают в качестве значения аргумента функции <function>imagegd2</function>.</simpara>'>

<!ENTITY gd.constants.effect '<simpara xmlns="http://docbook.org/ns/docbook">Эффект альфа-смешения, константу указывают в качестве значения аргумента функции <function>imagelayereffect</function>.</simpara>'>

<!ENTITY gd.constants.filter '<simpara xmlns="http://docbook.org/ns/docbook">
Специальный фильтр GD, константу указывают в качестве значения аргумента функции <function>imagefilter</function>.
</simpara>'>

<!ENTITY gd.constants.type '<simpara xmlns="http://docbook.org/ns/docbook">
Константа типа изображения, константу указывают в качестве значения аргумента функций <function>image_type_to_mime_type</function> и  <function>image_type_to_extension</function>.
</simpara>'>

<!ENTITY gd.constants.png-filter '<simpara xmlns="http://docbook.org/ns/docbook">
Специальный фильтр PNG filter, константу указывают в качестве значения аргумента функции <function>imagepng</function>.
</simpara>'>

<!ENTITY gd.constants.flip '<simpara xmlns="http://docbook.org/ns/docbook">
Константу указывают в качестве значения аргумента функции <function>imageflip</function>, доступна с PHP 5.5.0.
</simpara>'>

<!ENTITY gd.constants.interpolation '<simpara xmlns="http://docbook.org/ns/docbook">
Константу указывают в качестве значения аргумента функции <function>imagesetinterpolation</function>, доступна с PHP 5.5.0.
</simpara>'>

<!ENTITY gd.changlog.t1lib '<row xmlns="http://docbook.org/ns/docbook">
<entry>7.0.0</entry><entry>Поддержка T1Lib удалена из PHP и эта функция, соответственно, тоже.</entry>
</row>'>

<!ENTITY gd.deprecated.gd-formats '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Форматы изображений GD и GD2 являются проприетарными форматами изображений libgd. Они должны рассматриваться как <emphasis>устаревшие</emphasis> и должны использоваться только для целей разработки и тестирования.</simpara></warning>'>

<!ENTITY gd.changelog.image-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  Параметр <parameter>image</parameter> теперь ожидает экземпляр класса <classname>GdImage</classname>;
  раньше параметр ждал корректный <literal>gd</literal>-ресурс (<type>resource</type>).
 </entry>
</row>'>

<!-- DBM notes -->

<!ENTITY dbm.dbm-identifier.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>dbm_identifier</parameter></term><listitem><para>Идентификатор соединения DBM,
полученный из <function>dbmopen</function>.</para></listitem></varlistentry>'>

<!-- JSON notes -->

<!ENTITY json.implementation.superset '
<note xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <para>
  PHP реализует расширенный набор JSON, который описывает исходный стандарт
  <link xlink:href="&url.rfc;7159">RFC 7159</link>.
 </para>
</note>
'>

<!-- cURL notes -->

<!ENTITY curl.ch.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>handle</parameter>
</term><listitem><para>Дескриптор cURL, полученный из <function>curl_init</function>.</para></listitem></varlistentry>'>

<!ENTITY curl.mh.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>multi_handle</parameter>
</term><listitem><para>Мультидескриптор cURL, полученный из <function>curl_multi_init</function>.</para></listitem></varlistentry>'>

<!ENTITY curl.sh.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>share_handle</parameter>
</term><listitem><para>Разделяемый обработчик cURL, который возвращает функция
<function>curl_share_init</function>.</para></listitem></varlistentry>'>

<!ENTITY curl.changelog.handle-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  Параметр <parameter>handle</parameter> теперь ожидает экземпляр класса <classname>CurlHandle</classname>;
  раньше, параметр ждал ресурс (<type>resource</type>).
 </entry>
</row>'>

<!ENTITY curl.changelog.multi-handle-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>multi_handle</parameter> теперь ожидает экземпляр;
  раньше, ожидался ресурс (<type>resource</type>).
 </entry>
</row>'>

<!ENTITY curl.changelog.share-handle-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>share_handle</parameter> expects a <classname>CurlShareHandle</classname>
  instance now; previously, a <type>resource</type> was expected.
 </entry>
</row>'>

<!-- dbase notes -->

<!ENTITY dbase.type-conversion '<para xmlns="http://docbook.org/ns/docbook">
Каждое поле преобразовывается в соответствующий тип PHP, за исключением:
<itemizedlist>
 <listitem>
  <simpara>
   Объект Date преобразовывается в строку.
  </simpara>
 </listitem>
 <listitem>
  <simpara>
   Объект DateTime преобразовывается в строку.
  </simpara>
 </listitem>
 <listitem>
  <simpara>
   Целые, выходящие из диапазона
   <constant>PHP_INT_MIN</constant>..<constant>PHP_INT_MAX</constant>, преобразовываются в строки.
  </simpara>
 </listitem>
 <listitem>
  <simpara>
   До dbase 7.0.0 логические значение (<literal>L</literal>) преобразовываются
   в <literal>1</literal> или <literal>0</literal>.
  </simpara>
 </listitem>
</itemizedlist>
</para>'>

<!-- enchant entities -->

<!ENTITY enchant.param.broker '<varlistentry xmlns="http://docbook.org/ns/docbook">
     <term><parameter>broker</parameter></term>
     <listitem>
      <para>
       Провайдер Enchant, который возвращает функция <function>enchant_broker_init</function>.
      </para>
     </listitem>
    </varlistentry>'>

<!ENTITY enchant.param.dictionary '<varlistentry xmlns="http://docbook.org/ns/docbook">
     <term><parameter>dictionary</parameter></term>
     <listitem>
      <para>
       Словарь Enchant, который возвращает функция <function>enchant_broker_request_dict</function>
       или <function>enchant_broker_request_pwl_dict</function>.
      </para>
     </listitem>
    </varlistentry>'>

<!ENTITY enchant.changelog.broker-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  Параметр <parameter>broker</parameter> ожидает экземпляр класса <classname>EnchantBroker</classname>;
  Раньше параметр ждал ресурс (&resource;).
 </entry>
</row>'>

<!ENTITY enchant.changelog.dictionary-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  Параметр <parameter>dictionary</parameter> ожидает экземпляр класса <classname>EnchantDictionary</classname>;
  Раньше параметр ждал ресурс (&resource;).
 </entry>
</row>'>

<!-- IMAP notes -->

<!ENTITY imap.changelog.imap-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Параметр <parameter>imap</parameter> теперь ожидает экземпляр класса <classname>IMAP\Connection</classname>;
  раньше параметр ждал ресурс (&resource;) <literal>imap</literal>.
 </entry>
</row>'>

<!ENTITY imap.imap-parameter.imap '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>imap</parameter></term><listitem><para>Экземпляр класса <classname>IMAP\Connection</classname>.</para></listitem></varlistentry>'>

<!-- Deprecated -->
<!ENTITY imap.imap-stream.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>imap</parameter></term><listitem><para>Поток IMAP, полученный из
<function>imap_open</function>.</para></listitem></varlistentry>'>

<!ENTITY imap.pattern '<para xmlns="http://docbook.org/ns/docbook">Определяет начало поиска в иерархии почтовых ящиков.
</para><para xmlns="http://docbook.org/ns/docbook">Есть два специальных символа, которые можно использовать при передаче
как часть <parameter>pattern</parameter>:
&apos;<literal>*</literal>&apos; и &apos;<literal>&#37;</literal>&apos;.
&apos;<literal>*</literal>&apos; возвращает все почтовые ящики. Если вы передадите
<parameter>pattern</parameter> как &apos;<literal>*</literal>&apos;, то получите полный список иерархии почтовых ящиков.
&apos;<literal>&#37;</literal>&apos; вернёт только текущий уровень.
&apos;<literal>&#37;</literal>&apos;, переданный как параметр <parameter>pattern</parameter>, вернёт почтовые ящики
только на самом верхнем уровне; &apos;<literal>~/mail/&#37;</literal>&apos;
на <literal>UW_IMAPD</literal> вернёт все ящики в директории <filename>~/mail</filename>, кроме тех, которые
находятся в её поддиректориях.</para>'>

<!ENTITY imap.mailboxname.insecure '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
Если <link linkend="ini.imap.enable-insecure-rsh">imap.enable_insecure_rsh</link> не отключён, то передача в этот параметр не проверенных данных <emphasis>не безопасна</emphasis>.
</simpara></warning>'>

<!-- intl notes -->

<!ENTITY intl.parameter.intl-calendar '<para xmlns="http://docbook.org/ns/docbook">Экземпляр класса
<classname>IntlCalendar</classname>.</para>'>

<!ENTITY intl.error.intl-calendar '<para xmlns="http://docbook.org/ns/docbook">Если возникла ошибка,
также возвращается &false;. Для обнаружения условий ошибки вызывают функцию
<function>intl_get_error_code</function> или настраивают выбрасывание
<link linkend="ini.intl.use-exceptions">исключений</link> в Intl.</para>'>

<!ENTITY intl.codepoint.parameter '<para xmlns="http://docbook.org/ns/docbook">
Целочисленное (<type>int</type>) значение кодовой точки (например, <literal>0x2603</literal>
для символа <emphasis>U+2603 СНЕГОВИК</emphasis>), или символ в виде
строки (<type>string</type>) в кодировке UTF-8 (например <literal>"\u{2603}"</literal>).
</para>
'>

<!ENTITY intl.codepoint.return '<para xmlns="http://docbook.org/ns/docbook">Возвращаемое
значение должно быть целым числом (<type>int</type>), если только символ
не был передан как строка UTF-8 (<type>string</type>),
в этом случае вернётся строка (<type>string</type>).
В случае ошибки возвращает &null;.</para>'>

<!ENTITY intl.codepoint.example 'Тестирование различных способов задания'>

<!ENTITY intl.property.parameter '<para xmlns="http://docbook.org/ns/docbook">Свойство Unicode для отображения (Смотри константы <literal>IntlChar::PROPERTY_*</literal>).</para>'>

<!ENTITY intl.locale-len.return '<para xmlns="http://docbook.org/ns/docbook">Возвращает &null;, если длина <parameter>locale</parameter> превышает <constant>INTL_MAX_LOCALE_LEN</constant>.</para>'>

<!ENTITY intl.property.example 'Тестирование различных свойств'>

<!-- LDAP notes -->

<!ENTITY ldap.parameter.ldap 'Экземпляр класса <classname xmlns="http://docbook.org/ns/docbook">LDAP\Connection</classname>,
который возвращает функция <function xmlns="http://docbook.org/ns/docbook">ldap_connect</function>.'>

<!ENTITY ldap.parameter.result 'Экземпляр класса <classname xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname>,
который возвращает функция <function xmlns="http://docbook.org/ns/docbook">ldap_list</function>
или <function xmlns="http://docbook.org/ns/docbook">ldap_search</function>.'>

<!ENTITY ldap.parameter.entry 'Экземпляр класса <classname xmlns="http://docbook.org/ns/docbook">LDAP\ResultEntry</classname>.'>

<!ENTITY ldap.warn.control-paged '<warning xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Функцию объявили <emphasis>УСТАРЕВШЕЙ</emphasis> в PHP 7.4.0
  и <emphasis>УДАЛИЛИ</emphasis> в PHP 8.0.0.
  Вместо этой функции вызывают функцию <function>ldap_search</function>
  с передачей в параметр <parameter>controls</parameter>
  управляющих объектов протокола LDAP.
  Раздел «<link linkend="ldap.controls">Управляющие объекты LDAP</link>»
  даёт дополнительную информацию.
 </simpara>
</warning>'>

<!ENTITY ldap.changelog.controls-nullable '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  Параметр <parameter>controls</parameter> теперь допускает значение null;
  раньше значение по умолчанию равнялось <literal>[]</literal>.
 </entry>
</row>'>

<!ENTITY ldap.changelog.ldap-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Параметр <parameter>ldap</parameter> теперь ожидает экземпляр класса <classname>LDAP\Connection</classname>;
  раньше параметр ждал ресурс (&resource;) <literal>ldap link</literal> .
 </entry>
</row>'>

<!ENTITY ldap.changelog.entry-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Параметр <parameter>entry</parameter> теперь ожидает экземпляр класса <classname>LDAP\ResultEntry</classname>;
  раньше параметр ждал ресурс (&resource;) <literal>ldap result entry</literal>.
 </entry>
</row>'>

<!ENTITY ldap.changelog.result-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Параметр <parameter>result</parameter> теперь ожидает экземпляр класса <classname>LDAP\Result</classname>;
  раньше параметр ждал ресурс (&resource;) <literal>ldap result</literal>.
 </entry>
</row>'>

<!ENTITY ldap.changelog.return-result-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Возвращает экземпляр класса <classname>LDAP\Result</classname>;
  ранее возвращался ресурс (&resource;).
 </entry>
</row>'>

<!ENTITY ldap.changelog.return-result-entry-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Возвращает экземпляр класса <classname>LDAP\ResultEntry</classname>;
  ранее возвращался ресурс (&resource;).
 </entry>
</row>'>

<!ENTITY ldap.return-result 'Возвращает экземпляр
класса <classname xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname>&return.falseforfailure;.'>

<!ENTITY ldap.return-result-array 'Возвращает экземпляр
класса <classname xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname>,
массив экземпляров класса
<classname xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname>&return.falseforfailure;.'>

<!ENTITY ldap.return-result-array-info '<para xmlns="http://docbook.org/ns/docbook">Можно
также выполнять параллельный поиск. В этом случае первым аргументом должен быть массив
экземпляров <classname>LDAP\Connection</classname>, а не один экземпляр.
Если поиск не должен использовать один и тот же базовый DN и фильтр, в качестве аргументов
можно передать массив базовых DN и/или массив фильтров.
Количество элементов в массивах должно совпадать с количеством экземпляров <classname>LDAP\Connection</classname>,
поскольку первые записи массивов используются для одного поиска, вторые — для другого и так далее.
При параллельном поиске возвращается массив экземпляров <classname>LDAP\Result</classname>,
за исключением возникновения ошибки, когда возвращается значение &false;.</para>'>

<!-- mbstring notes -->

<!ENTITY note.mbstring.encoding.internal '<note xmlns="http://docbook.org/ns/docbook"><para>Для этой функции будет
использована внутренняя кодировка или кодировка, установленная функцией <function>mb_regex_encoding</function>.</para></note>'>

<!ENTITY note.mbstring.encoding.current '<note xmlns="http://docbook.org/ns/docbook"><para>Кодировка символов, указанная функцией <function>mb_regex_encoding</function>,
будет по умолчанию использована для этой функции.</para></note>'>

<!ENTITY mbstring.encoding.parameter '<para xmlns="http://docbook.org/ns/docbook">Параметр <parameter>encoding</parameter> —
это кодировка символов. Если он опущен или равен &null;, для него будет установлена внутренняя кодировка символов.</para>'>

<!ENTITY mbstring.warning.e-modifier '<warning xmlns="http://docbook.org/ns/docbook"><para>Никогда не используйте
модификатор <literal>e</literal> при работе с данными, полученными из недостоверных источников. Не выполняется никакого
автоматического экранирования этих данных (в отличие от <function>preg_replace</function>). Игнорирование этих требований,
скорее всего, создаст уязвимость выполнения удалённого кода в приложении.</para></warning>'>

<!ENTITY mbstring.changelog.encoding-nullable '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  Теперь параметр <parameter>encoding</parameter> принимает значение &null;.
 </entry>
</row>'>

<!ENTITY mbstring.changelog.needle-empty '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>needle</parameter> теперь принимает пустую строку.
 </entry>
</row>'>

<!-- mcrypt notes -->

<!ENTITY mcrypt.parameter.cipher '<para xmlns="http://docbook.org/ns/docbook">Одна из констант <constant>MCRYPT_ciphername</constant> или название алгоритма в виде строки.</para>'>

<!ENTITY mcrypt.parameter.iv '<para xmlns="http://docbook.org/ns/docbook">Указывают для инициализации в режимах CBC, CFB, OFB, а также в некоторых алгоритмах в режиме STREAM. Если IV не будет передан, в случае, если он необходим для используемого алгоритма, то функция сгенерирует предупреждение об ошибке и использует IV, все байты которого установлены в "<literal>\0</literal>".</para>'>

<!ENTITY mcrypt.parameter.iv.strict '<para xmlns="http://docbook.org/ns/docbook">Указывают для инициализации в режимах CBC, CFB, OFB, а также в некоторых алгоритмах в режиме STREAM. Если переданный IV размер не поддерживается режимом сцепления или IV не был передан, а режим сцепления его требует, функция сгенерирует предупреждение об ошибке и вернёт &false;.</para>'>

<!ENTITY mcrypt.parameter.mode '<para xmlns="http://docbook.org/ns/docbook">Одна из констант <constant>MCRYPT_MODE_modename</constant>, либо одна из следующих строк: "ecb", "cbc", "cfb", "ofb", "nofb" и "stream".</para>'>

<!-- MCVE notes -->

<!ENTITY mcve.conn.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>conn</parameter></term><listitem><para>Ресурс MCVE_CONN, полученный из
<function>m_initengine</function>.</para></listitem></varlistentry>'>

<!-- memcached notes -->

<!ENTITY memcached.note.delete-time '<note xmlns="http://docbook.org/ns/docbook"><simpara>
  Начиная с версии memcached 1.3.0 (выпущена в 2009 году), функция больше не поддерживается.
  Передача ненулевого параметра <parameter>time</parameter> приведёт к возникновению ошибки при удалении.
  Метод <methodname>Memcached::getResultCode</methodname> вернёт <constant>MEMCACHED_INVALID_ARGUMENTS</constant>.
 </simpara></note>
'>

<!ENTITY memcached.parameter.expiration 'Время хранения объекта, по умолчанию равно 0. Для более подробной информации смотрите <link
linkend="memcached.expiration" xmlns="http://docbook.org/ns/docbook">Время хранения объекта</link>.'>

<!ENTITY memcached.parameter.server_key 'Ключ, идентифицирующий сервер, на котором хранится значение. Вместо хеширования по ключу самого элемента, при выборе подключаемого сервера memcached хешируют по ключу сервера. Такой метод разрешает группировать связанные элементы вместе на одном сервере, что повышает эффективность групповых операций.'>

<!ENTITY memcached.parameter.items 'Сохраняемый массив пар ключей/значений.'>

<!ENTITY memcached.parameter.key 'Ключ, под которым сохраняется значение.'>

<!ENTITY memcached.parameter.value 'Сохраняемое значение.'>

<!ENTITY memcached.result.getresultcode 'Используйте при необходимости <methodname xmlns="http://docbook.org/ns/docbook">Memcached::getResultCode</methodname>.'>

<!ENTITY memcached.result.delete-multi '<para xmlns="http://docbook.org/ns/docbook">
  Возвращает массив, проиндексированный ключами <parameter>keys</parameter>.
  Каждый элемент равен &true;, если соответствующий ключ был удалён или одной из
  констант <constant>Memcached::RES_*</constant>, если при удалении возникла ошибка.
 </para>
 <para xmlns="http://docbook.org/ns/docbook">
  Метод <methodname>Memcached::getResultCode</methodname> вернёт код результата
  для последней выполненной операции удаления,
  то есть операции удаления для последнего элемента <parameter>keys</parameter>.
 </para>
'>

<!-- password notes -->

<!ENTITY password.parameter.algo '
<link xmlns="http://docbook.org/ns/docbook" linkend="password.constants">Константа</link>
алгоритма хеширования пароля, который будет использовать функция.
'>

<!ENTITY password.parameter.hash 'Хеш, который создаёт функция
<function xmlns="http://docbook.org/ns/docbook">password_hash</function>.'>

<!ENTITY password.parameter.options 'Ассоциативный массив с опциями.
За документацией по поддерживаемым опциям для каждого алгоритма обратитесь
к разделу
<link xmlns="http://docbook.org/ns/docbook" linkend="password.constants">Константы алгоритмов хеширования паролей</link>.'>

<!ENTITY password.parameter.password 'Пользовательский пароль.'>

<!-- pspell notes -->

<!ENTITY pspell.changelog.pspell-dictionary '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Параметр <parameter>dictionary</parameter> теперь ожидает экземпляр
  класса <classname>PSpell\Dictionary</classname>; раньше параметр ждал ресурс (&resource;).
 </entry>
</row>'>

<!ENTITY pspell.changelog.pspell-config '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Параметр <parameter>config</parameter> теперь ожидает экземпляр
  класса <classname>PSpell\Config</classname>; раньше параметр ждал ресурс (&resource;).
 </entry>
</row>'>

<!ENTITY pspell.parameter.pspell-dictionary '<para xmlns="http://docbook.org/ns/docbook">Экземпляр
класса <classname>PSpell\Dictionary</classname>.</para>'>

<!ENTITY pspell.parameter.pspell-config '<para xmlns="http://docbook.org/ns/docbook">Экземпляр
класса <classname>PSpell\Config</classname>.</para>'>

<!-- RNP -->

<!ENTITY rnp.parameter.ffi-description 'Объект FFI, который возвращает функция rnp_ffi_create.'>

<!ENTITY rnp.parameter.key-format 'Формат ключа данных (GPG, KBX, G10).'>

<!ENTITY rnp.parameter.loadsave-flags 'Смотрите описание флагов RNP_LOAD_SAVE_*.'>

<!-- socket entities -->

<!ENTITY sockets.changelog.socket-param '<row xmlns="http://docbook.org/ns/docbook">
  <entry>8.0.0</entry>
  <entry>
   <parameter>socket</parameter> теперь экземпляр класса <classname>Socket</classname>;
   ранее был ресурсом (<type>resource</type>).
  </entry>
 </row>'>

<!ENTITY sockets.changelog.address-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>address</parameter> теперь экземпляр класса <classname>AddressInfo</classname>;
  ранее был ресурсом (<type>resource</type>).
 </entry>
</row>'>

<!-- gearman notes -->

<!ENTITY gearman.parameter.host 'Имя хоста сервера задач.'>

<!ENTITY gearman.parameter.port 'Порт сервера задач.'>

<!ENTITY gearman.parameter.functionname 'Зарегистрированная функция, вызываемая рабочим процессом'>

<!ENTITY gearman.parameter.workload 'Сериализованные данные, подлежащие обработке'>

<!ENTITY gearman.parameter.data 'Дополнительные данные, которые могут понадобиться для завершения работы'>

<!ENTITY gearman.parameter.context 'Контекст приложения, связываемый с задачей'>

<!ENTITY gearman.parameter.unique 'Уникальный ID, назначаемый определённой задаче'>

<!-- TODO: разделить термины job и task от текущего общего перевода "задача" -->
<!ENTITY gearman.parameter.jobhandle 'Дескриптор задачи, который присваевается сервером Gearman'>

<!-- Date and time entities -->
<!ENTITY date.timezone.intro.title '<title xmlns="http://docbook.org/ns/docbook">Список поддерживаемых часовых поясов</title>'>

<!ENTITY date.timezone.intro "<para xmlns='http://docbook.org/ns/docbook'>
Здесь вы найдёте полный список часовых поясов, поддерживаемых PHP, которые могут быть использованы, например, в <function>date_default_timezone_set</function>.
<caution><simpara>Поведение часовых поясов, отсутствующих в списке, не определено.</simpara></caution>
</para><note xmlns='http://docbook.org/ns/docbook'><simpara>Последняя версия базы данных часовых поясов может быть
установлена с помощью PECL-пакета <link xlink:href='&url.pecl.package.get;timezonedb' xmlns:xlink='http://www.w3.org/1999/xlink'>timezonedb</link>.
</simpara></note>">

<!ENTITY date.timezone.bc '<simpara xmlns="http://docbook.org/ns/docbook">Пожалуйста, не используйте описанные здесь часовые пояса (кроме UTC), они существуют только по причинам обратной совместимости и могут привести к неправильной работе.
Кроме того, часовые пояса могут быть удалены из базы данных часовых поясов IANA в любое время.
</simpara>'>

<!ENTITY date.timezone.posix-signs '<simpara xmlns="http://docbook.org/ns/docbook">
Если игнорируете вышестоящее предупреждение, то учтите, что
база данных часовых поясов IANA, которую содержит PHP,
поддерживает использование POSIX-стиля знаков, поэтому обозначения часовых поясов
Etc/GMT+n и Etc/GMT-n обратные общепринятым.
</simpara>
<simpara xmlns="http://docbook.org/ns/docbook">
 Например, часовой пояс на 8 часов вперёд от GMT, используемый в Китае,
 Западной Австралии и других местах, в действительности записан
 в базе данных как <literal>Etc/GMT-8</literal>, а не как <literal>Etc/GMT+8</literal>,
 как можно было бы ожидать.
</simpara>
<simpara xmlns="http://docbook.org/ns/docbook">
 Настоятельно рекомендуется использовать правильные часовые пояса,
 такие как <literal>Asia/Shanghai</literal> или
 <literal>Australia/Perth</literal> для вышеприведённого примера.
</simpara>'>

<!ENTITY date.timezone.abbrev-volatile '<simpara xmlns="http://docbook.org/ns/docbook">
Эти аббревиатуры часовых поясов могут быть крайне изменчивыми, т. е. они могут меняться
с каждым новым релизом "timezonedb".
Крайне не рекомендуется использовать аббревиатуры часовых поясов.
</simpara>'>

<!ENTITY date.timezone.errors.description '
<para xmlns="http://docbook.org/ns/docbook">
Каждый вызов к функциям даты и времени при неправильных настройках часового пояса
сгенерирует ошибку уровня <constant>E_WARNING</constant>,
если часовой пояс некорректный. Смотрите также описание функции
<function>date_default_timezone_set</function>.
</para>'
>

<!ENTITY date.timezone.errors.changelog '<row xmlns="http://docbook.org/ns/docbook"><entry>5.1.0</entry><entry><para>
Теперь ошибки, связанные с часовыми поясами, генерируют ошибки уровня <constant>E_STRICT</constant> и <constant>E_NOTICE</constant>.
</para></entry></row>'>

<!ENTITY date.timestamp.description '
<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>timestamp</parameter></term><listitem><para>
 Необязательный параметр <parameter>timestamp</parameter> — это
 целочисленная (<type>int</type>) метка времени, по умолчанию равная текущему местному времени, если параметр <parameter>timestamp</parameter>
 не указан или равен &null;. Говоря по другому, значение по умолчанию равно результату функции <function>time</function>.
 </para></listitem></varlistentry>'>

<!ENTITY date.datetime.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>object</parameter></term>
<listitem><para>Только для процедурного стиля: объект <classname>DateTime</classname>, который возвращает функция
 <function>date_create</function>.</para></listitem></varlistentry>'>

<!ENTITY date.datetime.description.modified '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>object</parameter></term>
<listitem><para>Только для процедурного стиля: объект <classname>DateTime</classname>, который возвращает функция
 <function>date_create</function>.
 Функция изменяет этот объект.</para></listitem></varlistentry>'>

<!ENTITY date.datetimezone.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>object</parameter></term><listitem><para>Только для процедурного стиля: объект <classname>DateTimeZone</classname>,
который возвращает функция
<function>timezone_open</function>.</para></listitem></varlistentry>'>

<!ENTITY date.datetime.return.modifiedobjectorfalseforfailure 'Возвращает модифицированный объект <classname xmlns="http://docbook.org/ns/docbook">DateTime</classname> для применения в цепи методов&return.falseforfailure;.'>
<!ENTITY date.datetime.return.modifiedobject 'Возвращает модифицированный объект <classname xmlns="http://docbook.org/ns/docbook">DateTime</classname> для применения в цепи методов.'>
<!ENTITY date.datetimeimmutable.return.modifiedobjectorfalseforfailure 'Возвращает новый объект <classname xmlns="http://docbook.org/ns/docbook">DateTimeImmutable</classname> с модифицированными данными&return.falseforfailure;.'>
<!ENTITY date.datetimeimmutable.return.modifiedobject 'Возвращает новый объект <classname xmlns="http://docbook.org/ns/docbook">DateTimeImmutable</classname> с модифицированными данными.'>

<!ENTITY date.timezone.dbversion 'Этот список основан на версии базы данных часовых поясов'>

<!ENTITY date.timezone.africa 'Африка'>
<!ENTITY date.timezone.america 'Америка'>
<!ENTITY date.timezone.antarctica 'Антарктика'>
<!ENTITY date.timezone.arctic 'Арктика'>
<!ENTITY date.timezone.asia 'Азия'>
<!ENTITY date.timezone.atlantic 'Атлантика'>
<!ENTITY date.timezone.australia 'Австралия'>
<!ENTITY date.timezone.europe 'Европа'>
<!ENTITY date.timezone.indian 'Индийский'>
<!ENTITY date.timezone.pacific 'Тихоокеанский'>
<!ENTITY date.timezone.others 'Другие'>
<!ENTITY date.timezone.abbreviations 'Аббревиатуры'>

<!ENTITY date.formats 'Объяснение корректных форматов дано в разделе <link xmlns="http://docbook.org/ns/docbook" linkend="datetime.formats">Форматы даты и времени</link>.'>
<!ENTITY date.formats.parameter 'Строка даты и времени. &date.formats;'>

<!-- DomXml Notes -->
<!ENTITY node.inserted 'Этот узел не будет отображаться в документе до тех пор,
пока он не будет вставлен, например, функцией
<function xmlns="http://docbook.org/ns/docbook">domnode_append_child</function>.'>


<!-- Dom Notes -->
<!ENTITY dom.node.inserted 'Этот узел не будет отображаться в документе до тех пор,
пока он не будет вставлен, например, функцией <function xmlns="http://docbook.org/ns/docbook">DOMNode::appendChild</function>.'>

<!ENTITY dom.malformederror '<para xmlns="http://docbook.org/ns/docbook">
Несмотря на то что некорректный HTML обычно успешно загружается, эта функция
может генерировать ошибки уровня <constant>E_WARNING</constant> при обнаружении
плохой разметки. Для обработки этих ошибок можно использовать
<link linkend="function.libxml-use-internal-errors">функции обработки
 ошибок libxml</link>.</para>'>
<!ENTITY dom.note.utf8 '<note xmlns="http://docbook.org/ns/docbook"><para>Модуль DOM работает с кодировкой UTF-8.
Для работы с другими кодировками пользуются функциями <function>mb_convert_encoding</function>,
<methodname>UConverter::transcode</methodname>
или <function>iconv</function>.</para></note>'>
<!ENTITY dom.note.json '<note xmlns="http://docbook.org/ns/docbook"><para>При использовании <function>json_encode</function> для объекта <classname>DOMDocument</classname> будет получен результат кодирования пустого объекта.</para></note>'>

<!-- Dom Examples -->
<!ENTITY dom.book.example '<para xmlns="http://docbook.org/ns/docbook">Следующие примеры используют файл <filename>book.xml</filename>, который содержит следующие данные:</para>
<programlisting role="xml" xmlns="http://docbook.org/ns/docbook">
 <!-- Warning: The CDATA markup here is a little tricky. Please DO NOT BREAK it! -->
<![CDATA[
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE books [
  <!ELEMENT books   (book+)>
  <!ELEMENT book    (title, author+, xhtml:blurb?)>
  <!ELEMENT title   (#PCDATA)>
  <!ELEMENT blurb   (#PCDATA)>
  <!ELEMENT author  (#PCDATA)>
  <!ATTLIST books   xmlns        CDATA  #IMPLIED>
  <!ATTLIST books   xmlns:xhtml  CDATA  #IMPLIED>
  <!ATTLIST book    id           ID     #IMPLIED>
  <!ATTLIST author  email        CDATA  #IMPLIED>
]>
<?xml-stylesheet type="text/xsl" href="style.xsl"?>
<books xmlns="http://books.php/" xmlns:xhtml="http://www.w3.org/1999/xhtml">
  <book id="php-basics">
    <title>PHP Basics</title>
    <author email="jim.smith@basics.php">Jim Smith</author>
    <author email="jane.smith@basics.php">Jane Smith</author>
    <xhtml:blurb><![CDATA[
<p><em>PHP Basics</em> provides an introduction to PHP.</p>
]]]]><![CDATA[></xhtml:blurb>
  </book>
  <book id="php-advanced">
    <title>PHP Advanced Programming</title>
    <author email="jon.doe@advanced.php">Jon Doe</author>
  </book>
</books>
]]></programlisting>'>

<!-- Dom entities -->
<!ENTITY dom.parameter.options '<para xmlns="http://docbook.org/ns/docbook">
 <link linkend="language.operators.bitwise">Побитовое ИЛИ (<literal>OR</literal>)</link>
 <link linkend="libxml.constants">констант опций libxml</link>.
</para>'>

<!ENTITY dom.parameters.register_node_ns '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>registerNodeNS</parameter></term>
 <listitem>
  <para>
   Нужно ли автоматически регистрировать префиксы пространства имён
   в области видимости контекстного узла для объекта <classname>DOMXPath</classname>.
   Параметр помогает избегать ручного вызова метода
   <methodname>DOMXPath::registerNamespace</methodname>
   для каждого пространства имён в области видимости.
   Когда префиксы пространства имён конфликтуют,
   регистрируется только префикс пространства имён близлежащего потомка.
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY dom.errors.hierarchy.parent '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><constant>DOM_HIERARCHY_REQUEST_ERR</constant></term>
  <listitem>
  <para>
   Возникает, если тип одного из переданных в параметре <parameter>nodes</parameter> элементов не допускается в типе родительского узла,
   или если добавляемый узел является одним из предков этого узла или самим этим узлом.
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY dom.errors.hierarchy.self '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><constant>DOM_HIERARCHY_REQUEST_ERR</constant></term>
  <listitem>
  <para>
   Возникает, если тип одного из переданных в параметре <parameter>nodes</parameter> элементов не допускается в типе узла,
   или если добавляемый узел является одним из предков этого узла или самим этим узлом.
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY dom.errors.wrong_document '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><constant>DOM_WRONG_DOCUMENT_ERR</constant></term>
  <listitem>
  <para>
   Возникает, если один из переданных в параметре <parameter>nodes</parameter> элементов был создан из документа,
   отличного от того, в котором был создан этот узел.
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY dom.changelog.previous_hierarchy_exception 'Ранее это выбрасывало исключение
 <classname xmlns="http://docbook.org/ns/docbook">DOMException</classname> с кодом
 <constant xmlns="http://docbook.org/ns/docbook">DOM_HIERARCHY_REQUEST_ERR</constant>.'>

<!-- FileSystem entities -->
<!ENTITY fs.emits.warning.on.failure '<para xmlns="http://docbook.org/ns/docbook">
В случае неудачного завершения работы генерируется ошибка уровня <constant>E_WARNING</constant>.
</para>'>

<!ENTITY fs.validfp.all '<para xmlns="http://docbook.org/ns/docbook">Указатель на файл должен быть корректным и указывать
на файл, успешно открытый функциями <function>fopen</function> или
<function>fsockopen</function> (и всё ещё не закрытый функцией <function>fclose</function>).</para>'>

<!ENTITY fs.file.pointer '<para xmlns="http://docbook.org/ns/docbook">Ресурс (<type>resource</type>)
указателя файловой системы, который часто создают функцией <function>fopen</function>.</para>'>

<!ENTITY fs.file.32bit '<note xmlns="http://docbook.org/ns/docbook"><simpara>
Так как тип integer в PHP является целым числом со знаком, и многие платформы используют 32-х битные целые числа,
то некоторые функции файловых систем могут возвращать неожиданные результаты для файлов
размером больше 2 Гб.
</simpara></note>'>

<!ENTITY ini.scanner.typed '<para xmlns="http://docbook.org/ns/docbook">
С версии PHP 5.6.1 также можно задать <constant>INI_SCANNER_TYPED</constant>.
В этом режиме типы boolean, null и integer будут, по возможности, сохраняться.
Строковые значения <literal>"true"</literal>, <literal>"on"</literal> и <literal>"yes"</literal>
будут преобразованы в &true;. <literal>"false"</literal>, <literal>"off"</literal>, <literal>"no"</literal>
и <literal>"none"</literal> в &false;. <literal>"null"</literal> преобразовывается в &null;.
Кроме этого, все числовые строки будут, по возможности, преобразованы к целым числам.
</para>'>

<!-- GNUPG -->
<!ENTITY gnupg.identifier '<para xmlns="http://docbook.org/ns/docbook">Идентификатор gnupg, полученный из
<function>gnupg_init</function> или <classname>gnupg</classname>.</para>'>

<!ENTITY gnupg.fingerprint '<para xmlns="http://docbook.org/ns/docbook">Отпечаток ключа.</para>'>

<!-- HaruDoc -->
<!ENTITY haru.error '<para xmlns="http://docbook.org/ns/docbook">Вызывает исключение <classname>HaruException</classname>
в случае ошибки.</para>'>

<!-- ODBC -->
<!ENTITY odbc.connection.id '<para xmlns="http://docbook.org/ns/docbook">Идентификатор соединения ODBC,
за подробностями обращайтесь к <function>odbc_connect</function>.</para>'>

<!ENTITY odbc.parameter.catalog 'Каталог (&apos;qualifier&apos; на языке ODBC 2).'>

<!ENTITY odbc.parameter.schema 'Схема (&apos;owner&apos; на языке ODBC 2).'>

<!ENTITY odbc.parameter.search 'Этот параметр принимает следующие шаблоны поиска:
<literal xmlns="http://docbook.org/ns/docbook">&#x25;</literal> соответствующий нулю или более символам,
и <literal xmlns="http://docbook.org/ns/docbook">_</literal> соответствующий ровно одному символу.'>

<!ENTITY odbc.result.driver-specific 'Драйверы могут сообщать дополнительные столбцы.'>

<!-- OAUTH -->
<!ENTITY oauth.callback.error 'Если callback-функция не может быть вызвана или отсутствует, то генерируется ошибка уровня
<constant xmlns="http://docbook.org/ns/docbook">E_ERROR</constant>.'>

<!ENTITY oauth.changelog.error.null 'Раньше, если возникала ошибка, метод возвращал &null;, а не &false;.'>

<!-- Oracle -->
<!ENTITY oci.db "<para xmlns='http://docbook.org/ns/docbook' xmlns:xlink='http://www.w3.org/1999/xlink'>Содержит
<literal>экземпляр Oracle</literal> для подключения. Это может быть
<link xlink:href='&url.oracle.oic.connect;'>Easy Connect
 string</link>, или Connect Name из файла
<filename>tnsnames.ora</filename>, или имя локального экземпляра Oracle.
</para>
<para xmlns='http://docbook.org/ns/docbook'>Если не указано отдельно или &null;, PHP использует
 переменные окружения, такие как <constant>TWO_TASK</constant> (на Linux)
 или <constant>LOCAL</constant> (на Windows)
 и <constant>ORACLE_SID</constant> для определения
 <literal>экземпляра Oracle</literal> для соединения.
</para>
<para xmlns='http://docbook.org/ns/docbook'>
 Для использования метода Easy Connect, PHP должен быть слинкован с клиентскими библиотеками версии Oracle
 10<emphasis>g</emphasis> или старше. Easy Connect string для Oracle 10<emphasis>g</emphasis> принимает следующую форму:
 <emphasis>[//]host_name[:port][/service_name]</emphasis>. Начиная с Oracle 11<emphasis>g</emphasis> синтаксис таков:
 <emphasis>[//]host_name[:port][/service_name][:server_type][/instance_name]</emphasis>.
 В Oracle 19c были введены дополнительные параметры, включая настройки времени ожидания и проверки активности.
 Обратитесь к документации Oracle. Названия служб могут быть определены с помощью запуска Oracle утилиты <literal>lsnrctl status</literal>
 на сервере базы данных.
</para>
<para xmlns='http://docbook.org/ns/docbook'>
 Файл <filename>tnsnames.ora</filename> может находиться в поисковом пути Oracle Net, который включает
 <filename>/your/path/to/instantclient/network/admin</filename>,
 <filename>$ORACLE_HOME/network/admin</filename> и <filename>/etc</filename>. В качестве альтернативного варианта
 можно установить <literal>TNS_ADMIN</literal> таким образом, чтобы путь <filename>$TNS_ADMIN/tnsnames.ora</filename> был читаемым.
 Убедитесь, что веб-сервер имеет доступ к этому файлу.
</para>">

<!ENTITY oci.charset "<para xmlns='http://docbook.org/ns/docbook'>Определяет кодировку, которую будут использовать клиентские
библиотеки Oracle. Эта кодировка не обязательно должна совпадать с кодировкой, используемой в самой базе данных.
Если она не совпадает, Oracle сделает всё возможное для конвертирования данных из- и в эту кодировку.
В зависимости от используемых кодировок это может не всегда давать приемлемые результаты. Преобразование также
создаёт некоторые дополнительные временные затраты.
</para>
<para xmlns='http://docbook.org/ns/docbook'>Если кодировка не указана, клиентские библиотеки Oracle будут определять
 её из переменной окружения <constant>NLS_LANG</constant>.
</para>
<para xmlns='http://docbook.org/ns/docbook'>Передача этого параметра может уменьшить время затрачиваемое на соединение.
</para>">

<!ENTITY oci.sessionmode '<para xmlns="http://docbook.org/ns/docbook">Этот параметр доступен
начиная с версии PHP 5 (PECL OCI8 1.1) и принимает следующие значения: <constant>OCI_DEFAULT</constant>,
<constant>OCI_SYSOPER</constant> и <constant>OCI_SYSDBA</constant>. Если указали
<constant>OCI_SYSOPER</constant> или <constant>OCI_SYSDBA</constant>, функция попытается установить
привилегированное соединение через внешние данные авторизации. По умолчанию привилегированные
соединения отключены. Чтобы их включить, устанавливают
<link linkend="ini.oci8.privileged-connect">oci8.privileged_connect</link>
в <literal>On</literal>.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 В версии PHP 5.3 (PECL OCI8 1.3.4) появилась константа <constant>OCI_CRED_EXT</constant> как значение режима.
 Этот режим говорит Oracle использовать внешнюю аутентификацию или аутентификацию операционной системы,
 которую требуется настроить в базе данных.
 Флаг <constant>OCI_CRED_EXT</constant> разрешается использовать только с именем пользователя &quot;/&quot;
 и пустым паролем.
 Опиция <link linkend="ini.oci8.privileged-connect">oci8.privileged_connect</link> принимает
 значение <literal>On</literal> или <literal>Off</literal>.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Режим <constant>OCI_CRED_EXT</constant> разрешается объединять с режимами <constant>OCI_SYSOPER</constant>
 и <constant>OCI_SYSDBA</constant>.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Режим <constant>OCI_CRED_EXT</constant> не поддерживается в Windows по соображениям безопасности.
</para>'>

<!ENTITY oci.datatypes '<para xmlns="http://docbook.org/ns/docbook">За подробностями
по операции отображения типов данных, осуществляемой модулем OCI8,
обратитесь к <link linkend="oci8.datatypes">типам данных, поддерживаемых драйвером</link></para>'>

<!ENTITY oci.parameter.connection '<para xmlns="http://docbook.org/ns/docbook">Идентификатор соединения Oracle,
который возвращают функции <function>oci_connect</function>,
<function>oci_pconnect</function>
или <function>oci_new_connect</function>.</para>'>

<!ENTITY oci.availability.note.10g '<note xmlns="http://docbook.org/ns/docbook"><title>Требование
к версии Oracle</title><para>Эта функция доступна,
если PHP слинкован с библиотеками Oracle Database
начиная с версии 10<emphasis>g</emphasis> и выше.</para></note>'>

<!ENTITY oci.clientinfo.tip '<tip xmlns="http://docbook.org/ns/docbook">
<title>Производительность</title>
<para>В старых версиях модуля OCI8 или базы
данных Oracle была доступна установка информации о клиенте средствами
пакета <literal>DBMS_APPLICATION_INFO</literal>. Для этого более
эффективен вызов функции <function>oci_set_client_info</function>.</para></tip>'>

<!ENTITY oci.roundtrip.caution '<caution xmlns="http://docbook.org/ns/docbook">
<title>Совет по полному сканированию таблицы (roundtrip)</title>
<para>Ряд OCI8-функции вызывают полное сканирование
таблицы (roundtrip). Функции не сканируют таблицы полностью
для тех запросов, в которых включено кеширование результатов
в базе данных.</para></caution>'>

<!ENTITY oci.use.setprefetch '<para xmlns="http://docbook.org/ns/docbook">Для запросов,
которые возвращают большое количество рядов, производительность может быть
значительно увеличена за счёт увеличения значения опции
<link linkend="ini.oci8.default-prefetch">oci8.default_prefetch</link>
или вызова функции <function>oci_set_prefetch</function>.
</para>'>


<!ENTITY oci.arg.statement.id
"<para xmlns='http://docbook.org/ns/docbook'>Корректный идентификатор
выражения OCI8, полученный из функции <function>oci_parse</function>
и исполненный функцией <function>oci_execute</function>,
или идентификатор выражения <literal>REF CURSOR</literal>.</para>">

<!-- TODO: проверить правильность перевода -->
<!-- PCNTL Notes -->
<!ENTITY pcntl.parameter.status '<para xmlns="http://docbook.org/ns/docbook">Параметр <parameter>status</parameter> — это параметр статуса, передаваемый для успешного вызова функции <function>pcntl_waitpid</function>.</para>'>

<!-- PS Notes -->
<!ENTITY ps.note.visible '<para xmlns="http://docbook.org/ns/docbook">Примечание не будет отображаться при печати или просмотре документа, но будет показано при конвертировании документа в pdf с помощью Acrobat Distiller™ или Ghostview.</para>'>

<!-- XSLT Notes -->

<!-- Notes for safe-mode limited functions: -->

<!-- Not used in EN anymore -->
<!ENTITY note.sm.disabled '<note xmlns="http://docbook.org/ns/docbook"><simpara>&sm.disabled;</simpara></note>'>

<!-- Not used in EN anymore -->
<!ENTITY note.sm.uidcheck '<note xmlns="http://docbook.org/ns/docbook"><simpara>Когда опция <link linkend="features.safe-mode">safe mode</link> включена, PHP проверяет, имеют ли файлы/каталоги, с которыми вы собираетесь работать, такой же UID (владельца), как и выполняемый скрипт.</simpara></note>'>

<!-- Not used in EN anymore -->
<!ENTITY note.sm.uidcheck.dir '<note xmlns="http://docbook.org/ns/docbook"><simpara>Когда опция <link linkend="features.safe-mode">safe mode</link> включена, PHP проверяет, имеет ли каталог, с которым вы собираетесь работать, такой же UID (владельца), как и выполняемый скрипт.</simpara></note>'>

<!ENTITY note.open-basedir.func '<note xmlns="http://docbook.org/ns/docbook"><para>На поведение этой функции влияет значение директивы <link linkend="ini.open-basedir">open_basedir</link>.</para></note>'>


<!ENTITY note.language-construct '<note xmlns="http://docbook.org/ns/docbook"><simpara>Поскольку это языковая конструкция, а не функция,
её нельзя вызывать как <link linkend="functions.variable-functions">переменную функцию</link>
или передавать как <link linkend="functions.named-arguments">именованный аргумент</link>.</simpara>
</note>'>

<!-- Common pieces in features/safe-mode.xml
     Jade doesn't allow in-line entities, so I put them here... Though they
     should have been inline in safe-mode.xml -->

<!-- Not used in EN anymore -->
<!ENTITY sm.uidcheck 'Проверяет, имеют ли файлы/каталоги, с которыми
вы собираетесь работать, такой же UID (владельца), как и выполняемый скрипт.'>

<!-- Not used in EN anymore -->
<!ENTITY warn.sm.exec '<warning xmlns="http://docbook.org/ns/docbook"><simpara>В случае работы в <link linkend="features.safe-mode">безопасном режиме</link>, строка с командой экранируется с помощью <function>escapeshellcmd</function>. Таким образом <literal>echo y | echo x</literal> становится <literal>echo y \| echo x</literal>.</simpara></warning>'>

<!-- Not used in EN anymore -->
<!ENTITY note.exec-path '<note xmlns="http://docbook.org/ns/docbook"><simpara>В случае работы в <link linkend="features.safe-mode">безопасном режиме</link>, вы можете запускать что-либо только в пределах <link linkend="ini.safe-mode-exec-dir">safe_mode_exec_dir</link>.
В настоящее время по практическим причинам запрещено использование <literal>..</literal> в качестве компонента пути к исполняемому файлу.</simpara></note>'>

<!-- Not used in EN anymore -->
<!ENTITY sm.uidcheck.dir 'Проверяет, имеет ли каталог, с которым
вы собираетесь работать, такой же UID (владельца), как и выполняемый скрипт.'>

<!-- Not used in EN anymore -->
<!ENTITY sm.disabled 'Эта функция недоступна в
<link xmlns="http://docbook.org/ns/docbook" linkend="features.safe-mode">безопасном режиме</link>.'>

<!-- Common pieces in partintro-sections -->
<!ENTITY no.config '<para xmlns="http://docbook.org/ns/docbook">Данный модуль не определяет никакие директивы конфигурации в &php.ini;.</para>'>
<!ENTITY no.resource '<para xmlns="http://docbook.org/ns/docbook">Данный модуль не определяет каких-либо типов ресурсов.</para>'>
<!ENTITY no.constants '<para xmlns="http://docbook.org/ns/docbook">Данный модуль не определяет никакие константы.</para>'>
<!ENTITY no.requirement '<para xmlns="http://docbook.org/ns/docbook">Для сборки этого модуля не нужны внешние библиотеки.</para>'>
<!ENTITY no.install '<para xmlns="http://docbook.org/ns/docbook">Для использования этих функций не требуется проведение установки,
поскольку они являются частью ядра PHP.</para>'>

<!-- Used in every chapter that has directive descriptions -->
<!ENTITY ini.descriptions.title '<para xmlns="http://docbook.org/ns/docbook">Краткое разъяснение конфигурационных
директив.</para>'>

<!-- Common pieces for reference part BEGIN-->

<!-- Used in reference/$extname/ini.xml -->
<!ENTITY extension.runtime '<simpara xmlns="http://docbook.org/ns/docbook">
Поведение этих функций зависит от установок в &php.ini;.
</simpara>'>

<!ENTITY ini.php.constants 'Дополнительная информация и описания режимов
INI_* даны в разделе «<xref xmlns="http://docbook.org/ns/docbook" linkend="configuration.changes.modes"/>».'>

<!-- Used in reference/$extname/constants.xml -->
<!ENTITY extension.constants '
<simpara xmlns="http://docbook.org/ns/docbook">
 Модуль определяет перечисленные ниже константы
 и открывает к ним доступ только тогда, когда модуль либо собрали в PHP,
 либо динамически загрузили во время исполнения кода.
</simpara>'>

<!-- For STANDARD Constants used in reference/$extname/constants.xml -->
<!ENTITY extension.constants.core '<simpara xmlns="http://docbook.org/ns/docbook">
Перечисленные ниже константы доступны как часть ядра PHP.
</simpara>'>

<!-- Used in reference/$extname/classes.xml -->
<!ENTITY extension.classes '<simpara xmlns="http://docbook.org/ns/docbook">
Модуль определяет перечисленные ниже классы
и открывает к ним доступ только тогда, когда модуль либо собрали в PHP,
либо динамически загрузили во время исполнения кода.
</simpara>'>

<!ENTITY note.extension.php5 '<note xmlns="http://docbook.org/ns/docbook"><simpara>
Этому модулю необходим PHP 5.</simpara></note>'>

<!-- PDO entities -->
<!ENTITY pdo.driver-constants '<simpara xmlns="http://docbook.org/ns/docbook">Драйвер
определяет перечисленные ниже константы, которые доступны только тогда, когда PHP собрали
с поддержкой этого модуля, или модуль динамически загрузили во время исполнения кода.
Зависимые от драйвера константы разрешно использовать только совместно с этим драйвером.
Атрибуты одного драйвера с другим драйвером ведут себя неожиданно. Для проверки названия
драйвера, которое содержит атрибут <constant>PDO::ATTR_DRIVER_NAME</constant>, вызывают
метод <function>PDO::getAttribute</function>, если код запускается с несколькими драйверами.</simpara>'>

<!ENTITY pdo.errors.exception-not-errmode '<note xmlns="http://docbook.org/ns/docbook"><simpara>Исключение
будет вызвано, даже если атрибут <constant>PDO::ATTR_ERRMODE</constant>
не выставлен в <constant>PDO::ERRMODE_EXCEPTION</constant>.</simpara></note>'>

 <!-- PDO errors -->

<!ENTITY pdo.errors '<para xmlns="http://docbook.org/ns/docbook">
 Выдаёт ошибку уровня <constant>E_WARNING</constant>, если атрибуту <constant>PDO::ATTR_ERRMODE</constant>
 установлено значение <constant>PDO::ERRMODE_WARNING</constant>.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Выбрасывает исключение <classname>PDOException</classname>, если атрибуту <constant>PDO::ATTR_ERRMODE</constant>
 установлено значение <constant>PDO::ERRMODE_EXCEPTION</constant>.
</para>'>

<!-- PECL entities -->
<!ENTITY pecl.moved 'Этот модуль &link.pecl; не поставляется вместе с PHP.'>

<!ENTITY pecl.bundled 'Этот модуль &link.pecl; поставляется вместе с PHP.'>

<!ENTITY pecl.info 'Информацию об установке этого PECL-модуля
даёт глава руководства
«<link xmlns="http://docbook.org/ns/docbook" linkend="install.pecl">Установка
PECL-модулей</link>». Дополнительная информация о новых версиях,
скачивании, исходных файлах, о разработчике и журнале изменений
доступна по ссылке: '>

<!ENTITY pecl.info.dead 'Это модуль не поддерживается и считается умершим.
Однако, его исходный код всё ещё доступен
в <acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym>
<acronym xmlns="http://docbook.org/ns/docbook">SVN</acronym> вот здесь: '>

<!ENTITY pecl.info.dead.git 'Этот модуль считается неподдерживаемым и мёртвым. В любом случае,
исходники доступны через <acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym>
<acronym xmlns="http://docbook.org/ns/docbook">GIT</acronym> тут: '>

<!ENTITY pecl.windows.download '<acronym xmlns="http://docbook.org/ns/docbook">DLL</acronym> для этого
модуля <acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym> пока недоступна.
Смотрите также раздел <link xmlns="http://docbook.org/ns/docbook" linkend="install.windows.building">сборка на Windows</link>.'>
<!ENTITY pecl.windows.download.avail 'Бинарные файлы Windows (файлы <acronym xmlns="http://docbook.org/ns/docbook">DLL</acronym>)
для этого модуля <acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym> доступны на сайте PECL.'>
<!ENTITY pecl.windows.download.unbundled '&pecl.windows.download;'>

<!ENTITY pecl.moved-ver 'Этот модуль был перемещен в репозиторий &link.pecl; и больше не поставляется с PHP '>

<!-- PGSQL entities -->

<!ENTITY pgsql.parameter.connection '<para xmlns="http://docbook.org/ns/docbook">Экземпляр
класса <classname>PgSql\Connection</classname>.</para>'>

<!ENTITY pgsql.parameter.connection-with-unspecified-default '<para xmlns="http://docbook.org/ns/docbook">Экземпляр
класса <classname>PgSql\Connection</classname>.
Если параметр <parameter>connection</parameter> не указали, функция выберет соединение по умолчанию.
Соединение по умолчанию — это последнее соединение, которое установила функция <function>pg_connect</function>
или <function>pg_pconnect</function>.
<warning><simpara>Начиная с версии PHP 8.1.0 использование соединения по умолчанию устарело.</simpara></warning></para>'>

<!ENTITY pgsql.parameter.connection-with-nullable-default '<para xmlns="http://docbook.org/ns/docbook">Экземпляр
класса <classname>PgSql\Connection</classname>.
Если параметр <parameter>connection</parameter> указан как &null;,
выбирается соединение по умолчанию. Соединение по умолчанию — последнее соединение,
которое установила функция <function>pg_connect</function> или <function>pg_pconnect</function>.
<warning><simpara>Начиная с версии PHP 8.1.0 использование соединения по умолчанию устарело.</simpara></warning></para>'>

<!ENTITY pgsql.parameter.result '<para xmlns="http://docbook.org/ns/docbook">Экземпляр
класса <classname>PgSql\Result</classname>,
который возвращают функции <function>pg_query</function>,
<function>pg_query_params</function> или <function>pg_execute</function> (среди прочего).</para>'>

<!ENTITY pgsql.parameter.lob '<para xmlns="http://docbook.org/ns/docbook">Экземпляр класса
<classname>PgSql\Lob</classname>, который вернула функция <function>pg_lo_open</function>.</para>'>

<!ENTITY pgsql.parameter.mode '<para xmlns="http://docbook.org/ns/docbook">
Необязательный параметр, управляющий тем, как индексируется возвращаемый массив (<type>array</type>).
Параметр <parameter>mode</parameter> является константой и может принимать следующие значения:
<constant>PGSQL_ASSOC</constant>, <constant>PGSQL_NUM</constant> и <constant>PGSQL_BOTH</constant>.
При использовании <constant>PGSQL_NUM</constant> функция возвращает массив с числовыми индексами,
при использовании <constant>PGSQL_ASSOC</constant> она вернёт только ассоциативные индексы,
а <constant>PGSQL_BOTH</constant> вернёт как числовые, так и ассоциативные индексы.</para>'>

<!ENTITY pgsql.changelog.connection-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Параметр <parameter>connection</parameter> теперь ожидает экземпляр
  класса <classname>PgSql\Connection</classname>; раньше параметр ждал ресурс (&resource;).
 </entry>
</row>'>

<!ENTITY pgsql.changelog.result-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Параметр <parameter>result</parameter> теперь ожидает экземпляр класса
  <classname>PgSql\Result</classname>; раньше параметр ждал ресурс (&resource;).
 </entry>
</row>'>

<!ENTITY pgsql.changelog.lob-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Параметр <parameter>lob</parameter> теперь ожидает экземпляр класса
  <classname>PgSql\Lob</classname>; раньше параметр ждал ресурс (&resource;).
 </entry>
</row>'>

<!ENTITY pgsql.changelog.return-result-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Функция возвращает экземпляр класса <classname>PgSql\Result</classname>;
  раньше функция возвращала ресурс (&resource;).
 </entry>
</row>'>

<!-- Common pieces for reference part END -->


<!ENTITY windows.builtin '<simpara xmlns="http://docbook.org/ns/docbook"> Версия PHP для
Windows имеет встроенную поддержку этого модуля.
То есть для вызова этих функций не нужна загрузка
дополнительных модулей.</simpara>'>

<!-- These are here as helpers for manual consistency and brievety-->
<!ENTITY safemode '<link xmlns="http://docbook.org/ns/docbook" linkend="ini.safe-mode">безопасный режим</link>'>

<!ENTITY sqlsafemode '<link xmlns="http://docbook.org/ns/docbook" linkend="ini.sql.safe-mode">SQL safe mode</link>'>

<!-- APD Notes -->
<!ENTITY apd.debug-level.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>debug_level</parameter></term><listitem><para>Целое число, полученное сложением констант
<literal>XXX_TRACE</literal>.</para><para>Не рекомендуется использовать константу
<constant>MEMORY_TRACE</constant>. Это очень медленно и может давать неточные результаты.
<constant>ASSIGNMENT_TRACE</constant> ещё не реализовано.</para><para>Для включения всех видов отслеживания функций
(TIMING, FUNCTIONS, ARGS SUMMARY (наподобие strace -c)) используйте значение 99</para>
</listitem></varlistentry>'>

<!-- BCMath Notes -->
<!ENTITY bc.scale.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>scale</parameter></term><listitem><para>Этот необязательный параметр используют для установки количества знаков после десятичного разделителя в результате. Если не задано, то, по умолчанию, будет использовано значение заданное глобально с помощью <function>bcscale</function>, либо <literal>0</literal>.</para></listitem></varlistentry>'>

<!-- CTYPE Notes -->
<!ENTITY note.ctype.parameter.integer '<note xmlns="http://docbook.org/ns/docbook"><para>
Если передано целое число (<type>int</type>) в диапазоне между -128 и 255 включительно,
то оно будет обработано как ASCII-код одного символа (к отрицательным
значениям будет прибавлено 256, чтобы функция могла представить символы
из расширенного диапазона ASCII). Остальные целые числа будут обработаны
как строки, содержащие десятичные цифры целых чисел.</para></note>'>

<!ENTITY note.ctype.parameter.non-string '<warning xmlns="http://docbook.org/ns/docbook"><para>
Начиная с PHP 8.1.0 передача нестроковых аргументов устарела.
В будущем аргумент вместо ASCII-кода будет интерпретироваться как строка.
В зависимости от предполагаемого поведения аргумент либо преобразовывают в строку (&string;),
либо вызывают функцию <function>chr</function>.</para></warning>'>

<!ENTITY ctype.result.empty-string 'При вызове с пустой строкой результатом всегда будет &false;.'>

<!-- FTP Notes -->
<!ENTITY ftp.changelog.ftp-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Параметр <parameter>ftp</parameter> теперь ожидает экземпляр класса <classname>FTP\Connection</classname>;
  раньше параметр ждал ресурс (&resource;).
 </entry>
</row>'>
<!ENTITY ftp.parameter.ftp '<para xmlns="http://docbook.org/ns/docbook">An <classname>FTP\Connection</classname> instance.</para>'>

<!-- GMP Notes -->
<!ENTITY gmp.return 'Объект класса <classname xmlns="http://docbook.org/ns/docbook">GMP</classname>.'>
<!ENTITY gmp.parameter '<para xmlns="http://docbook.org/ns/docbook">Объект <classname>GMP</classname>, целое число (&integer;) или числовая строка (&string;).</para>'>

<!-- MySQLi Notes -->
<!ENTITY mysqli.result.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>result</parameter></term><listitem><para>Только для процедурного стиля: объект <classname>mysqli_result</classname>, который вернула функция
<function>mysqli_query</function>, <function>mysqli_store_result</function>,
<function>mysqli_use_result</function> или <function>mysqli_stmt_get_result</function>.</para></listitem></varlistentry>'>
<!ENTITY mysqli.link.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>mysql</parameter></term><listitem><para>Только для процедурного стиля: объект <classname>mysqli</classname>, который вернула функция
<function>mysqli_connect</function> или функция <function>mysqli_init</function>.
</para></listitem></varlistentry>'>
<!ENTITY mysqli.stmt.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>stmt</parameter></term><listitem><para>Только для процедурного стиля: объект <classname>mysqli_stmt</classname>, который вернула функция
<function>mysqli_stmt_init</function>.</para></listitem></varlistentry>'>
<!ENTITY mysqli.available.mysqlnd 'Доступно только с модулем <link xmlns="http://docbook.org/ns/docbook"
linkend="book.mysqlnd">mysqlnd</link>.'>
<!ENTITY mysqli.charset.note '<note xmlns="http://docbook.org/ns/docbook">
<para>MySQLnd всегда подразумевает кодировку, которую использует по умолчанию сервер. Эта кодировка передаётся во время
установки соединения/авторизации, которые использует mysqlnd.</para><para>Libmysqlclient по умолчанию использует
кодировку, установленную в файле <filename>my.cnf</filename> или явным вызовом функции <function>mysqli_options</function> до
вызова функции <function>mysqli_real_connect</function>, но после вызова функции <function>mysqli_connect</function>.</para></note>'>

<!ENTITY mysqli.integer.overflow.as.string.note '<note xmlns="http://docbook.org/ns/docbook">
<para>Если количество строк больше, чем <constant>PHP_INT_MAX</constant>, число будет возвращено как строка (&string;).</para></note>'>

<!ENTITY mysqli.sqlinjection.warning '<warning xmlns="http://docbook.org/ns/docbook">
<title>Предупреждение безопасности: SQL-инъекция</title><para>Вместо составления строки запроса с включением переменных значений
необходимо <link linkend="mysqli.quickstart.prepared-statements">подготавливать запросы</link>. Либо строки запроса должны быть экранированы
функцией <function>mysqli_real_escape_string</function> и правильно отформатированы.</para></warning>'>

<!ENTITY mysqli.conditionalexception '<para xmlns="http://docbook.org/ns/docbook">
Если уведомления об ошибках mysqli включены (<constant>MYSQLI_REPORT_ERROR</constant>) и запрошенная операция не удалась,
выдаётся предупреждение. Если, кроме того, установлен режим <constant>MYSQLI_REPORT_STRICT</constant>,
вместо этого будет выброшено исключение <classname>mysqli_sql_exception</classname>.</para>'>

<!-- Notes for PCRE -->
<!ENTITY pcre.pattern.warning '<para xmlns="http://docbook.org/ns/docbook">
Если переданный шаблон регулярного выражения не компилируется в допустимое регулярное выражение, выдаётся ошибка уровня <constant>E_WARNING</constant>.
</para>'>

<!-- Notes for SAPI/Apache -->

<!ENTITY apache.req.module '<simpara xmlns="http://docbook.org/ns/docbook">Эта функция поддерживается только если PHP установлен в качестве модуля Apache в веб-серверах.</simpara>'>

<!-- Notes for SAPI/FPM -->
<!ENTITY fpm.intro '<para xmlns="http://docbook.org/ns/docbook">FPM (FastCGI Process Manager,
менеджер процессов интерфейса FastCGI) — основная реализация интерфейса FastCGI для PHP,
которая в основном содержит функционал, полезный для высоконагруженных сайтов.
</para>'>

<!-- SimpleXML Notes -->
<!ENTITY simplexml.iteration '<note xmlns="http://docbook.org/ns/docbook"><simpara>SimpleXML содержит правило добавления
итеративных свойств к большинству методов. Они не могут быть просмотрены с использованием
<function>var_dump</function> или каких-либо других средств анализа объектов.</simpara></note>'>

<!-- SQLite Notes -->
<!ENTITY sqlite.case-fold '<para xmlns="http://docbook.org/ns/docbook">Имена столбцов, возвращаемые
<constant>SQLITE_ASSOC</constant> и <constant>SQLITE_BOTH</constant>, будут
приведены к нужному регистру согласно значению конфигурационной опции
<link linkend="ini.sqlite.assoc-case">sqlite.assoc_case</link>.</para>'>

<!ENTITY sqlite.decode-bin '<para xmlns="http://docbook.org/ns/docbook">Когда параметр
<parameter>decode_binary</parameter> установлен в &true; (по умолчанию),
PHP будет декодировать бинарный код, применённый к данным, как если бы они были закодированы функцией
<function>sqlite_escape_string</function>. Обычно вам следует оставлять
это значение по умолчанию, если только вы не работаете с базой данных
sqlite, которая была создана в ином приложении.</para>'>

<!ENTITY sqlite.no-unbuffered '<note xmlns="http://docbook.org/ns/docbook"><para>Эта функция не может быть использована
с идентификаторами результатов небуферизированных запросов.</para></note>'>

<!ENTITY sqlite.param-compat '<note xmlns="http://docbook.org/ns/docbook"><simpara>Поддерживаются два альтернативных
синтаксиса для совместимости с другими модулями баз данных (например, MySQL).
Предпочитаемая форма — первая, в которой параметр <parameter>dbhandle</parameter>
является первым параметром функции.</simpara></note>'>

<!ENTITY sqlite.result-type '<para xmlns="http://docbook.org/ns/docbook">Необязательный параметр
<parameter>result_type</parameter> принимает константу, определяющую, как будет
индексирован возвращаемый массив.
При использовании <constant>SQLITE_ASSOC</constant> будет возвращён
ассоциативный массив, а при использовании <constant>SQLITE_NUM</constant>
- числовой. <constant>SQLITE_BOTH</constant> вернёт массив как с
ассоциативными, так и с числовыми индексами.
Значением по умолчанию для этой функции является
<constant>SQLITE_BOTH</constant>.</para>'>

<!-- Database Notes -->
<!ENTITY database.field-case '<note xmlns="http://docbook.org/ns/docbook"><simpara>Имена полей, возвращаемые этой
функцией являются <emphasis>зависимыми от регистра</emphasis>.</simpara></note>'>

<!ENTITY database.fetch-null '<note xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция устанавливает NULL-поля
в значение &null; PHP.</simpara></note>'>

<!-- MSQL Notes -->
<!-- The msql.*.description entities are used in the parameters refsect1 -->
<!ENTITY msql.linkid.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>link_identifier</parameter></term><listitem><para>Соединение mSQL.
Если не указан, будет использовано последнее соединение, открытое функцией <function>msql_connect</function>.
Если такое соединение не было найдено, функция попытается установить новое, как если бы была вызвана функция
<function>msql_connect</function>, и использовать его.
</para></listitem></varlistentry>'>

<!ENTITY msql.result.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>result</parameter></term><listitem><para>Обрабатываемый <link xmlns="http://docbook.org/ns/docbook" linkend="language.types.resource">результат запроса</link>,
полученный с помощью функции <function>msql_query</function>.</para></listitem></varlistentry>'>

<!ENTITY msql.field-offset.req.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>field_offset</parameter></term><listitem><para>Числовое смещение поля.
<parameter>field_offset</parameter> начинается с <literal>1</literal>.</para></listitem></varlistentry>'>


<!-- MySQL Notes -->
<!-- The mysql.*.description entities are used in the parameters refsect1 -->
<!ENTITY mysql.linkid.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>link_identifier</parameter></term><listitem><para>Соединение MySQL. Если идентификатор соединения не был указан,
будет использовано последнее соединение, открытое <function>mysql_connect</function>. Если такое соединение не было найдено,
функция попытается создать таковое, как если бы <function>mysql_connect</function> была вызвана без параметров.
Если соединение не было найдено и не смогло быть создано, генерируется ошибка уровня <constant>E_WARNING</constant>.</para></listitem>
</varlistentry>'>

<!ENTITY mysql.linkid-noreopen.description '<varlistentry
xmlns="http://docbook.org/ns/docbook"><term>
<parameter>link_identifier</parameter></term><listitem><para>Соединение MySQL. Если
не указано, то будет использовано последнее соединение, открытое
<function>mysql_connect</function>. Если соединение не найдено или
не установлено, то будет сгенерирована ошибка уровня
<constant>E_WARNING</constant>.</para></listitem></varlistentry>'>

<!ENTITY mysql.result.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>result</parameter></term><listitem><para>Обрабатываемый <link xmlns="http://docbook.org/ns/docbook" linkend="language.types.resource">результат запроса</link>.
Этот результат может быть получен с помощью функции <function>mysql_query</function>.</para></listitem></varlistentry>'>

<!ENTITY mysql.field-offset.req.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>field_offset</parameter></term><listitem><para>Числовое смещение поля.
<parameter>field_offset</parameter> начинается с <literal>0</literal>. Если
<parameter>field_offset</parameter> не существует, генерируется ошибка уровня
<constant>E_WARNING</constant>.</para></listitem></varlistentry>'>

<!ENTITY mysql.alternative.note '<para xmlns="http://docbook.org/ns/docbook">Данный модуль устарел начиная с версии PHP 5.5.0, и удалён в PHP 7.0.0.
Используйте вместо него <link linkend="book.mysqli">MySQLi</link> или <link linkend="ref.pdo-mysql">PDO_MySQL</link>.
Смотрите также инструкцию <link linkend="mysqlinfo.api.choosing">MySQL: выбор API</link>.
Альтернативы для этой функции:</para>'>

<!ENTITY mysql.alternative.note.4-3-0 '<para xmlns="http://docbook.org/ns/docbook">Данная функция объявлена устаревшей в PHP 4.3.0, и, вместе с <link linkend="book.mysql">модулем MySQL</link>, удалена PHP в 7.0.0.
Вместо неё используйте активно развивающиеся модули <link linkend="book.mysqli">MySQLi</link> или <link linkend="ref.pdo-mysql">PDO_MySQL</link>.
Так же смотрите раздел <link linkend="mysqlinfo.api.choosing">MySQL: выбор API</link>.
Альтернативы для этой функции:</para>'>

<!ENTITY mysql.alternative.note.5-3-0 '<para xmlns="http://docbook.org/ns/docbook">Данная функция объявлена устаревшей в PHP 5.3.0, и, вместе с <link linkend="book.mysql">модулем MySQL</link>, удалена PHP в 7.0.0.
Вместо неё используйте активно развивающиеся модули <link linkend="book.mysqli">MySQLi</link> или <link linkend="ref.pdo-mysql">PDO_MySQL</link>.
Так же смотрите раздел <link linkend="mysqlinfo.api.choosing">MySQL: выбор API</link>.
Альтернативы для этой функции:</para>'>

<!ENTITY mysql.alternative.note.5-4-0 '<para xmlns="http://docbook.org/ns/docbook">Данная функция объявлена устаревшей в PHP 5.4.0, и, вместе с <link linkend="book.mysql">модулем MySQL</link>, удалена PHP в 7.0.0.
Вместо неё используйте активно развивающиеся модули <link linkend="book.mysqli">MySQLi</link> или <link linkend="ref.pdo-mysql">PDO_MySQL</link>.
Так же смотрите раздел <link linkend="mysqlinfo.api.choosing">MySQL: выбор API</link>.
Альтернативы для этой функции:</para>'>

<!ENTITY mysql.alternative.note.5-5-0 '<para xmlns="http://docbook.org/ns/docbook">Данная функция объявлена устаревшей в PHP 5.5.0, и, вместе с <link linkend="book.mysql">модулем MySQL</link>, удалена PHP в 7.0.0.
Вместо неё используйте активно развивающиеся модули <link linkend="book.mysqli">MySQLi</link> или <link linkend="ref.pdo-mysql">PDO_MySQL</link>.
Так же смотрите раздел <link linkend="mysqlinfo.api.choosing">MySQL: выбор API</link>.
Альтернативы для этой функции:</para>'>

<!ENTITY mysql.close.connections.result.sets '<para xmlns="http://docbook.org/ns/docbook">
Открытые непостоянные соединения MySQL и результирующие наборы автоматически удаляются сразу по окончании работы PHP-скрипта. Следовательно, закрывать соединения и очищать результирующие наборы не обязательно, но рекомендуется, так как это сразу же освободит ресурсы базы данных и память, занимаемую результатами выборки, что может положительно сказаться на производительности. Больше информации можно почерпнуть в разделе
<link linkend="language.types.resource.self-destruct">Освобождение ресурсов</link></para>'>

<!-- Sybase Notes -->
<!ENTITY sybase.ct.only '<note xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция доступна только при
использовании интерфейса к Sybase библиотеки CT, но не библиотеки DB.</simpara></note>'>

<!ENTITY sybase.db.only '<note xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция доступна только при
использовании интерфейса к Sybase библиотеки DB, но не библиотеки CT.</simpara></note>'>

<!ENTITY sybase.linkid.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>link_identifier</parameter></term><listitem><para>Соединение Sybase. Если идентификатор соединения
не указан, будет использовано последнее соединение, открытое <function>sybase_connect</function>. Если такое соединение не может
быть найдено, функция попытается создать новое, как если бы <function>sybase_connect</function> была вызвана без аргументов.
Если соединение не было найдено и не смогло быть создано, генерируется ошибка уровня <constant>E_WARNING</constant>.</para></listitem>
</varlistentry>'>

<!-- CPDF Notes -->
<!ENTITY cpdf.ul '<para xmlns="http://docbook.org/ns/docbook">Необязательный параметр <parameter>mode</parameter>
определяет единицу измерения. Если он не указан, либо равен <literal>0</literal>, будет выбрана единица измерения,
определённая по умолчанию для страницы. Иначе координаты
измеряются в пунктах postscript без учёта текущей единицы измерения.</para>'>

<!ENTITY cpdf.mode.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>mode</parameter></term><listitem><para>Необязательный параметр <parameter>mode</parameter>
определяет единицу измерения. Если он не указан, либо равен <literal>0</literal>, будет использована
установленная по умолчанию для страницы единица измерения. В остальных случаях координаты
измеряются в пунктах postscript, без учёта текущей единицы измерения.</para>
</listitem></varlistentry>'>

<!ENTITY cpdf.pdf-document.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>pdf_document</parameter></term><listitem><para>Дескриптор документа, который вернула функция
<function>cpdf_open</function>.</para></listitem></varlistentry>'>

<!-- Xattr entities -->
<!ENTITY xattr.namespace '<para xmlns="http://docbook.org/ns/docbook">У расширенных атрибутов
два пространства имён: пользовательское и корневое (root). Пользовательское
пространство имён доступно для всех пользователей, в то время как корневое —
только для пользователей с root-привилегиями. По умолчанию xattr оперирует в
пользовательском пространстве имён, но вы можете изменить это поведение
при помощи аргумента <parameter>flags</parameter>.</para>'>

<!-- Notes for IPv6 -->
<!ENTITY ipv6.brackets '<note xmlns="http://docbook.org/ns/docbook"><simpara>При указании числового адреса IPv6
(например, <literal>fe80::1</literal>) вы должны заключать его в квадратные скобки. Например,
<literal>tcp://[fe80::1]:80</literal>.</simpara></note>'>

<!ENTITY ipv6.php5 '<note xmlns="http://docbook.org/ns/docbook"><simpara>Поддержка IPv6 была добавлена в PHP 5.0.0.</simpara></note>'>

<!-- Notes for tidy -->
<!ENTITY tidy.object 'Объект <classname xmlns="http://docbook.org/ns/docbook">Tidy</classname>.'>

<!ENTITY tidy.conf-enc '<para xmlns="http://docbook.org/ns/docbook">Параметр <parameter>config</parameter> может быть передан как
в виде строки, так и в виде массива. В случае передачи строки, параметр рассматривается как
путь к конфигурационному файлу, в противном случае содержание массива рассматривается
как, собственно, конфигурация. За подробной информацией по каждой опции обращайтесь к
<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.tidy.conf;">&url.tidy.conf;</link>.</para>
<para>Параметр <parameter>encoding</parameter> устанавливает кодировку вводимых и выводимых документов.
 Возможные значения параметра <parameter>encoding</parameter>:
 <literal>ascii</literal>, <literal>latin0</literal>, <literal>latin1</literal>,
 <literal>raw</literal>, <literal>utf8</literal>, <literal>iso2022</literal>,
 <literal>mac</literal>, <literal>win1252</literal>, <literal>ibm858</literal>,
 <literal>utf16</literal>, <literal>utf16le</literal>,
 <literal>utf16be</literal>, <literal>big5</literal> и
 <literal>shiftjis</literal>.</para>'>

<!-- Snippets for the installation section -->
<!ENTITY warn.apache2.compat '<warning xmlns="http://docbook.org/ns/docbook"><para>Мы не рекомендуем использовать
потоковый MPM в промышленной среде вместе с Apache 2. Вместо этого, используйте prefork MPM, используемый по умолчанию
в Apache 2.0 и 2.2. Подробную информацию по этому вопросу вы можете найти в соответствующем разделе FAQ
<link linkend="faq.installation.apache2">Apache2 и потоковый MPM</link></para></warning>'>

<!ENTITY note.apache.slashes '<note xmlns="http://docbook.org/ns/docbook"><simpara>Помните, что при указании путей
в конфигурационных файлах Apache под Windows, все обратные слеши, например,
<filename>c:\directory\file.ext</filename> должны быть изменены на прямые:
<filename>c:/directory/file.ext</filename>. Для путей с директориями также может понадобиться слеш в конце.</simpara></note>'>

<!-- Snippets and titles for the contributors section -->
<!ENTITY Credit.Authors.and.Contributors 'Авторы и Участники'>

<!ENTITY Credit.Introduction '<para xmlns="http://docbook.org/ns/docbook"> Мы публикуем имена самых активных
на текущий момент участников разработки документации на первой странице,
но есть ещё множество людей, которые помогают нам во время разработки
или помогли ранее. Есть также много
участников, которые помогают нам через систему пользовательских замечаний,
которые постоянно включаются в основную документацию. Списки ниже
отсортированы в алфавитном порядке.
</para>'>

<!ENTITY Credit.Authors.and.Editors 'Авторы и Редакторы'>

<!ENTITY Credit.Past.Authors.Text 'Следующие участники внесли значительный вклад в наполнение документации в прошлом:'>

<!ENTITY Credit.Past.Editors.Text 'Следующие участники внесли значительный вклад в редактирование и корректирование документации
в прошлом:'>

<!ENTITY Credit.Note.Editors.Title 'Редакторы пользовательских замечаний'>

<!ENTITY Credit.Note.Editors.Active 'Текущие наиболее активные редакторы:'>

<!ENTITY Credit.Note.Editors.Inactive 'Эти люди внесли свой вклад в управление
пользовательскими замечаниями в прошлом:'>

<!ENTITY listendand ' и'>

<!-- classkit and runkit entities -->
<!ENTITY note.classkit.selfmanipulation '<note xmlns="http://docbook.org/ns/docbook"><simpara>Эту функцию нельзя использовать
для влияния на работающие в этот момент (или цепные) методы.</simpara>
</note>'>

<!ENTITY note.runkit.selfmanipulation '<note xmlns="http://docbook.org/ns/docbook"><simpara>Эту функцию нельзя использовать
для влияния на работающие в этот момент (или цепные) методы.</simpara>
</note>'>

<!ENTITY note.runkit.sandbox '<note xmlns="http://docbook.org/ns/docbook"><simpara>Поддержка песочницы (необходима для
<function>runkit_lint</function>, <function>runkit_lint_file</function>,
и класса <classname>Runkit_Sandbox</classname>) доступна только начиная с версии
PHP 5.1.0 или в специально пропатченных версиях PHP 5.0, а также требует потокобезопасной (thread safe) версии PHP.
Для более подробной информации смотрите файл <filename>README</filename>, поставляемый с пакетом runkit.</simpara></note>'>

<!ENTITY note.runkit.internal-override '<note xmlns="http://docbook.org/ns/docbook"><simpara>По умолчанию, только
пользовательские функции могут быть удалены, переименованы или изменены. Для перекрытия внутренних функций, необходимо
включить в &php.ini; опцию <literal>runkit.internal_override</literal>.</simpara>
</note>'>

<!-- SSH2 Extension -->
<!ENTITY note.ssh2.subsystem.publickey '<note xmlns="http://docbook.org/ns/docbook"><simpara>Через подсистему открытых ключей
управляют открытыми ключами на сервере, на котором клиент
<emphasis>уже</emphasis> прошёл аутентификацию. Вместо этого для аутентификации с открытым ключом на удалённой системе вызывают
функцию <function>ssh2_auth_pubkey_file</function>.</simpara></note>'>

<!-- Session notes -->
<!ENTITY returns.session.storage.retval 'Возвращаемое значение
сессионного хранилища (обычно &true; в случае успешного выполнения,
&false;, если возникла ошибка). Это значение возвращается
обратно в PHP для внутренней обработки.'>

<!-- HTTP -->

<!-- XMLWriter Notes -->
<!ENTITY xmlwriter.xmlwriter.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>writer</parameter></term><listitem><para>Только для процедурных вызовов.
Изменяемый экземпляр класса <classname>XMLWriter</classname>. Объект возвращается из вызова <function>xmlwriter_open_uri</function> или <function>xmlwriter_open_memory</function>.</para></listitem></varlistentry>'>

<!ENTITY xmlwriter.changelog.writer-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  В параметре <parameter>writer</parameter> теперь ожидается экземпляр класса <classname>XMLWriter</classname>;
  раньше параметр ждал ресурс (<type>resource</type>).
 </entry>
</row>'>

<!-- SOAP notes -->
<!ENTITY soap.wsdl.mode.only "<note xmlns='http://docbook.org/ns/docbook'><para>Эта функция
работает только в режиме WSDL.</para></note>">

<!-- Stomp notes -->
<!ENTITY stomp.param.link "<varlistentry xmlns='http://docbook.org/ns/docbook'><term><parameter>link</parameter></term><listitem><para>Только для процедурного стиля: идентификатор соединения stomp, полученный из <function>stomp_connect</function>.</para></listitem></varlistentry>">
<!ENTITY stomp.param.headers "<varlistentry xmlns='http://docbook.org/ns/docbook'><term><parameter>headers</parameter></term><listitem><para>Ассоциативный массив, содержащий дополнительные заголовки (пример: receipt).</para></listitem></varlistentry>">
<!-- TODO: need edition -->
<!ENTITY stomp.note.transaction "<note xmlns='http://docbook.org/ns/docbook'><para>Также может быть указан заголовок транзакции, означающий что приём сообщения должен являться частью именованной транзакции.</para></note>">
<!-- TODO: need edition -->
<!ENTITY stomp.note.sync "<tip xmlns='http://docbook.org/ns/docbook'><simpara>Stomp асинхронен по своей сути.
Синхронная связь может быть реализована добавлением receipt-заголовка. Это заставит методы ничего не возвращать, пока
сервер не подтвердит получение сообщения или не будет превышено время ожидания сообщения.</simpara></tip>">

<!-- SVN notes -->
<!ENTITY svn.relativepath "<note xmlns='http://docbook.org/ns/docbook'>
<simpara>
Функция вычислит относительные пути так, как если бы текущая рабочая директория была домашней папкой самого PHP.
Чтобы использовать рабочую директорию вызывающего скрипта, пользуются функцией <function>realpath</function>
или dirname(__FILE__).
</simpara>
</note>">

<!ENTITY svn.referto.status 'Для информации о возможных значениях, обратитесь
к <link xmlns="http://docbook.org/ns/docbook" linkend="svn.constants.status">константам статусов</link>.'>

<!ENTITY svn.referto.type 'Для информации о возможных значениях, обратитесь
к <link xmlns="http://docbook.org/ns/docbook" linkend="svn.constants.type">константам типов</link>.'>

<!-- FANN notes -->
<!ENTITY fann.ann.description '<para xmlns="http://docbook.org/ns/docbook">Ресурс (<type>resource</type>) нейронной сети.</para>'>
<!ENTITY fann.train.description '<para xmlns="http://docbook.org/ns/docbook">Ресурс (<type>resource</type>)
обучающих данных нейронной сети.</para>'>
<!ENTITY fann.errdat.description '<para xmlns="http://docbook.org/ns/docbook">Или ресурс (<type>resource</type>)
нейронной сети, или ресурс (<type>resource</type>) обучающих данных нейронной сети.</para>'>
<!ENTITY fann.return.void '<para xmlns="http://docbook.org/ns/docbook">Не возвращает никакого значения.</para>'>
<!ENTITY fann.return.bool '<para xmlns="http://docbook.org/ns/docbook">Возвращает &true;
в случае успешного выполнения, или &false; в противном случае.</para>'>
<!ENTITY fann.return.ann '<para xmlns="http://docbook.org/ns/docbook"> Возвращает ресурс (<type>resource</type>)
нейронной сети в случае успешного выполнения, или &false;
в случае ошибки.</para>'>
<!ENTITY fann.return.train '<para xmlns="http://docbook.org/ns/docbook"> Возвращает ресурс (<type>resource</type>)
обучающих данных, или &false;, если возникла ошибка.</para>'>
<!ENTITY fann.note.function.fann-2.2 '<note xmlns="http://docbook.org/ns/docbook"><para>Функция доступна,
только если модуль fann собрали для модуля libfann &gt;= 2.2.</para></note>'>

<!-- Imagick generic return types -->
<!ENTITY imagick.return.success 'В случае успешной работы возвращает &true;.'>
<!ENTITY imagick.imagick.throws 'Вызывает ImagickException, если возникла ошибка.'>
<!ENTITY imagick.imagickdraw.throws 'Вызывает ImagickDrawException, если возникла ошибка.'>
<!ENTITY imagick.imagickpixel.throws 'Вызывает ImagickPixelException, если возникла ошибка.'>
<!ENTITY imagick.imagickpixeliterator.throws 'Вызывает ImagickPixelIteratorException, если возникла ошибка.'>

<!-- Imagick version infos -->
<!ENTITY imagick.method.available.0x629 'Этот метод доступен, если Imagick был скомпилирован с версией ImageMagick 6.2.9 или старше.'>
<!ENTITY imagick.method.available.0x631 'Этот метод доступен, если Imagick был скомпилирован с версией ImageMagick 6.3.1 или старше.'>
<!ENTITY imagick.method.available.0x632 'Этот метод доступен, если Imagick был скомпилирован с версией ImageMagick 6.3.2 или старше.'>
<!ENTITY imagick.method.available.0x636 'Этот метод доступен, если Imagick был скомпилирован с версией ImageMagick 6.3.6 или старше.'>
<!ENTITY imagick.method.available.0x637 'Этот метод доступен, если Imagick был скомпилирован с версией ImageMagick 6.3.7 или старше.'>
<!ENTITY imagick.method.available.0x638 'Этот метод доступен, если Imagick был скомпилирован с версией ImageMagick 6.3.8 или старше.'>
<!ENTITY imagick.method.available.0x639 'Этот метод доступен, если Imagick был скомпилирован с версией ImageMagick 6.3.9 или старше.'>
<!ENTITY imagick.method.available.0x640 'Этот метод доступен, если Imagick был скомпилирован с версией ImageMagick 6.4.0 или старше.'>
<!ENTITY imagick.method.available.0x641 'Этот метод доступен, если Imagick был скомпилирован с версией ImageMagick 6.4.1 или старше.'>
<!ENTITY imagick.method.available.0x642 'Этот метод доступен, если Imagick был скомпилирован с версией ImageMagick 6.4.2 или старше.'>
<!ENTITY imagick.method.available.0x643 'Этот метод доступен, если Imagick был скомпилирован с версией ImageMagick 6.4.3 или старше.'>
<!ENTITY imagick.method.available.0x644 'Этот метод доступен, если Imagick был скомпилирован с версией ImageMagick 6.4.4 или старше.'>
<!ENTITY imagick.method.available.0x645 'Этот метод доступен, если Imagick был скомпилирован с версией ImageMagick 6.4.5 или старше.'>
<!ENTITY imagick.method.available.0x647 'Этот метод доступен, если Imagick был скомпилирован с версией ImageMagick 6.4.7 или старше.'>
<!ENTITY imagick.method.available.0x649 'Этот метод доступен, если Imagick был скомпилирован с версией ImageMagick 6.4.9 или старше.'>
<!ENTITY imagick.method.available.0x653 'Этот метод доступен, если Imagick был скомпилирован с версией ImageMagick 6.5.3 или старше.'>
<!ENTITY imagick.method.available.0x657 'Этот метод доступен, если Imagick был скомпилирован с версией ImageMagick 6.5.7 или старше.'>

<!ENTITY imagick.method.not.available.0x700 'Этот метод недоступен, если Imagick
был скомпилирован с версией ImageMagick 7.0.70или старше.'>

<!ENTITY imagick.constant.available 'Эта константа доступна, если Imagick
был скомпилирован с версией ImageMagick '>

<!ENTITY imagick.deprecated.function-3-4-4 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Функция
объявлена <emphasis>УСТАРЕВШЕЙ</emphasis> в Imagick 3.4.4. Полагаться на эту функцию крайне не рекомендуется.</simpara></warning>'>

<!-- Imagick default channel information -->
<!ENTITY imagick.default.channel.info 'По умолчанию равно
<constant xmlns="http://docbook.org/ns/docbook">Imagick::CHANNEL_DEFAULT</constant>.
Обратитесь к списку <link xmlns="http://docbook.org/ns/docbook" linkend="imagick.constants.channel">констант каналов</link>'>

<!-- Fuzz parameter -->
<!-- TODO: needs edit -->
<!ENTITY imagick.parameter.fuzz 'Мера округления (fuzz). Например, установите значение fuzz в 10 и красный цвет
с интенсивностью 100 и 102 будет интерпретироваться как один и тот же цвет.'>

<!-- Channel parameter -->
<!ENTITY imagick.parameter.channel 'Передайте любую корректную для вашего режима канала константу.
Для применения к более чем одному каналу, комбинируйте
<link xmlns="http://docbook.org/ns/docbook" linkend="imagick.constants.channel">константы каналов</link>
с помощью побитовых операторов. &imagick.default.channel.info;'>

<!-- Alpha parameter -->
<!ENTITY imagick.parameter.alpha 'Уровень прозрачности: 1.0 полностью непрозрачный, тогда как 0.0 полностью прозрачен.'>

<!ENTITY imagick.imagickexception.throw 'Вызывает
<classname xmlns="http://docbook.org/ns/docbook">ImagickException</classname>, если возникла ошибка.'>

<!ENTITY imagick.bestfit.note '<note xmlns="http://docbook.org/ns/docbook">
<simpara>
 Поведение параметра <parameter>bestfit</parameter> было изменено в Imagick 3.0.0.
 До этой версии при изменении изображения размером 200 x 150 до размера 400 x 300 никаких операций не происходило.
 В Imagick 3.0.0 и более поздних версиях изображение будет масштабировано до размера 400 x 300, так как наиболее
 соответствует ("best fit") данным размерам. Если указан параметр <parameter>bestfit</parameter>, то ширина и
 высота также должны быть определены.
</simpara>
</note>'>

<!ENTITY note.openssl.cnf '<note xmlns="http://docbook.org/ns/docbook">
<simpara>
 Для корректной работы этой функции должен существовать правильный <filename>openssl.cnf</filename>.
 Для более подробной информации смотрите замечания под <link linkend="openssl.installation">разделом установки</link>.
</simpara>
</note>'>
<!ENTITY note.openssl.param-notext '<para xmlns="http://docbook.org/ns/docbook">
Необязательный параметр <parameter>notext</parameter> влияет на детализацию сообщений вывода; если он установлен в &false;,
то в вывод добавляется дополнительная человекочитаемая информация. Значением по умолчанию
<parameter>notext</parameter> является &true;.
</para>'>

<!-- COM/Dotnet -->
<!-- TODO: needs editions -->
<!ENTITY com.variant-arith '<note xmlns="http://docbook.org/ns/docbook">
<para>
 Как и со всеми вариантными арифметическими функциями, параметры этой функции могут быть
 как родными PHP типами (integer, string, floating point, boolean или
 &null;), так и экземплярами классов COM, VARIANT или DOTNET. Родные PHP типы
 будут преобразованы в варианты (variants) по тем же самым правилам, что и в конструкторе
 класса <xref linkend="class.variant"/>. У объектов COM и DOTNET будет взято и использовано их значение по умолчанию
 в качестве значения варианта.
</para>
<para>
 Вариантные арифметические функции являются обёртками вокруг одноимённых
 функций в библиотеке COM; для более подробной информации по этим функциям проконсультируйтесь с библиотекой
 MSDN. Названия PHP-функций немного отличаются; например,
 <function>variant_add</function> в PHP соответствует <literal>VarAdd()
 </literal> в документации MSDN.
</para>
</note>
'>
<!ENTITY com.use-oo-instead '<note xmlns="http://docbook.org/ns/docbook">
<simpara>
 Эта функция не существует в PHP 5; вместо этого для доступа к свойствам и вызову методов используйте
 обычный и более привычный объектно-ориентированный синтаксис.
</simpara>
</note>
'>

<!ENTITY phar.note.performance '<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  <function>Phar::addFile</function>, <function>Phar::addFromString</function> и <function>Phar::offsetSet</function>
  сохраняет новый phar-архив каждый раз при их вызове. Если производительность вызывает беспокойство,
  вместо этого следует использовать <function>Phar::buildFromDirectory</function>
  или <function>Phar::buildFromIterator</function>.
 </simpara>
</note>'>

<!ENTITY phardata.note.performance '<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  <function>PharData::addFile</function>, <function>PharData::addFromString</function> and <function>PharData::offsetSet</function>
  save a new phar archive each time they are called. If performance is a concern,
  <function>PharData::buildFromDirectory</function> or <function>PharData::buildFromIterator</function>
  should be used instead.
 </simpara>
</note>'>

<!-- phar -->
<!ENTITY phar.write '<note xmlns="http://docbook.org/ns/docbook"><para>Для корректной работы с объектами <classname>Phar</classname>
этому методу необходима установка значения &php.ini; <literal>phar.readonly</literal> в <literal>0</literal>.
В противном случае, будет выброшено исключение <classname>PharException</classname>.</para></note>'>

<!ENTITY phar.removed.pharcompress '<note xmlns="http://docbook.org/ns/docbook"><para>Этот метод был
удалён из модуля phar начиная с версии 2.0.0. Альтернативные реализации возможны с помощью функций
<function>Phar::compress</function>,
<function>Phar::decompress</function>, <function>Phar::compressFiles</function> и
<function>Phar::decompressFiles</function>.</para></note>'>

<!ENTITY phar.removed.pharfileinfocompress '<note xmlns="http://docbook.org/ns/docbook"><para>Этот метод был
удалён из модуля phar начиная с версии 2.0.0. Альтернативные реализации возможны с помощью функций
<function>PharFileInfo::isCompressed</function>,
<function>PharFileInfo::decompress</function>, и <function>PharFileInfo::compress</function>.</para></note>'>

<!-- XML -->
<!ENTITY libxml.required '<para xmlns="http://docbook.org/ns/docbook">Для корректной работы этого модуля необходим
PHP-модуль <link linkend="book.libxml">libxml</link>. Это означает, что также необходима передача опции
<option role="configure">--with-libxml</option>, или до PHP 7.4 <option role="configure">--enable-libxml</option>, хотя неявно это уже сделано, так как поддержка libxml по умолчанию включена.</para>'>

<!-- XMLReader -->
<!ENTITY xmlreader.libxml20620.note '<caution xmlns="http://docbook.org/ns/docbook"><para>Эта функция доступна только если
PHP скомпилирован с поддержкой libxml 20620 или старше.</para></caution>'>

<!-- inotify -->
<!ENTITY inotify.instance.description 'Ресурс, который возвращает функция
<function xmlns="http://docbook.org/ns/docbook">inotify_init</function>.'>

<!-- User streams -->
<!ENTITY userstream.not.implemented.warning '<para xmlns="http://docbook.org/ns/docbook">Вызывает ошибку уровня
<constant>E_WARNING</constant>, если вызов к этому методу не удался
(например, не реализован).</para>'>
<!ENTITY userstream.updates.context '<note xmlns="http://docbook.org/ns/docbook"><para>Свойство
<varname linkend="streamwrapper.props.context">streamWrapper::$context</varname>
будет обновлено, если корректный контекст был передан в вызываемую функцию.</para></note>'>

<!-- Gmagick -->
<!ENTITY gmagick.return.success 'Возвращает &true; в случае успешного завершения работы.'>
<!ENTITY gmagick.gmagickexception.throw 'Вызывает
<classname xmlns="http://docbook.org/ns/docbook">GmagickException</classname>, если возникла ошибка.'>

<!-- Reflection -->
<!ENTITY reflection.export.return 'Если параметр <parameter xmlns="http://docbook.org/ns/docbook">return</parameter>
установлен в &true;, тогда экспортируемый объект будет возвращён как <type xmlns="http://docbook.org/ns/docbook">string</type>,
иначе будет возвращён &null;.'>

<!ENTITY reflection.export.param.return 'Метод вернёт значение экспорта,
а не выведет его, если установить для параметра значение &true;.
При значении по умолчанию — &false; метод сделает наоборот.'>

<!ENTITY reflection.invoke.reference 'Аргументы в списке, который передают
в метод, должны быть ссылками, если у функции есть параметры, которые принимают аргументы по ссыкле.'>

<!ENTITY reflection.export.param.name 'Название или объект класса для экспорта.'>

<!ENTITY reflection.getattributes.param.name '<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>name</parameter></term>
<listitem>
 <para>
  Параметр отфильтрует результаты, чтобы включить экземпляры
  отражений <classname>ReflectionAttribute</classname> только тех атрибутов,
  чьи имена совпадают с заданным именем класса.
 </para>
</listitem>
</varlistentry>'>

<!ENTITY reflection.getattributes.param.flags '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>flags</parameter></term>
 <listitem>
  <para>
   Флаги для определения способа фильтрации результатов,
   если указан параметр <parameter>name</parameter>.
  </para>
  <para>
   По умолчанию значение <literal>0</literal>, которое
   возвращает результаты только для атрибутов,
   которые относятся к классу <parameter>name</parameter>.
  </para>
  <para>
   Единственное доступное значение — константа
   <constant>ReflectionAttribute::IS_INSTANCEOF</constant>,
   которая вместо этого будет использовать для фильтрации
   оператор <literal>instanceof</literal>.
  </para>
 </listitem>
</varlistentry>'>

<!-- SPL -->
<!ENTITY spl.datastructures.intro.title '<title xmlns="http://docbook.org/ns/docbook">Структуры данных</title>'>

<!ENTITY spl.exceptions.intro.title '<title
xmlns="http://docbook.org/ns/docbook">Исключения</title>'
>

<!ENTITY spl.exceptions.intro '<para
xmlns="http://docbook.org/ns/docbook">Библиотека SPL содержит набор стандартных исключений.</para>
<para xmlns="http://docbook.org/ns/docbook">Смотрите также «<xref linkend="reserved.exceptions" />».
</para>'
>

<!ENTITY spl.files.intro.title '<title xmlns="http://docbook.org/ns/docbook">Обработка файлов</title>'>

<!ENTITY spl.files.intro '<partintro xmlns="http://docbook.org/ns/docbook">
<para>Библиотека SPL предлагает набор классов для работы с файлами.</para></partintro>'
>

<!ENTITY spl.interfaces.intro.title '<title xmlns="http://docbook.org/ns/docbook">Интерфейсы</title>'>

<!ENTITY spl.interfaces.intro '<para xmlns="http://docbook.org/ns/docbook">
Библиотека SPL содержит набор интерфейсов.</para>
<para xmlns="http://docbook.org/ns/docbook">Смотрите также <xref linkend="reserved.interfaces" /></para>'
>

<!ENTITY spl.interfaces.list '<title xmlns="http://docbook.org/ns/docbook">Список интерфейсов</title>'>

<!ENTITY spl.iterators.intro.title '<title xmlns="http://docbook.org/ns/docbook">Итераторы</title>'>

<!ENTITY spl.iterators.intro '<para xmlns="http://docbook.org/ns/docbook">
Библиотека SPL предлагает набор итераторов для обхода объектов.
</para>'
>

<!ENTITY spl.misc.intro.title '<title xmlns="http://docbook.org/ns/docbook">
Классы и интерфейсы</title>'
>

<!ENTITY spl.misc.intro '<partintro xmlns="http://docbook.org/ns/docbook">
<para>Классы и интерфейсы, которые не входят в другие категории библиотеки SPL.</para></partintro>'
>

<!-- ZIP -->
<!ENTITY zip.filename.separator '<note xmlns="http://docbook.org/ns/docbook">
<simpara>Для максимальной переносимости, рекомендуется всегда пользоваться
прямыми слешами <literal>/</literal> как разделителями директорий в именах файлов.</simpara></note>'
>

<!-- Win32Service -->
<!ENTITY win32service.false.error ', &false; если обнаружилась проблема с параметрами или
<link xmlns="http://docbook.org/ns/docbook" linkend="win32service.constants.errors">
код ошибки Win32</link> при неудачном завершении работы.'
>

<!ENTITY win32service.success.false.error 'Возвращает &true; в случае успешного завершения&win32service.false.error;'>

<!ENTITY win32service.noerror.false.error 'Возвращает
<constant xmlns="http://docbook.org/ns/docbook">WIN32_NO_ERROR</constant>
в случае успешного завершения &win32service.false.error;'
>

<!-- SNMP -->
<!ENTITY snmp.set.type.values '<para xmlns="http://docbook.org/ns/docbook">
<acronym>MIB</acronym> указывает тип идентификатора каждого объекта. Он должен быть указан в виде одного символа из
следующего списка.
</para>
<table xmlns="http://docbook.org/ns/docbook">
 <title>types</title>
 <tgroup cols="2">
  <tbody>
   <row><entry>=</entry><entry>Тип, принимаемый MIB</entry></row>
   <row><entry>i</entry><entry>INTEGER</entry> </row>
   <row><entry>u</entry><entry>INTEGER</entry></row>
   <row><entry>s</entry><entry>STRING</entry></row>
   <row><entry>x</entry><entry>HEX STRING</entry></row>
   <row><entry>d</entry><entry>DECIMAL STRING</entry></row>
   <row><entry>n</entry><entry>NULLOBJ</entry></row>
   <row><entry>o</entry><entry>OBJID</entry></row>
   <row><entry>t</entry><entry>TIMETICKS</entry></row>
   <row><entry>a</entry><entry>IPADDRESS</entry></row>
   <row><entry>b</entry><entry>BITS</entry></row>
  </tbody>
 </tgroup>
</table>
<para xmlns="http://docbook.org/ns/docbook">
 Если при компиляции библиотеки <acronym>SNMP</acronym> определили
 опцию <constant>OPAQUE_SPECIAL_TYPES</constant>, то также разрешается использовать
 следующие типы:
</para>
<table xmlns="http://docbook.org/ns/docbook">
 <title>types</title>
 <tgroup cols="2">
  <tbody>
   <row><entry>U</entry><entry>unsigned int64</entry></row>
   <row><entry>I</entry><entry>signed int64</entry></row>
   <row><entry>F</entry><entry>float</entry></row>
   <row><entry>D</entry><entry>double</entry></row>
  </tbody>
 </tgroup>
</table>
'>
<!ENTITY snmp.set.type.values.asn.mapping '<para xmlns="http://docbook.org/ns/docbook">
Бо́льшая часть этих значений использует очевидный тип ASN.1.
&apos;s&apos;, &apos;x&apos;, &apos;d&apos; и &apos;b&apos; — это
все разные способы указания значения OCTET STRING, а
беззнаковый тип &apos;u&apos; также указывают для обработки
значений Gauge32.
</para>'
>

<!ENTITY snmp.set.type.values.equal.note '<para xmlns="http://docbook.org/ns/docbook">
Если MIB-файлы были загружены в MIB-дерево с помощью "snmp_read_mib"
или были указаны в конфигурационном файле libsnmp, то для указания
параметра <parameter>type</parameter> можно использовать нотацию
&apos;=&apos;, т. к. тип всех идентификаторов объектов будет автоматически
считан из MIB.
</para>'
>

<!ENTITY snmp.set.type.values.bitset.note '<para xmlns="http://docbook.org/ns/docbook">
Обратите внимание, что переменную типа BITS устанавливают двумя способами,
например,
"SYNTAX    BITS {telnet(0), ftp(1), http(2), icmp(3), snmp(4), ssh(5), https(6)}":
</para>
<itemizedlist xmlns="http://docbook.org/ns/docbook">
 <listitem>
  <simpara>
   С помощью типа "b" и списка битовых чисел. Не рекомендуется использовать этот метод,
   поскольку GET-запрос для того же OID вернёт, например, 0xF8.
  </simpara>
 </listitem>
 <listitem>
  <simpara>
   С помощью типа "x" и шестнадцатеричного числа, но без(!) обычного префикса "0x".
  </simpara>
 </listitem>
</itemizedlist>
<para xmlns="http://docbook.org/ns/docbook">
 Подробнее смотрите в разделе с примерами.
</para>
'>
<!ENTITY snmp.methods.exceptions_enable.refsect '<refsect1 role="errors" xmlns="http://docbook.org/ns/docbook">
&reftitle.errors;
<para>
 Этот метод по умолчанию не генерирует исключения.
 Чтобы включить генерацию исключения SNMPException при возникновении
 некоторых ошибок данной библиотеки, необходимо установить параметр
 <parameter>exceptions_enabled</parameter> класса SNMP в
 соответствующее значение. Подробнее смотрите в <link linkend="snmp.props.exceptions-enabled">
 объяснении параметра <parameter>SNMP::$exceptions_enabled</parameter></link>.
</para>
</refsect1>
'>

<!-- Eio -->
<!ENTITY eio.callback.proto '<para xmlns="http://docbook.org/ns/docbook">
Функция <parameter xmlns="http://docbook.org/ns/docbook">callback</parameter> вызывается при завершении запроса.
Она должна удовлетворять следующему прототипу: <programlisting role="php"><![CDATA[
void callback(mixed $data, int $result[, resource $req]);
]]></programlisting>
<variablelist xmlns="http://docbook.org/ns/docbook">
 <varlistentry xmlns="http://docbook.org/ns/docbook">
  <term><parameter>data</parameter></term>
  <listitem><para>является пользовательскими данными, переданными в запросе.</para></listitem>
 </varlistentry>
 <varlistentry xmlns="http://docbook.org/ns/docbook">
  <term><parameter>result</parameter></term>
  <listitem><para>содержит результирующее значение, зависящее от запроса; обычно это значение, возвращаемое соответствующим
   системным вызовом.</para></listitem>
 </varlistentry>
 <varlistentry xmlns="http://docbook.org/ns/docbook">
  <term><parameter>req</parameter></term>
  <listitem>
   <para>
    — необязательный запрашиваемый ресурс, который разрешено использовать
    с функциями наподобие <function>eio_get_last_error</function>.
   </para>
  </listitem>
 </varlistentry>
</variablelist>
</para>
'>

<!ENTITY eio.request.pri.values '<para
xmlns="http://docbook.org/ns/docbook">Приоритет запросов: <constant
xmlns="http://docbook.org/ns/docbook">EIO_PRI_DEFAULT</constant>, <constant
xmlns="http://docbook.org/ns/docbook">EIO_PRI_MIN</constant>, <constant
xmlns="http://docbook.org/ns/docbook">EIO_PRI_MAX</constant>, или &null;.
Если передан &null;, то <parameter
xmlns="http://docbook.org/ns/docbook">pri</parameter> устанавливается в
<constant xmlns="http://docbook.org/ns/docbook">EIO_PRI_DEFAULT</constant>.
</para>
'>

<!ENTITY eio.warn.relpath '<warning
xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Избегайте
относительных путей</simpara></warning>
'>

<!ENTITY trader.arg.array.of.real 'Массив, который содержит реальные значения.'>
<!ENTITY trader.arg.array.of.real.high 'Максимальная цена, массив реальных значений.'>
<!ENTITY trader.arg.array.of.real.low 'Минимальная цена, массив реальных значений.'>
<!ENTITY trader.arg.array.of.real.close 'Цена закрытия, массив реальных значений.'>
<!ENTITY trader.arg.array.of.real.open 'Цена открытия, массив реальных значений.'>
<!ENTITY trader.arg.array.of.real.volume 'Объём торгов, массив реальных значений.'>
<!ENTITY trader.arg.array.of.real.periods 'Массив с реальными значениями.'>
<!ENTITY trader.arg.penetration 'Процент проникновения одной свечи внутри другой свечи.'>
<!ENTITY trader.arg.vfactor 'Коэффициент объёма. Допустимы значения от 1 до 0.'>
<!ENTITY trader.arg.time.period 'Номер периода. Допустимы значения от 2 до 100 000.'>

<!ENTITY trader.arg.fast.period 'Номер периода для быстрого скользящего среднего.
Допустимы значения от 2 до 100 000.'>

<!ENTITY trader.arg.slow.period 'Номер периода для медленного скользящего среднего.
Допустимы значения от 2 до 100 000.'>

<!ENTITY trader.arg.signal.period 'Сглаживание для сигнальной линии (номер периода).
Допустимы значения от 1 до 100 000.'>

<!ENTITY trader.arg.fastk.period 'Временной период для построения линии Fast-K.
Допустимы значения от 1 до 100 000.'>

<!ENTITY trader.arg.fastd.period 'Сглаживание для создания линии Fast-D.
Допустимы значения от 1 до 100 000,
обычно установлено значение 3.'>

<!ENTITY trader.arg.slowk.period 'Сглаживание для создания линии Slow-K.
Допустимы значения от 1 до 100 000,
обычно установлено значение 3.'>

<!ENTITY trader.arg.slowd.period 'Сглаживание для создания линии Slow-D.
Допустимы значения от 1 до 100 000.'>

<!ENTITY trader.arg.min.period 'Значение, меньшее минимума, будет изменено на минимальный период.
Допустимы значения от 2 до 100 000'>

<!ENTITY trader.arg.max.period 'Значение, большее максимума, будет изменено на максимальный период.
Допустимы значения от 2 до 100 000'>

<!ENTITY trader.arg.ma.type 'Тип скользящей средней. Следует использовать серию констант
<link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link>.'>

<!ENTITY trader.arg.fast.ma.type 'Тип скользящей средней для быстрого
скользящего среднего. Следует использовать серию констант
<link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link>.'>

<!ENTITY trader.arg.slow.ma.type 'Тип скользящей средней для медленного скользящего среднего.
Следует использовать серию констант
<link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link>.'>

<!ENTITY trader.arg.fastd.ma.type 'Тип скользящей средней для Fast-D. Следует использовать серию констант
<link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link>.'>

<!ENTITY trader.arg.slowk.ma.type 'Тип скользящей средней для Slow-K. Следует использовать серию констант
<link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link>.'>

<!ENTITY trader.arg.slowd.ma.type 'Тип скользящей средней для Slow-D. Следует использовать серию констант
<link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link>.'>

<!ENTITY trader.arg.slowk.ma.type 'Тип скользящей средней для Slow-K. Следует использовать серию констант
<link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link>.'>

<!ENTITY trader.arg.signal.ma.type 'Тип скользящей средней для сигнальной линии. Следует использовать серию констант
<link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link>.'>

<!ENTITY trader.arg.nbdevup 'Отклоняющий множитель для верхней полосы. Допустимы значения
от <link xmlns="http://docbook.org/ns/docbook" linkend="constant.trader-real-min">TRADER_REAL_MIN</link>
до <link xmlns="http://docbook.org/ns/docbook" linkend="constant.trader-real-max">TRADER_REAL_MAX</link>.'>

<!ENTITY trader.arg.nbdevdn 'Отклоняющий множитель для нижней полосы. Допустимы значения
от <link xmlns="http://docbook.org/ns/docbook" linkend="constant.trader-real-min">TRADER_REAL_MIN</link>
до <link xmlns="http://docbook.org/ns/docbook" linkend="constant.trader-real-max">TRADER_REAL_MAX</link>.'>

<!ENTITY trader.arg.fast.limit 'Верхний предел, используемый в адаптивном алгоритме. Допустимы значения от 0.01 до 0.99.'>
<!ENTITY trader.arg.slow.limit 'Нижний предел, используемый в адаптивном алгоритме. Допустимы значения от 0.01 до 0.99.'>

<!-- Mongo -->
<!ENTITY mongo.setreadpreference.parameters '<variablelist xmlns="http://docbook.org/ns/docbook"><varlistentry><term><parameter>read_preference</parameter></term><listitem><para>Режимы предпочтения чтения: <constant>MongoClient::RP_PRIMARY</constant>, <constant>MongoClient::RP_PRIMARY_PREFERRED</constant>, <constant>MongoClient::RP_SECONDARY</constant>, <constant>MongoClient::RP_SECONDARY_PREFERRED</constant> и <constant>MongoClient::RP_NEAREST</constant>.</para></listitem></varlistentry><varlistentry><term><parameter>tags</parameter></term><listitem><para>Пустой массив, либо содержащий наборы тегов, где каждый такой набор является массивом из критериев, используемых в соответствии с тегами членов набора реплик.</para></listitem></varlistentry></variablelist>'>
<!ENTITY mongo.setreadpreference.returnvalues '<para xmlns="http://docbook.org/ns/docbook">Возвращает &true; в случае успешного выполнения, иначе — &false;.</para>'>
<!ENTITY mongo.setreadpreference.errors '<para xmlns="http://docbook.org/ns/docbook">Генерирует ошибку уровня <constant>E_WARNING</constant>, в случае неверных параметров, либо если один или более наборов тегов были переданы с режимом чтения <constant>MongoClient::RP_PRIMARY</constant>.</para>'>
<!ENTITY mongo.getreadpreference.returnvalues '<para xmlns="http://docbook.org/ns/docbook">Данная функция возвращает массив, описывающий режимы предпочтения чтения. Массив содержит следующие значения: <literal>type</literal> для строкового значения режима предпочтения чтения (соответствующий константам <classname>MongoClient</classname>) и <literal>tagsets</literal>, содержащее список всех критерий наборов тегов. Если наборы тегов не были указаны, то <literal>tagsets</literal> в массиве не будет.</para>'>
<!ENTITY mongo.setwriteconcern.parameters '<variablelist xmlns="http://docbook.org/ns/docbook"><varlistentry><term><parameter>w</parameter></term><listitem><para>Контроль записи. Может быть числом означающим число серверов, требуемых для подтверждения записи, или режим в виде строки (например "majority").</para></listitem></varlistentry><varlistentry><term><parameter>wtimeout</parameter></term><listitem><para>Максимальное количество миллисекунд ожидания для сервера, чтобы удовлетворить контроль записи.</para></listitem></varlistentry></variablelist>'>
<!ENTITY mongo.setwriteconcern.returnvalues '<para xmlns="http://docbook.org/ns/docbook">Возвращает &true; в случае успешного выполнения, или &false; в противном случае.</para>'>
<!ENTITY mongo.setwriteconcern.errors '<para xmlns="http://docbook.org/ns/docbook">Бросает предупреждение <constant>E_WARNING</constant> в случае, если параметр <literal>w</literal> не является целым числом или строкой.</para>'>
<!ENTITY mongo.getwriteconcern.returnvalues '<para xmlns="http://docbook.org/ns/docbook">Эта функция возвращает массив, описывающий контроль записи. Массив содержит значения <literal>w</literal> — уровень подтверждения или режим в виде строки, и <literal>wtimeout</literal> определяющий максимальное количество миллисекунд ожидания для сервера, чтобы удовлетворить контроль записи.</para>'>
<!ENTITY mongo.command.parameters.maxtimems '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"maxTimeMS"</literal></para><para>Указывает суммарный лимит времени в миллисекундах на обработку операции (не включая время простоя) на сервере. Если операция на стороне сервера не завершилась за это время, то вызывается исключение <classname>MongoExecutionTimeoutException</classname>.</para></listitem>'>
<!ENTITY mongo.index.parameters.background '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"background"</literal></para><para>Перестраивать индекс в фоновом режиме, чтобы <emphasis>не</emphasis> блокировать другие задачи базы данных. Укажите &true; для перестроения в фоновом режиме. Значение по умолчанию — &false;.</para><warning xmlns="http://docbook.org/ns/docbook"><para>До MongoDB 2.6.0, перестраивание индекса запускалось на ведомом сервере как приоритетная операция, независимо от этой опции. Смотрите <link xlink:href="&url.mongodb.dochub.indexes.rs;" xmlns:xlink="http://www.w3.org/1999/xlink">Перестроение индексов с Replica Sets</link> для дополнительной информации.</para></warning></listitem>'>
<!ENTITY mongo.index.parameters.dropdups '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"dropDups"</literal></para><para>Укажите &true; для принудительного создания уникального индекса, где коллекция может содержать одинаковые значения для ключа. MongoDB будет индексировать первое вхождение ключа и удалять все последующие документы из коллекции, которые содержат такие же значения для ключа. Значение по умолчанию —  &false;.</para><warning xmlns="http://docbook.org/ns/docbook"><para><literal>"dropDups"</literal> может удалить данные из базы данных. Используйте с особой осторожностью.</para></warning><note xmlns="http://docbook.org/ns/docbook"><para>Эта опция не поддерживается в MongoDB 2.8+. Создание индекса не выполнится, если коллекция содержит одинаковые значения.</para></note></listitem>'>
<!ENTITY mongo.index.parameters.expireafterseconds '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"expireAfterSeconds"</literal></para><para>Значение этой опции определяет количество секунд, после которого документ считается устаревшим и автоматически удаляется из коллекции. Эта опция совместима только с индексами на одно поле, где поле содержит значения <classname>MongoDate</classname>.</para><note xmlns="http://docbook.org/ns/docbook"><para>Эта опция доступна в MongoDB 2.2+. Смотрите <link xlink:href="&url.mongodb.docs.expire_data;" xmlns:xlink="http://www.w3.org/1999/xlink">Устаревание данных в коллекциях с помощью задания TTL</link> для получения более подробной информации.</para></note></listitem>'>
<!ENTITY mongo.index.parameters.name '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"name"</literal></para><para>Необязательное имя, которое уникально идентифицирует индекс.</para><note xmlns="http://docbook.org/ns/docbook"><para>По умолчанию, драйвер создаёт имя индекса на основе полей индекса и их порядке или типе. Например, составной индекс <literal>array("x" => 1, "y" => -1)</literal> будет назван <literal>"x_1_y_-1"</literal>, а гео-индекс <literal>array("loc" => "2dsphere")</literal> будет назван <literal>"loc_2dsphere"</literal>. Для индексов из нескольких полей возможно превышение именем <link xlink:href="&url.mongodb.docs.limits;#Index-Name-Length" xmlns:xlink="http://www.w3.org/1999/xlink">максимальной длины имени индекса</link> MongoDB. В этом случае можно применить опцию <literal>"name"</literal>, чтобы указать более короткое имя.</para></note></listitem>'>
<!ENTITY mongo.index.parameters.sparse '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"sparse"</literal></para><para>Укажите &true; для создания разреженного (sparse) индекса, который индексирует только документы содержащие указанное поле. Значение по умолчанию &false;.</para></listitem>'>
<!ENTITY mongo.index.parameters.unique '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"unique"</literal></para><para>Укажите &true; для создания уникального индекса. По умолчанию значение равно &false;. Эта опция применяется только к возрастающим/убывающим индексам.</para><note xmlns="http://docbook.org/ns/docbook"><para> При индексации MongoDB поля, если не имеет значения для указанного поля, будет проиндексировано значение &null;. Если несколько документов не содержат поля, то уникальный индекс отклонит все документы, кроме первого. Можно использовать опцию <literal>"sparse"</literal>, чтобы обойти это ограничение, так как документы без указанного поля не будут индексироваться.</para></note></listitem>'>
<!ENTITY mongo.listcollections.note '<note xmlns="http://docbook.org/ns/docbook"><simpara>Этот метод использует команду <link xlink:href="&url.mongodb.docs.command;listCollections" xmlns:xlink="http://www.w3.org/1999/xlink">listCollections</link> когда общается с MongoDB 2.8+. Для более старых баз данных, этот метод запрашивает специальную коллекцию <literal>system.namespaces</literal>.</simpara></note>'>
<!ENTITY mongo.listcollections.parameters.filter '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"filter"</literal></para><para>Опциональный критерий запроса. Если задан, то будет использован для фильтрации коллекций, включённых в результирующий набор.</para><para>Подходящие поля для запроса включают <literal>"name"</literal> (строка с именем коллекции, без префикса в виде имени базы данных) и <literal>"options" (объект, включающий опции, использованные при создании этой коллекции).</literal>.</para><note><simpara>MongoDB 2.6 и более ранние версии, требуют, чтобы критерий <literal>"name"</literal> был строго строкового типа. Потому, что драйвер должен добавить к этому значению префикс в виде имени базы данных для запроса коллекции <literal>system.namespaces</literal>. Более поздние версии MongoDB не имеют этого ограничения, так как драйвер использует команду listCollections.</simpara></note></listitem>'>
<!ENTITY mongo.listcollections.parameters.includesystemcollections '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"includeSystemCollections"</literal></para><para>Логическое значение, по умолчанию &false;. Определяет, должны ли системные коллекции входить в результирующий набор.</para></listitem>'>
<!ENTITY mongo.writes.parameters.writeconcern '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"w"</literal></para><para>Смотрите <link linkend="mongo.writeconcerns">Контроль записи</link>. Значение по умолчанию для <classname>MongoClient</classname> является <literal>1</literal>.</para></listitem>'>
<!ENTITY mongo.writes.parameters.writeconcerntimeout '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"wtimeout"</literal></para><para>Устаревший псевдоним для <literal>"wTimeoutMS"</literal>.</para></listitem>'>
<!ENTITY mongo.writes.parameters.writeconcerntimeoutms '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"wTimeoutMS"</literal></para><para>Эта опция определяет лимит времени в миллисекундах для подтверждения <link linkend="mongo.writeconcerns">контроля записи</link>. Она применима только, если <literal>"w"</literal> больше <literal>1</literal>, так как ограничение времени относится к репликации. Если контроль записи не подтверждён за отведённое время, то будет выброшено исключение <classname>MongoCursorException</classname>. Значение <literal>0</literal> для постоянного отключения. Значением по умолчанию для <classname>MongoClient</classname> является <literal>10000</literal> (десять секунд).</para></listitem>'>
<!ENTITY mongo.writes.parameters.fsync '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"fsync"</literal></para><para>Логическое значение, по умолчанию &false;. Если включено журналирование, то работает также как и <literal>"j"</literal>. Если журналирование не включено, то операции записи блокируются пока не будут синхронизированы с файлами на жёстком диске. Если &true;, то применяется подтверждённая вставка и эта опция переопределяет опцию <literal>"w"</literal> в значение <literal>0</literal>.</para><note><simpara>Если журналирование включено, то пользователю настоятельно рекомендуется использовать опцию <literal>"j"</literal> вместо <literal>"fsync"</literal>. Не используйте <literal>"fsync"</literal> и <literal>"j"</literal> одновременно,так как это может привести к ошибке.</simpara></note></listitem>'>
<!ENTITY mongo.writes.parameters.sockettimeoutms '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"socketTimeoutMS"</literal></para><para>Эта опция определяет время в миллисекундах для общения в socket. Если сервер не ответил за отведённое время, то будет брошено исключение <classname>MongoCursorTimeoutException</classname>, и не будет никакой возможности определить, произвёл ли сервер запись или нет. Значение <literal>-1</literal> используют для постоянного отключения этой функции. Значением по умолчанию для  <classname>MongoClient</classname> является <literal>30000</literal> (30 секунд).</para></listitem>'>
<!ENTITY mongo.writes.parameters.journal '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"j"</literal></para><para>Логическое значение, по умолчанию &false;. Блокирует операции записи пока они не будут синхронизированы с журналом на диске. Если &true;, то применяется подтверждённая вставка  и эта опция переопределяет опцию <literal>"w"</literal> в значение <literal>0</literal>.</para><note><simpara>Если применяется эта опция и журналирование отключено, то MongoDB 2.6+ выбросит ошибку и прервёт запись; старые версии сервера просто игнорируют эту опцию.</simpara></note></listitem>'>
<!ENTITY mongo.writes.parameters.safe '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"safe"</literal></para><para>Устаревшая опция. Используйте опцию <literal>"w"</literal> <link linkend="mongo.writeconcerns">контроля записи</link>.</para></listitem>'>
<!ENTITY mongo.writes.parameters.timeout '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"timeout"</literal></para><para>Устаревший псевдоним для <literal>"socketTimeoutMS"</literal>.</para></listitem>'>
<!ENTITY mongo.errors.exceptions.writeconcern '<para xmlns="http://docbook.org/ns/docbook">Исключение  <classname>MongoCursorException</classname> бросается, если установлена опция <literal>"w"</literal> и не прошла запись.</para><para xmlns="http://docbook.org/ns/docbook">Исключение <classname>MongoCursorTimeoutException</classname> бросается, если опция <literal>"w"</literal> установлена в значение больше одного и операция заняла больше, чем <varname>MongoCursor::$timeout</varname> миллисекунд. При этом операция на сервере не прерывается, так как это ограничение времени работает на клиентской стороне. Операция в миллисекундах в <varname>MongoCollection::$wtimeout</varname>.</para>'>
<!ENTITY mongo.errors.deprecated '<para xmlns="http://docbook.org/ns/docbook">Вызывает ошибку уровня <constant>E_DEPRECATED</constant></para>'>
<!ENTITY mongo.gridfs.store.metadata.note '<note xmlns="http://docbook.org/ns/docbook"><para>Данные поля могут перезаписать поля, автоматически созданные драйвером, как указано в основной документации MongoDB  <link xlink:href="&url.mongodb.docs.gridfs;#the-files-collection" xmlns:xlink="http://www.w3.org/1999/xlink">коллекции файлов</link>. В качестве практического применения этого поведения можно указать свой <literal>chunkSize</literal> или <literal>_id</literal> для файла.</para></note>'>
<!ENTITY mongo.gridfs.store.return '<para xmlns="http://docbook.org/ns/docbook">Возвращает <literal>_id</literal> сохранённого документа. Это будет сгенерированный <classname>MongoId</classname>, за исключением случая, когда <literal>_id</literal> был явно указан в параметре <parameter>metadata</parameter>.</para>'>
<!ENTITY mongo.mongowritebatch.writeoptions.description '<listitem xmlns="http://docbook.org/ns/docbook"><para>Массив опций записи.<informaltable><thead><row><entry>ключ</entry><entry>значение</entry></row></thead><tbody><row><entry>w (int|string)</entry><entry>Значения <link linkend="mongo.writeconcerns">контроля записи</link></entry></row><row><entry>wtimeout (int)</entry><entry><link linkend="mongo.writeconcerns">Максимальное время ожидания репликации</link></entry></row><row><entry>ordered</entry><entry>Определяет, должна ли MongoDB применять этот пакет в определённом по порядку. Упорядоченная запись запускается последовательно (по одному элементу за раз) и запись прекращается после первой же ошибки. Неупорядоченная запись может запускаться параллельно и ошибки не приводят к остановке записи. По умолчанию &true;</entry></row><row><entry>j (bool)</entry><entry>Ожидать журналирование на основном сервере (primary). Не рекомендуется, используйте вместо него опцию Контроля Записи (WriteConcern)</entry></row><row><entry>fsync (bool)</entry><entry>Ожидать  fsync на основном сервере (primary). Не рекомендуется, используйте вместо него опцию Контроля Записи (WriteConcern)</entry></row></tbody></informaltable></para></listitem>'>
<!ENTITY mongo.mongowritebatch.collection.description '<listitem xmlns="http://docbook.org/ns/docbook"><para>Объект <classname>MongoCollection</classname> для выполняемого пакета. Его опции <link linkend="mongo.writeconcerns">контроля записи</link> будут скопированы и использованы по умолчанию, если не будут переданы через <parameter>$write_options</parameter> или <methodname>MongoWriteBatch::execute</methodname>.</para></listitem>'>
<!ENTITY mongo.context.server ' <varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>server</parameter> </term> <listitem> <para> Массив, содержащий основную информацию о выбранном сервере. <informaltable> <tgroup cols="2"> <thead> <row> <entry>ключ</entry> <entry>значение</entry> </row> </thead> <tbody> <row> <entry>hash</entry> <entry>хеш сервера, например: <literal>localhost:27017;-;X;56052</literal></entry> </row> <row> <entry>type</entry> <entry>Тип узла (primary/secondary/mongos/arbiter): <literal>2</literal></entry> </row> <row> <entry>max_bson_size</entry> <entry>максимальный размер  BSON, который этот узел поддерживает: <literal>16777216</literal></entry> </row> <row> <entry>max_message_size</entry> <entry>Максимальный размер сообщения, который этот узел поддерживает: <literal>48000000</literal></entry> </row> <row> <entry>request_id</entry> <entry>Идентификатор запроса для этого сообщения: <literal>42</literal></entry> </row> </tbody> </tgroup> </informaltable> </para> </listitem> </varlistentry>'>
<!ENTITY mongo.context.writeoptions '<varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>writeOptions</parameter> </term> <listitem> <para> <informaltable> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>ordered</entry> <entry>логическое значение, если операция (в случае пакетных операций) должна выполняться последовательно (ordered=true)</entry> </row> <row> <entry>writeConcern</entry> <entry>Массив опций контроля записи (writeConcern, смотри ниже)</entry> </row> </tbody> </tgroup> </informaltable> <table> <title>значения массива writeConcern</title> <tgroup cols="2"> <thead> <row> <entry>ключ</entry> <entry>значение</entry> </row> </thead> <tbody> <row> <entry>fsync</entry> <entry>булево, сбрасывать на диск перед запуском</entry> </row> <row> <entry>j</entry> <entry>булево, записывать в журнал перед запуском</entry> </row> <row> <entry>wtimeout</entry> <entry>целое число, миллисекунды, максимальное время, которое основной сервер (primary) ждёт подтверждение репликации</entry> </row> <row> <entry>w</entry> <entry>integer=число серверов, или string=тег-репликации</entry> </row> </tbody> </tgroup> </table> </para> </listitem> </varlistentry>'>
<!ENTITY mongo.context.protocoloptions ' <varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>protocolOptions</parameter> </term> <listitem> <para> <informaltable> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>message_length</entry> <entry>Общий размер в байтах закодированного сообщения, отправляемого по сети</entry> </row> <row> <entry>request_id</entry> <entry>Идентификатор  для сообщения: <literal>42</literal></entry> </row> <row> <entry>namespace</entry> <entry>Пространство имён MongoDB , используемого для сообщений протокола <literal>dbname.collectionname</literal></entry> </row> </tbody> </tgroup> </informaltable> </para> </listitem> </varlistentry>'>
<!ENTITY mongo.alternative.class.note '<para
xmlns="http://docbook.org/ns/docbook">Модуль, определяющий этот класс, объявлен устаревшим. Вместо него используйте модуль <link linkend="set.mongodb">MongoDB</link>.
Есть такие альтернативы:</para>'>
<!ENTITY mongo.noalternative.class.note '<para
xmlns="http://docbook.org/ns/docbook">Модуль, определяющий этот класс, объявлен устаревшим. Вместо него используйте модуль <link linkend="set.mongodb">MongoDB</link>.
Замены этому классу нет.</para>'>
<!ENTITY mongo.alternative.method.note '<para
xmlns="http://docbook.org/ns/docbook">Модуль, определяющий этот метод, объявлен устаревшим. Вместо него используйте модуль <link linkend="set.mongodb">MongoDB</link>.
Есть такие альтернативы:</para>'>
<!ENTITY mongo.noalternative.method.note '<para
xmlns="http://docbook.org/ns/docbook">Модуль, определяющий этот метод, объявлен устаревшим. Вместо него используйте модуль <link linkend="set.mongodb">MongoDB</link>.
Замены этому методу нет.</para>'>
<!ENTITY mongo.alternative.phplib.note '<para
xmlns="http://docbook.org/ns/docbook">Модуль, определяющий этот метод, объявлен устаревшим. Вместо него используйте модуль <link linkend="set.mongodb">MongoDB</link>.
Замены этому методу нет, но можно использовать функции из <link linkend="mongodb.overview">библиотеки PHP</link>:</para>'>

<!ENTITY mongo.deprecated.note '<para
xmlns="http://docbook.org/ns/docbook">Этот модуль объявлен устаревшим. Вместо него используйте модуль <link linkend="set.mongodb">MongoDB</link>.</para>'>

<!-- mongodb -->
<!ENTITY mongodb.changelog.tentative-return-types '
 <row xmlns="http://docbook.org/ns/docbook">
  <entry>PECL mongodb 1.15.0</entry>
  <entry>
   Типы возвращаемых значений для методов объявлены как предварительные в PHP 8.0 и новее,
   что вызывает уведомления об устаревании в коде, который реализует этот интерфейс
   без объявления соответствующих типов возвращаемых значений.
   Атрибут <code>#[ReturnTypeWillChange]</code> добавляют,
   чтобы заглушить уведомление об устаревании.
  </entry>
 </row>
'>

<!ENTITY mongodb.option.collation '
<row xmlns="http://docbook.org/ns/docbook">
 <entry>collation</entry>
 <entry><type class="union"><type>array</type><type>object</type></type></entry>
 <entry>
  <para>
   <link xlink:href="&url.mongodb.docs.collation;"
   xmlns:xlink="http://www.w3.org/1999/xlink">Сопоставление</link>
   позволяет пользователям указывать специфичные для конкретного языка правила
   для сравнения строк, такие как реакцию на регистр букв и надстрочные знаки.
   Если задали сопоставление, то поле <literal>"locale"</literal> также обязательно.
   Описание полей смотрите в разделе
   <link xlink:href="&url.mongodb.docs.collation;#collation-document"
   xmlns:xlink="http://www.w3.org/1999/xlink">Сопоставление</link>.
  </para>
  <para>
   Если сопоставление не задали явно, но у коллекции определили сопоставление по умолчанию,
   то будет выбрано оно. Если нет ни того ни того, то MongoDB будет использовать простое бинарное сравнение строк.
  </para>
  <para>
   Эта опция доступна в MongoDB 3.4+ и, если будет использована для более старых версий, вызовет исключение во время исполнения.
  </para>
 </entry>
</row>
'>
<!ENTITY mongodb.option.let '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>let</entry>
          <entry><type class="union"><type>array</type><type>object</type></type></entry>
          <entry>
           <para>
            Карта имён и значений параметров. Значения должны быть константами или закрытыми выражениями, которые не ссылаются на поля документа. К параметрам можно обращаться как к переменным в контексте агрегированного выражения (например, <literal>$$var</literal>).
           </para>
           <para>
            Опция доступна в MongoDB 5.0+ и приведёт к исключению во время выполнения, если указана для более старой версии сервера.
           </para>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.encryption.keyVaultClient '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>keyVaultClient</entry>
          <entry><classname>MongoDB\Driver\Manager</classname></entry>
          <entry>Менеджер маршрутизации запросов ключей данных в отдельный кластер MongoDB. По умолчанию метод выбирает текущий менеджер и кластер.</entry>
         </row>
'>
<!ENTITY mongodb.option.encryption.keyVaultNamespace '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>keyVaultNamespace</entry>
          <entry><type>string</type></entry>
          <entry>Полное пространство имён (например, <literal>"databaseName.collectionName"</literal>), обозначающее коллекцию, которая содержит все ключи данных, используемые для шифрования и дешифрования. Обязательный параметр.</entry>
         </row>
'>
<!ENTITY mongodb.option.encryption.kmsProviders '
         <row xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
          <entry>kmsProviders</entry>
          <entry><type>array</type></entry>
          <entry>
           <para>
            Документ, содержащий конфигурацию для одного или нескольких провайдеров KMS, которые используются для шифрования ключей данных.
            Поддерживаются провайдеры <literal>"aws"</literal>, <literal>"azure"</literal>, <literal>"gcp"</literal> и <literal>"local"</literal>, и, по крайней мере, один из них должен быть указан.
           </para>
           <para>
            Если для <literal>"aws"</literal>, <literal>"azure"</literal> или <literal>"gcp"</literal> указан пустой документ,
            драйвер попытается сконфигурировать провайдера, используя
            <link xlink:href="&url.mongodb.specs;/blob/master/source/client-side-encryption/client-side-encryption.rst#automatic-credentials">Автоматические учётные данные</link>.
           </para>
           <para>
            Формат для <literal>"aws"</literal> выглядит следующим образом:
           </para>
           <programlisting role="javascript">
<![CDATA[
aws: {
    accessKeyId: <string>,
    secretAccessKey: <string>,
    sessionToken: <optional string>
}
]]>
           </programlisting>
           <para>
            Формат для <literal>"azure"</literal> выглядит следующим образом:
           </para>
           <programlisting role="javascript">
<![CDATA[
azure: {
    tenantId: <string>,
    clientId: <string>,
    clientSecret: <string>,
    identityPlatformEndpoint: <optional string> // По умолчанию "login.microsoftonline.com"

}
]]>
           </programlisting>
           <para>
            Формат для <literal>"gcp"</literal> выглядит следующим образом:
           </para>
           <programlisting role="javascript">
<![CDATA[
gcp: {
    email: <string>,
    privateKey: <base64 string>|<MongoDB\BSON\Binary>,
    endpoint: <optional string> // По умолчанию "oauth2.googleapis.com"

}
]]>
           </programlisting>
           <para>
            Формат для <literal>"kmip"</literal> выглядит следующим образом:
           </para>
           <programlisting role="javascript">
<![CDATA[
kmip: {
    endpoint: <string>
}
]]>
           </programlisting>
           <para>
            Формат для <literal>"local"</literal> выглядит следующим образом:
           </para>
           <programlisting role="javascript">
<![CDATA[
local: {
    // 96-байтовый главный ключ, используемый для шифрования/дешифрования ключей данных
    key: <base64 string>|<MongoDB\BSON\Binary>
}
]]>
           </programlisting>
          </entry>
         </row>
'>

<!ENTITY mongodb.option.encryption.masterKey-options-by-provider '
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title>Параметры провайдера <literal>"aws"</literal></title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Параметр</entry>
       <entry>Тип</entry>
       <entry>Описание</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>region</entry>
       <entry>Строка</entry>
       <entry>Обязательный.</entry>
      </row>
      <row>
       <entry>key</entry>
       <entry>Строка</entry>
       <entry>Обязательный. Имя ресурса Amazon (ARN) для главного ключа клиента AWS (CMK).</entry>
      </row>
      <row>
       <entry>endpoint</entry>
       <entry>Строка</entry>
       <entry>Необязательный. Альтернативный идентификатор хоста для отправки запросов KMS. Может содержать номер порта.</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title>Параметры провайдера <literal>"azure"</literal></title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Параметр</entry>
       <entry>Тип</entry>
       <entry>Описание</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>keyVaultEndpoint</entry>
       <entry>Строка</entry>
       <entry>Обязательный. Хост с необязательным портом (например, "example.vault.azure.net").</entry>
      </row>
      <row>
       <entry>keyName</entry>
       <entry>Строка</entry>
       <entry>Обязательный.</entry>
      </row>
      <row>
       <entry>keyVersion</entry>
       <entry>Строка</entry>
       <entry>Необязательный. Определённая версия именованного ключа. По умолчанию — первичная версия ключа.</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title>Параметры провайдера <literal>"gcp"</literal></title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Параметр</entry>
       <entry>Тип</entry>
       <entry>Описание</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>projectId</entry>
       <entry>Строка</entry>
       <entry>Обязательный.</entry>
      </row>
      <row>
       <entry>location</entry>
       <entry>Строка</entry>
       <entry>Обязательный.</entry>
      </row>
      <row>
       <entry>keyRing</entry>
       <entry>Строка</entry>
       <entry>Обязательный.</entry>
      </row>
      <row>
       <entry>keyName</entry>
       <entry>Строка</entry>
       <entry>Обязательный.</entry>
      </row>
      <row>
       <entry>keyVersion</entry>
       <entry>Строка</entry>
       <entry>Необязательный. Определённая версия именованного ключа. По умолчанию — первичная версия ключа.</entry>
      </row>
      <row>
       <entry>endpoint</entry>
       <entry>Строка</entry>
       <entry>Необязательный. Хост с дополнительным портом. По умолчанию "cloudkms.googleapis.com"..</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title>Параметры провайдера <literal>"kmip"</literal></title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Параметр</entry>
       <entry>Тип</entry>
       <entry>Описание</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>keyId</entry>
       <entry>Строка</entry>
       <entry>Необязательный. Уникальный идентификатор 96-байтового управляемого объекта секретных данных KMIP. Если не указан, драйвер создаёт случайный 96-байтовый управляемый объект секретных данных KMIP.</entry>
      </row>
      <row>
       <entry>endpoint</entry>
       <entry>Строка</entry>
       <entry>Необязательный. Хост с дополнительным портом.</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
'>

<!ENTITY mongodb.option.encryption.tlsOptions '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>tlsOptions</entry>
          <entry><type>array</type></entry>
          <entry>
           <para>
            Документ, содержащий конфигурацию TLS для одного или нескольких KMS провайдеров. Поддерживаются провайдеры <literal>"aws"</literal>, <literal>"azure"</literal>, <literal>"gcp"</literal> и <literal>"kmip"</literal>. Все провайдеры поддерживают следующие опции:
           </para>
           <programlisting role="javascript">
<![CDATA[
<provider>: {
    tlsCaFile: <optional string>,
    tlsCertificateKeyFile: <optional string>,
    tlsCertificateKeyFilePassword: <optional string>,
    tlsDisableOCSPEndpointCheck: <optional bool>
}
]]>
           </programlisting>
          </entry>
         </row>
'>

<!ENTITY mongodb.option.maxCommitTimeMS '
<row xmlns="http://docbook.org/ns/docbook">
 <entry>maxCommitTimeMS</entry>
 <entry>integer</entry>
 <entry>
  <para>
   Максимальный период времени в миллисекундах, в течение которого может
   выполняться одна команда <literal>commitTransaction</literal>.
  </para>
  <para>
   Если указано, <literal>maxCommitTimeMS</literal> должно быть 32-разрядным
   целым числом со знаком, большим или равным нулю.
  </para>
 </entry>
</row>
'>
<!ENTITY mongodb.option.readConcern '
<row xmlns="http://docbook.org/ns/docbook">
 <entry>readConcern</entry>
 <entry><classname>MongoDB\Driver\ReadConcern</classname></entry>
 <entry>
  <para>
   Гарантия чтения для применения к операции.
  </para>
  <para>
   Эта опция доступна в MongoDB 3.2+ и приведёт
   к исключению во время выполнения, если указана для
   более старой версии сервера.
  </para>
 </entry>
</row>
'>
<!ENTITY mongodb.option.readPreference '
<row xmlns="http://docbook.org/ns/docbook">
 <entry>readPreference</entry>
 <entry><classname>MongoDB\Driver\ReadPreference</classname></entry>
 <entry>
  <para>
   Предпочтение чтения, используемая для выбора сервера для выполнения операции.
  </para>
 </entry>
</row>
'>
<!ENTITY mongodb.option.session '
<row xmlns="http://docbook.org/ns/docbook">
 <entry>session</entry>
 <entry><classname>MongoDB\Driver\Session</classname></entry>
 <entry>
  <para>
   Сессия для связывания с операцией.
  </para>
 </entry>
</row>
'>
<!ENTITY mongodb.option.transactionReadWriteConcern '
<warning xmlns="http://docbook.org/ns/docbook">
 <para>
  При использовании <literal>"session"</literal> и наличии незавершённых
  транзакций, вы не можете указать <literal>"readConcern"</literal> or
  <literal>"writeConcern"</literal> option. Это приведёт к выбрасыванию
  исключения <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname>.
  Вместо этого вы должны установить эти две опции при создании транзакции с помощью
  <methodname>MongoDB\Driver\Session::startTransaction</methodname>.
 </para>
</warning>
'>
<!ENTITY mongodb.option.writeConcern '
<row xmlns="http://docbook.org/ns/docbook">
 <entry>writeConcern</entry>
 <entry><classname>MongoDB\Driver\WriteConcern</classname></entry>
 <entry>
  <para>
   Гарантия записи для применения к операции.
  </para>
 </entry>
</row>
'>
<!ENTITY mongodb.parameter.namespace '
<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>namespace</parameter> (<type>string</type>)</term>
 <listitem>
  <para>
   Полностью определённое имя (т.е. <literal>"databaseName.collectionName"</literal>).
  </para>
 </listitem>
</varlistentry>
'>
<!ENTITY mongodb.parameter.db '
<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>db</parameter> (<type>string</type>)</term>
 <listitem>
  <para>
   Имя базы данных, в которой запускается команда.
  </para>
 </listitem>
</varlistentry>
'>
<!ENTITY mongodb.parameter.bulkwrite '
<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>bulk</parameter> (<classname>MongoDB\Driver\BulkWrite</classname>)</term>
 <listitem>
  <para>
   Записи для выполнения.
  </para>
 </listitem>
</varlistentry>
'>
<!ENTITY mongodb.parameter.command '
<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>command</parameter> (<classname>MongoDB\Driver\Command</classname>)</term>
 <listitem>
  <para>
   Команда для выполнения.
  </para>
 </listitem>
</varlistentry>
'>
 <!ENTITY mongodb.parameter.encryptOpts '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>options</parameter></term>
    <listitem>
     <para>
      <table>
       <title>Encryption options</title>
       <tgroup cols="3">
        <thead>
         <row>
          <entry>Опция</entry>
          <entry>Тип</entry>
          <entry>Описание</entry>
         </row>
        </thead>
        <tbody>
         <row>
          <entry>algorithm</entry>
          <entry><type>string</type></entry>
          <entry>
           <para>
            Алгоритм шифрования, который будет использоваться. Опция является обязательной.
            Укажите одну из следующих
            <link linkend="mongodb-driver-clientencryption.constants">констант ClientEncryption</link>:
           </para>
           <simplelist>
            <member><constant>MongoDB\Driver\ClientEncryption::AEAD_AES_256_CBC_HMAC_SHA_512_DETERMINISTIC</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::AEAD_AES_256_CBC_HMAC_SHA_512_RANDOM</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::ALGORITHM_UNINDEXED</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE_PREVIEW</constant></member>
           </simplelist>
          </entry>
         </row>
         <row>
          <entry>contentionFactor</entry>
          <entry><type>int</type></entry>
          <entry>
           <para>
            Коэффициент сдерживания при оценке запросов с индексированными,
            зашифрованными полезными нагрузками.
           </para>
           <para>
            Опция применяется и может быть указана только тогда, когда
            опция <literal>algorithm</literal> равна
            <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED</constant>
            или
            <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE_PREVIEW</constant>.
           </para>
          </entry>
         </row>
         <row>
          <entry>keyAltName</entry>
          <entry><type>string</type></entry>
          <entry>
           <para>
            Идентифицирует документ коллекции хранилища ключей по <literal>keyAltName</literal>.
            Опция является взаимоисключающей с <literal>keyId</literal> и требуется ровно один.
           </para>
          </entry>
         </row>
         <row>
          <entry>keyId</entry>
          <entry><classname>MongoDB\BSON\Binary</classname></entry>
          <entry>
           <para>
            Идентифицирует ключ данных по <literal>_id</literal>. Значением является UUID
            (двоичный подтип 4). Опция является взаимоисключающей с <literal>keyAltName</literal>
            и требуется ровно один.
           </para>
          </entry>
         </row>
         <row>
          <entry>queryType</entry>
          <entry><type>string</type></entry>
          <entry>
           <para>
            Тип запроса для оценки запросов с индексированными, зашифрованными
            полезными нагрузками. Укажите одну из следующих
            <link linkend="mongodb-driver-clientencryption.constants">констант ClientEncryption</link>:
           </para>
           <simplelist>
            <member><constant>MongoDB\Driver\ClientEncryption::QUERY_TYPE_EQUALITY</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::QUERY_TYPE_RANGE_PREVIEW</constant></member>
           </simplelist>
           <para>
            Опция применяется и может быть указана только тогда, когда
            опция <literal>algorithm</literal> равна
            <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED</constant>
            или <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE_PREVIEW</constant>.
           </para>
          </entry>
         </row>
         <row>
          <entry>rangeOpts</entry>
          <entry><type>array</type></entry>
          <entry>
           <para>
            Опции индекса для шифруемого поля с поддержкой запросов "rangePreview".
            Приведённые ниже параметры должны соответствовать значениям, установленным
            в <literal>encryptedFields</literal> целевой коллекции.
            Для полей типа double и decimal128 BSON, <literal>min</literal>, <literal>max</literal>
            и <literal>precision</literal> должны быть либо все установлены, либо все должны отсутствовать.
           </para>
           <para>
            <table>
             <title>Опции индекса диапазона</title>
             <tgroup cols="3">
              <thead>
               <row>
                <entry>Опция</entry>
                <entry>Тип</entry>
                <entry>Описание</entry>
               </row>
              </thead>
              <tbody>
               <row>
                <entry>min</entry>
                <entry><type>mixed</type></entry>
                <entry>Обязательное, если установлено значение <literal>precision</literal>.</entry>
               </row>
               <row>
                <entry>max</entry>
                <entry><type>mixed</type></entry>
                <entry>Обязательное, если установлено значение <literal>precision</literal>.</entry>
               </row>
               <row>
                <entry>sparsity</entry>
                <entry><type>int</type></entry>
                <entry>Обязательное.</entry>
               </row>
               <row>
                <entry>precision</entry>
                <entry><type>int</type></entry>
                <entry>Необязательное. Может быть установлено только для типов полей BSON double или decimal128.</entry>
               </row>
              </tbody>
             </tgroup>
            </table>
           </para>
          </entry>
         </row>
        </tbody>
       </tgroup>
      </table>
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.query '
<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>query</parameter> (<classname>MongoDB\Driver\Query</classname>)</term>
 <listitem>
  <para>
   Запрос для выполнения.
  </para>
 </listitem>
</varlistentry>
'>
<!ENTITY mongodb.parameter.typeMap '
<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>typeMap</parameter> (<type>array</type>)</term>
 <listitem>
  <para>
   <link linkend="mongodb.persistence.typemaps">Конфигурация карты типов</link>.
  </para>
 </listitem>
</varlistentry>
'>
<!ENTITY mongodb.parameter.filter '
<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>filter</parameter> (<type class="union"><type>array</type><type>object</type></type>)</term>
 <listitem>
  <para>
   <link xlink:href="&url.mongodb.docs;tutorial/query-documents/" xmlns:xlink="http://www.w3.org/1999/xlink">Предикат запроса</link>.
   Пустой предикат совпадёт со всеми элементами коллекции.
  </para>
  <note>
   <simpara>
    При вычислении критериев запроса MongoDB сравнивает типы и значения в соответствии с собственными <link xlink:href="&url.mongodb.docs;reference/bson-type-comparison-order/" xmlns:xlink="http://www.w3.org/1999/xlink">правилами сравнения типов BSON</link>, отличных от правил <link linkend="types.comparisons">сравнения</link> и <link linkend="language.types.type-juggling">приведения типов</link> PHP. Когда указан специальный тип BSON, критерия запроса должна соответствовать <link linkend="book.bson">классу BSON</link> (т.е. использовать <classname>MongoDB\BSON\ObjectId</classname> для выборке по <link xlink:href="&url.mongodb.docs.objectid;" xmlns:xlink="http://www.w3.org/1999/xlink">ObjectId</link>).
   </simpara>
  </note>
 </listitem>
</varlistentry>
'>
<!ENTITY mongodb.returns.cursor '<para xmlns="http://docbook.org/ns/docbook">В случае успешного выполнения возвращает <classname>MongoDB\Driver\Cursor</classname>.</para>'>
<!ENTITY mongodb.returns.writeresult '<para xmlns="http://docbook.org/ns/docbook">В случае успешного выполнения возвращает <classname>MongoDB\Driver\WriteResult</classname>.</para>'>
<!ENTITY mongodb.throws.std '&mongodb.throws.argumentparsing;&mongodb.throws.connection;&mongodb.throws.authentication;'>
<!ENTITY mongodb.throws.session-readwriteconcern '<member xmlns="http://docbook.org/ns/docbook">Выбрасывается исключение <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname>, если опция <literal>"session"</literal> указана с соответствующей транзакцией в сочетании с опцией <literal>"readConcern"</literal> или <literal>"writeConcern"</literal>.</member>'>
<!ENTITY mongodb.throws.session-unacknowledged '<member xmlns="http://docbook.org/ns/docbook">Выбрасывается <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname>, если опция <literal>"session"</literal> указана в сочетании с неподтверждённой гарантией записи.</member>'>
<!ENTITY mongodb.throws.bulkwriteexception '<member xmlns="http://docbook.org/ns/docbook">При ошибке записи бросает исключение  <classname>MongoDB\Driver\Exception\BulkWriteException</classname>.</member>'>
<!ENTITY mongodb.throws.argumentparsing '<member xmlns="http://docbook.org/ns/docbook">При ошибке парсинга аргумента бросает исключение  <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname>.</member>'>
<!ENTITY mongodb.throws.authentication '<member xmlns="http://docbook.org/ns/docbook">При неудачной аутентификации бросает исключение  <classname>MongoDB\Driver\Exception\AuthenticationException</classname>.</member>'>
<!ENTITY mongodb.throws.connection '<member xmlns="http://docbook.org/ns/docbook">При неудачном соединении с сервером (кроме ошибок аутентификации), бросает исключение <classname>MongoDB\Driver\Exception\ConnectionException</classname>.</member>'>
<!ENTITY mongodb.throws.bson.unexpected '<member xmlns="http://docbook.org/ns/docbook">Исключение <classname>MongoDB\Driver\Exception\UnexpectedValueException</classname> выбрасывается, если входные данные не являются ровно одним документом BSON. Возможные причины включают, но не ограничены некорректным BSON, лишними данными или неожиданной ошибкой <link xlink:href="&url.mongodb.libbson;" xmlns:xlink="http://www.w3.org/1999/xlink">libbson</link>.</member>'>

<!-- Больше не используется -->
<!ENTITY mongodb.note.queryable-encryption-preview ''>

<!ENTITY mongodb.note.decimal128 '
<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  <classname>MongoDB\BSON\Decimal128</classname> совместим только с
  MongoDB 3.4+. При попытке использовать тип BSON с более ранними версиями приведёт
  к ошибке.
 </simpara>
</note>
'>
<!ENTITY mongodb.note.extended-json '
<note xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <simpara>
  Вывод соответствует выводу функции <function>MongoDB\BSON\toJSON</function>,
  которая использует унаследованный, специфичный для драйвера, расширенный
  формат JSON. Он не обязательно будет подходить под
  <link xlink:href="&url.mongodb.specs.extendedjson;#relaxed-extended-json-example">relaxed</link>
  или <link xlink:href="&url.mongodb.specs.extendedjson;#canonical-extended-json-example">canonical</link>
  представления расширенного JSON, используемых в
  <function>MongoDB\BSON\toRelaxedExtendedJSON</function> и
  <function>MongoDB\BSON\toCanonicalExtendedJSON</function>, соответственно.
 </simpara>
</note>
'>
<!ENTITY mongodb.note.forking '
<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  На Unix, драйвер MongoDB чувствителен к сценариям, которые используют
  системный вызов fork() без последующего exec(). Пользователям не рекомендуется
  переиспользовать экземпляр класса <classname>MongoDB\Driver\Manager</classname>
  в дочернем процессе.
  child process.
 </simpara>
</note>
'>

<!ENTITY mongodb.note.uint32 '
<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Так как целочисленный тип в PHP является знаковым, некоторые значения, полученные с помощью этого метода, могут превратиться в отрицательные целые числа на 32-битных платформах. Для получения строкового представления беззнакового целого можно воспользоваться шаблоном форматирования "&#37;u" функции <function>sprintf</function>.
 </simpara>
</note>
'>

<!ENTITY mongodb.note.server.readpreference '
<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Опция <literal>"readPreference"</literal> не контролирует сервер, к которому
  драйвер выполняет операцию; она всегда будет выполняться на этом объекте сервера.
  Вместо этого, он может быть использован при выполнении операции на втором узле
  (из набора реплик, не автономный) или на узле mongos для обеспечения того, что драйвер
  устанавливает проводной протокол соответствующим образом или добавляет предпочтение чтения
  к операции, соответственно.
 </simpara>
</note>
'>

<!ENTITY mongodb.note.server.write '
<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Ответственность вызывающего кода заключается в том, что сервер в состоянии
  выполнять операцию записи. Например, выполнение операции записи на вторичном узле
  (исключая «локальную» базу данных) завершится неудачей.
 </simpara>
</note>
'>

 <!ENTITY mongodb.warning.duplicate-keys '
   <warning xmlns="http://docbook.org/ns/docbook">
    <simpara>
      Документы BSON технически могут содержать повторяющиеся ключи, поскольку документы хранятся в виде списка пар ключ-значение;
      однако приложениям следует воздерживаться от создания документов с дубликатами ключей,
      поскольку поведение сервера и драйвера может быть неопределённым.
      Поскольку объекты и массивы PHP не могут иметь повторяющихся ключей,
      данные также могут быть потеряны при декодировании документа BSON с повторяющимися ключами.
    </simpara>
   </warning>
'>

<!-- Radius -->
<!ENTITY radius.request.required '<note xmlns="http://docbook.org/ns/docbook"><para>Перед вызовом этой функции необходимо создать запрос с помощью функции <function>radius_create_request</function>.</para></note>'>
<!ENTITY radius.parameter.attribute-type '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>type</parameter></term><listitem><para>Тип атрибута.</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.handle '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>radius_handle</parameter></term><listitem><para>Ресурс RADIUS.</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.options '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>options</parameter></term><listitem><para>Битовая маска опций атрибута. В качестве значений можно использовать <link linkend="constant.radius-option-tagged"><constant>RADIUS_OPTION_TAGGED</constant></link> и <link linkend="constant.radius-option-salt"><constant>RADIUS_OPTION_SALT</constant></link>.</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.tag '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>tag</parameter></term><listitem><para>Тег атрибута. Этот параметр будет проигнорирован, если не установлена опция <link linkend="constant.radius-option-tagged"><constant>RADIUS_OPTION_TAGGED</constant></link>.</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.vendor '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>vendor</parameter></term><listitem><para>ID производителя (vendor).</para></listitem></varlistentry>'>

<!-- posix snippets -->
<!ENTITY posix.parameter.fd '<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>file_descriptor</parameter></term>
<listitem>
 <para>
  Файловый дескриптор, который ожидается в виде или ресурса <type>resource</type>
  или целого числа <type>int</type>. Под <type>int</type> подразумевается
  файловый дескриптор, который можно передать непосредственно в базовый системный вызов.
 </para>
</listitem>
</varlistentry>'>

<!ENTITY posix.rlimits '
<para xmlns="http://docbook.org/ns/docbook">
 С каждым ресурсом ассоциированы свои мягкие и жёсткие ограничения.
 Мягкие ограничения — это величина, которую ядро обещает обеспечить
 ресурсу. Жёсткие ограничения — это величина, которая характеризует потолок
 мягких ресурсов. Непривилегированный процесс умеет управлять только своими
 мягкими ограничениями, выставляя их от 0 до величины жёсткого ограничения.
</para>
'>

<!-- strings snippets -->
<!ENTITY strings.parameter.encoding '
<para xmlns="http://docbook.org/ns/docbook">
 Необязательный аргумент, который определяет кодировку
 для преобразования символов.
</para>

<para xmlns="http://docbook.org/ns/docbook">
 Функция примет за значение по умолчанию для параметра <parameter>encoding</parameter>
 значение опции конфигурации <link linkend="ini.default-charset">default_charset</link>,
 если параметр опустили.
</para>

<para xmlns="http://docbook.org/ns/docbook">
 Хотя технически этот аргумент необязателен, настоятельно рекомендуется
 указать правильное значение для кода, на случай если значение
 опции <link linkend="ini.default-charset">default_charset</link>
 окажется неправильным для входных данных.
</para>
'>

<!ENTITY strings.parameter.format '
<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>format</parameter></term>
 <listitem>
  <para>
   Строка формата состоит из нуля или более директив:
   обычные символы (за исключением <literal>&#37;</literal>), которые
   просто выводятся без изменения,
   и <emphasis>спецификаторы преобразования</emphasis>, каждый из которых
   требует передачи своего параметра.
  </para>

  <para>
   Спецификаторы преобразования имеют следующий формат:
   <literal>&#37;[argnum$][flags][width][.precision]specifier</literal>.
  </para>

  <formalpara>
   <title>Argnum</title>
   <para>
    Целое число, за которым следует знак доллара <literal>$</literal>,
    чтобы указать, какой числовой аргумент обрабатывать при преобразовании.
   </para>
  </formalpara>

  <para>
   <table>
    <title>Флаги</title>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>Флаг</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry><literal>-</literal></entry>
       <entry>
        Выравнивание по левому краю в пределах заданной ширины поля;
        По умолчанию выравнивание происходит по правому краю.
       </entry>
      </row>
      <row>
       <entry><literal>+</literal></entry>
       <entry>
        Печатает плюс <literal>+</literal> у не отрицательных чисел;
        По умолчанию знак печатается только у отрицательных чисел.
       </entry>
      </row>
      <row>
       <entry><literal> </literal>(space)</entry>
       <entry>
        Дополняет результат пробелами.
        Это поведение по умолчанию.
       </entry>
      </row>
      <row>
       <entry><literal>0</literal></entry>
       <entry>
        Дополняет числа нулями (только слева).
        Со спецификатором <literal>s</literal> также может
        дополнять нулями справа.
       </entry>
      </row>
      <row>
       <entry><literal>&apos;</literal>(char)</entry>
       <entry>
        Дополняет результат символом (char).
       </entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>

  <formalpara>
   <title>Ширина</title>
   <para>
    Либо целое число, указывающее, сколько символов (минимум) должно получиться в результате преобразования,
    либо <literal>*</literal>.
    Если указано значение <literal>*</literal>, то ширина задаётся как дополнительное целое значение,
    предшествующее значению, отформатированному спецификатором.
   </para>
  </formalpara>

  <formalpara>
   <title>Точность</title>
   <para>
    Точка <literal>.</literal>, с последующим целым числом,
    либо <literal>*</literal>, значение которого зависит от спецификатора:
    <itemizedlist>
     <listitem>
      <simpara>
       Для спецификаторов <literal>e</literal>, <literal>E</literal>,
       <literal>f</literal> и <literal>F</literal>:
       задаёт количество цифр после десятичной запятой (по умолчанию 6).
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       Для спецификаторов <literal>g</literal>,<literal>G</literal>,
       <literal>h</literal> и <literal>H</literal>:
       задаёт максимальное значение печатаемых значащих цифр.
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       Для спецификатора <literal>s</literal>: задаёт ограничение
       максимального количества символов в строке, которые будут выведены.
      </simpara>
     </listitem>
    </itemizedlist>
    <note>
     <simpara>
      Если указана точка без последующего значения точности, то
      точность будет считаться за 0.
      Если указано значение <literal>*</literal>, точность задаётся как дополнительное целое значение,
      предшествующее значению, отформатированному спецификатором.
     </simpara>
    </note>
   </para>
  </formalpara>

  <para>
   <table>
    <title>Спецификаторы</title>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>Спецификатор</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry><literal>&#37;</literal></entry>
       <entry>
        Символ процента. Аргументы не требуются.
       </entry>
      </row>
      <row>
       <entry><literal>b</literal></entry>
       <entry>
        Аргумент рассматривается как целое число и печатается
        в бинарном представлении.
       </entry>
      </row>
      <row>
       <entry><literal>c</literal></entry>
       <entry>
        Аргумент рассматривается как целое число и печатается
        как символ из таблицы ASCII с соответствующим кодом.
       </entry>
      </row>
      <row>
       <entry><literal>d</literal></entry>
       <entry>
        Аргумент рассматривается как целое число и печатается
        как целое число со знаком.
       </entry>
      </row>
      <row>
       <entry><literal>e</literal></entry>
       <entry>
        Аргумент считается за число в научной нотации (т.е. 1.2e+2).
       </entry>
      </row>
      <row>
       <entry><literal>E</literal></entry>
       <entry>
        Аналогично спецификатору <literal>e</literal>, но использует
        заглавные символы (т.е. 1.2E+2).
       </entry>
      </row>
      <row>
       <entry><literal>f</literal></entry>
       <entry>
        Аргумент считается за число с плавающей точкой
        (с учётом локали).
       </entry>
      </row>
      <row>
       <entry><literal>F</literal></entry>
       <entry>
        Аргумент считается за число с плавающей точкой
        (без учёта локали).
       </entry>
      </row>
      <row>
       <entry><literal>g</literal></entry>
       <entry>
        <para>
         Общий формат.
        </para>
        <para>
         Пусть P равно точности, если она не равно нулю, 6 — если точность не задана
         и 1, если точность задана как 0.
         Тогда, если преобразование со стилем "E" будет иметь показатель степени X:
        </para>
        <para>
         Если P > X ≥ −4, преобразование будет в стиле "f" и точность будет P − (X + 1).
         В обратном случае, преобразование будет в стиле "e" и точность будет P − 1.
        </para>
       </entry>
      </row>
      <row>
       <entry><literal>G</literal></entry>
       <entry>
        Аналогично спецификатору <literal>g</literal>, но использует
        <literal>E</literal> и <literal>f</literal>.
       </entry>
      </row>
      <row>
       <entry><literal>h</literal></entry>
       <entry>
        Аналогично спецификатору <literal>g</literal>, но использует
        <literal>F</literal>.
        Доступен с PHP 8.0.0.
       </entry>
      </row>
      <row>
       <entry><literal>H</literal></entry>
       <entry>
        Аналогично спецификатору <literal>g</literal>, но использует
        <literal>E</literal> и <literal>F</literal>.
        Доступен с PHP 8.0.0.
       </entry>
      </row>
      <row>
       <entry><literal>o</literal></entry>
       <entry>
        Аргумент рассматривается как целое число и печатается
        в восьмеричном представлении.
       </entry>
      </row>
      <row>
       <entry><literal>s</literal></entry>
       <entry>
        Аргумент рассматривается и печатается как строка.
       </entry>
      </row>
      <row>
       <entry><literal>u</literal></entry>
       <entry>
        Аргумент рассматривается как целое число и печатается
        как беззнаковое целое число.
       </entry>
      </row>
      <row>
       <entry><literal>x</literal></entry>
       <entry>
        Аргумент рассматривается как целое число и печатается в
        шестнадцатеричном представлении (буквы будут в нижнем регистре).
       </entry>
      </row>
      <row>
       <entry><literal>X</literal></entry>
       <entry>
        Аргумент рассматривается как целое число и печатается в
        шестнадцатеричном представлении (буквы будут в верхнем регистре).
       </entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>

  <warning>
   <para>
    Спецификатор <literal>c</literal> игнорирует значения ширины и дополнения
   </para>
  </warning>

  <warning>
   <para>
    Попытка использовать спецификаторы с указанием ширины для строки в
    многобайтовой кодировке может привести к неожиданным результатам.
   </para>
  </warning>

  <para>
   Переменные будут приведены к подходящему для спецификатора типу:
   <table>
    <title>Обработка типов</title>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>Тип</entry>
       <entry>Спецификатор</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry><type>string</type></entry>
       <entry><literal>s</literal></entry>
      </row>
      <row>
       <entry><type>int</type></entry>
       <entry>
        <literal>d</literal>,
        <literal>u</literal>,
        <literal>c</literal>,
        <literal>o</literal>,
        <literal>x</literal>,
        <literal>X</literal>,
        <literal>b</literal>
       </entry>
      </row>
      <row>
       <entry><type>float</type></entry>
       <entry>
        <literal>e</literal>,
        <literal>E</literal>,
        <literal>f</literal>,
        <literal>F</literal>,
        <literal>g</literal>,
        <literal>G</literal>,
        <literal>h</literal>,
        <literal>H</literal>
       </entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
 </listitem>
</varlistentry>
'>

<!ENTITY strings.scanf.parameter.format '
<varlistentry xmlns="http://docbook.org/ns/docbook">
  <term><parameter>format</parameter></term>
  <listitem>
   <para>
    Интерпретируемый формат для параметра <parameter>string</parameter>,
    который описан в документации функции <function>sprintf</function>
    со следующими отличиями:
    <simplelist>
     <member>
      Функция не ориентирована на локализацию.
     </member>
     <member>
      Не поддерживаются значения <literal>F</literal>, <literal>g</literal>, <literal>G</literal> и
      <literal>b</literal>.
     </member>
     <member>
      <literal>D</literal> обозначает десятичное число.
     </member>
     <member>
      <literal>i</literal> обозначает целое число с определением системы счисления.
     </member>
     <member>
      <literal>n</literal> обозначает количество символов, обработанных на текущий момент.
     </member>
     <member>
      <literal>s</literal> останавливает чтение на любом символе пробела.
     </member>
     <member>
      <literal>*</literal> вместо <literal>argnum$</literal> подавляет
      присвоение данной спецификации преобразования.
     </member>
    </simplelist>
   </para>
  </listitem>
 </varlistentry>
'>

<!ENTITY strings.parameter.needle.non-string '
<para xmlns="http://docbook.org/ns/docbook">
 До PHP 8.0.0, если параметр <parameter>needle</parameter> — не строка,
 он преобразовывается в целое число и трактуется как код символа.
 Это поведение устарело с PHP 7.3.0 и полагаться на него крайне не рекомендуется.
 В зависимости от предполагаемого поведения,
 параметр <parameter>needle</parameter> должен быть либо явно приведён к строке,
 либо должен быть выполнен явный вызов функции <function>chr</function>.
</para>
'>

<!ENTITY strings.changelog.needle-empty '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  Параметр <parameter>needle</parameter> теперь допускает пустую строку.
 </entry>
</row>'>

<!ENTITY strings.changelog.encoding '
<row xmlns="http://docbook.org/ns/docbook">
 <entry>5.6.0</entry>
 <entry>
  Значение по умолчанию для параметра <parameter>encoding</parameter> было изменено
  на значение конфигурационной опции <link linkend="ini.default-charset">default_charset</link>.
 </entry>
</row>
'>

<!ENTITY strings.changelog.ascii-case-conversion '
<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.2.0</entry>
 <entry>
  Преобразование регистра больше не зависит от локали, установленной с помощью
  функции <function>setlocale</function>. Будут преобразованы только символы ASCII.
 </entry>
</row>
'>

<!ENTITY strings.changelog.ascii-case-folding '
<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.2.0</entry>
 <entry>
  Преобразование регистра больше не зависит от локали, установленной с помощью
  функции <function>setlocale</function>. Будут преобразованы только символы ASCII.
  Байты не ASCII-кодировке будут сравниваться по значению байта.
 </entry>
</row>
'>

 <!ENTITY strings.changelog.sprintf '
  <informaltable xmlns="http://docbook.org/ns/docbook">
   <tgroup cols="2">
    <thead>
     <row>
      <entry>&Version;</entry>
      <entry>&Description;</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Функция больше не возвращает &false;, если возникла ошибка.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Выбрасывает исключение <classname>ValueError</classname>, если количество аргументов равно нулю;
       ранее функция выдавала ошибку уровня <constant>E_WARNING</constant>.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Выбрасывает исключение <classname>ValueError</classname>, если <literal>[width]</literal>
       меньше нуля или больше <constant>PHP_INT_MAX</constant>;
       ранее функция выдавала ошибку уровня <constant>E_WARNING</constant>.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Выбрасывает исключение <classname>ValueError</classname>, если <literal>[precision]</literal>
       меньше нуля или больше <constant>PHP_INT_MAX</constant>;
       ранее функция выдавала ошибку уровня <constant>E_WARNING</constant>.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Выбрасывает исключение <classname>ArgumentCountError</classname>, если аргументов задано меньше, чем требуется;
       ранее функция выдавала ошибку уровня <constant>E_WARNING</constant>.
      </entry>
     </row>
    </tbody>
   </tgroup>
  </informaltable>
'>

 <!ENTITY strings.changelog.vsprintf '
  <informaltable xmlns="http://docbook.org/ns/docbook">
   <tgroup cols="2">
    <thead>
     <row>
      <entry>&Version;</entry>
      <entry>&Description;</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Функция больше не возвращает &false;, если возникла ошибка.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Выбрасывает исключение <classname>ValueError</classname>, если количество аргументов равно нулю;
       ранее функция выдавала ошибку уровня <constant>E_WARNING</constant>.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Выбрасывает исключение <classname>ValueError</classname>, если <literal>[width]</literal>
       меньше нуля или больше <constant>PHP_INT_MAX</constant>;
       ранее функция выдавала ошибку уровня <constant>E_WARNING</constant>.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Выбрасывает исключение <classname>ValueError</classname>, если <literal>[precision]</literal>
       меньше нуля или больше <constant>PHP_INT_MAX</constant>;
       ранее функция выдавала ошибку уровня <constant>E_WARNING</constant>.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Выбрасывает исключение <classname>ArgumentCountError</classname>, если аргументов задано меньше, чем требуется;
       ранее функция выдавала ошибку уровня <constant>E_WARNING</constant>.
      </entry>
     </row>
    </tbody>
   </tgroup>
  </informaltable>
'>

 <!ENTITY strings.errors.sprintf '
  <para xmlns="http://docbook.org/ns/docbook">
   Начиная с PHP 8.0.0, если количество аргументов равно нулю, выбрасывается исключение <classname>ValueError</classname>.
   До PHP 8.0.0 вместо этого выдавалась ошибка уровня <constant>E_WARNING</constant>.
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   Начиная с PHP 8.0.0, если <literal>[width]</literal> меньше нуля или больше <constant>PHP_INT_MAX</constant>,
   выбрасывается исключение <classname>ValueError</classname>.
   До PHP 8.0.0 вместо этого выдавалась ошибка уровня <constant>E_WARNING</constant>.
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   Начиная с PHP 8.0.0, если <literal>[precision]</literal> меньше нуля или больше <constant>PHP_INT_MAX</constant>,
   выбрасывается исключение <classname>ValueError</classname>.
   До PHP 8.0.0 вместо этого выдавалась ошибка уровня <constant>E_WARNING</constant>.
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   Начиная с PHP 8.0.0, если аргументов задано меньше, чем требуется, выбрасывается исключение <classname>ArgumentCountError</classname>.
   До PHP 8.0.0 вместо этого выдавалась ошибка уровня <constant>E_WARNING</constant>.
  </para>
'>

 <!ENTITY strings.errors.vsprintf '
 <para xmlns="http://docbook.org/ns/docbook">
   Начиная с PHP 8.0.0, если количество аргументов равно нулю, выбрасывается исключение <classname>ValueError</classname>.
   До PHP 8.0.0 вместо этого выдавалась ошибка уровня <constant>E_WARNING</constant>.
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   Начиная с PHP 8.0.0, если <literal>[width]</literal> меньше нуля или больше <constant>PHP_INT_MAX</constant>,
   выбрасывается исключение <classname>ValueError</classname>.
   До PHP 8.0.0 вместо этого выдавалась ошибка уровня <constant>E_WARNING</constant>.
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   Начиная с PHP 8.0.0, если <literal>[precision]</literal> меньше нуля или больше <constant>PHP_INT_MAX</constant>,
   выбрасывается исключение <classname>ValueError</classname>.
   До PHP 8.0.0 вместо этого выдавалась ошибка уровня <constant>E_WARNING</constant>.
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   Начиная с PHP 8.0.0, если аргументов задано меньше, чем требуется, выбрасывается исключение <classname>ArgumentCountError</classname>.
   До PHP 8.0.0 вместо этого выдавалась ошибка уровня <constant>E_WARNING</constant>.
  </para>
'>

<!-- filter snippets -->
<!ENTITY filter.param.filter '
<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>filter</parameter></term>
 <listitem>
  <para>
   Идентификатор (ID) применяемого фильтра. На странице <xref linkend="filter.filters" />
   приведён список доступных фильтров.
  </para>
  <para>
   Если не указан, то принимает значение по умолчанию — <constant>FILTER_DEFAULT</constant>, который
   равнозначен значению константы <link linkend="filter.filters.sanitize"><constant>FILTER_UNSAFE_RAW</constant></link>.
   То есть по умолчанию значение не фильтруется.
  </para>
 </listitem>
</varlistentry>
'>

<!-- csprng snippets -->
<!ENTITY csprng.sources '
<para xmlns="http://docbook.org/ns/docbook">
 Источники случайных величин в порядке приоритета:
</para>
<itemizedlist xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <listitem>
  <para>
   Linux: <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   FreeBSD &gt;= 12 (PHP &gt;= 7.3): <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   Windows (PHP &gt;= 7.2): <link xlink:href="&url.csprng.cng-api;">CNG-API</link>
  </para>
  <para>
   Windows: <link xlink:href="&url.csprng.crypt-gen-random;">CryptGenRandom</link>
  </para>
 </listitem>
 <listitem>
  <para>
   macOS (PHP &gt;= 8.2; &gt;= 8.1.9; &gt;= 8.0.22, если CCRandomGenerateBytes доступен во время компиляции): CCRandomGenerateBytes()
  </para>
  <para>
   macOS (PHP &gt;= 8.1; &gt;= 8.0.2): arc4random_buf(), <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   NetBSD &gt;= 7 (PHP &gt;= 7.1; &gt;= 7.0.1): arc4random_buf(), <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   OpenBSD &gt;= 5.5 (PHP &gt;= 7.1; &gt;= 7.0.1): arc4random_buf(), <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   DragonflyBSD (PHP &gt;= 8.1): <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   Solaris (PHP &gt;= 8.1): <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <simpara>
   Любая комбинация операционной системы и версии PHP, не указанная ранее: <filename>/dev/urandom</filename>
  </simpara>
 </listitem>
 <listitem>
  <simpara>
   Если ни один из источников не доступен или все они не генерируют случайную величину,
   то будет выброшено исключение <classname>Random\RandomException</classname>.
  </simpara>
 </listitem>
</itemizedlist>
'>
<!ENTITY csprng.errors '
<listitem xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Если подходящие источники случайных величин отсутствуют, то выбрасывается исключение
  <classname>Random\RandomException</classname>.
 </simpara>
</listitem>
'>
<!ENTITY csprng.function.backport '
<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Эта функция была добавлена в PHP 7.0, а для версий с 5.2 по 5.6 включительно доступна
  <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.csprng.compat;">пользовательская реализация</link>.
 </simpara>
</note>
'>

<!-- Random snippets -->
<!ENTITY random.engineErrors '
<listitem xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Любые <classname>Throwable</classname>, выбрасываемые методом <methodname>Random\Engine::generate</methodname>
  базового <link linkend="random-randomizer.props.engine"><literal>Random\Randomizer::$engine</literal></link>.
 </simpara>
</listitem>
'>

<!-- UOPZ snippets -->

<!ENTITY uopz.warn.removed.function-5-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция была
<emphasis>УДАЛЕНА</emphasis> в PECL uopz 5.0.0.</simpara></warning>'>

<!-- XML snippets -->

<!ENTITY xml.parser.param '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>parser</parameter></term>
 <listitem>
  <para>
   Парсер XML.
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY xml.handler.description '<para xmlns="http://docbook.org/ns/docbook">
 Если передаётся значение &null; или пустая строка, то обработчик возвращается в состояние по умолчанию.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Если параметр <parameter>handler</parameter> является типом <type>callable</type>,
 то в качестве обработчика устанавливается callable.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Если параметр <parameter>handler</parameter> является строкой (<type>string</type>),
 то это может быть имя метода объекта, заданного с помощью функции <function>xml_set_object</function>.
</para>'>

<!ENTITY xml.handler.parser.param '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>parser</parameter></term>
 <listitem>
  <simpara>
   XML-парсер, вызывающий обработчик.
  </simpara>
 </listitem>
</varlistentry>'>

<!ENTITY xml.changelog.parser-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  Параметр <parameter>parser</parameter> ожидает экземпляр класса <classname>XMLParser</classname>;
  раньше параметр ждал корректный <literal>xml</literal>-ресурс (<type>resource</type>).
 </entry>
</row>'>

<!-- Migration Guide snippets -->
<!ENTITY migration56.openssl.peer-verification '
<para xmlns="http://docbook.org/ns/docbook">
 Все шифруемые клиентские потоки теперь по умолчанию включают проверку пиров.
 По умолчанию сертификат
 пира проверяется пакетом OpenSSL CA. Обычно не нужно ничего делать для
 соединения с серверами с правильным SSL-сертификатом, так как
 OpenSSL настроен так, что уже работает с хорошими CA-пакетами.
</para>

<para xmlns="http://docbook.org/ns/docbook">
 Стандартный CA пакет может быть переопределён глобально с помощью
 установки или openssl.cafile или openssl.capath строк конфигурации,
 или же на уровне каждого запроса используя опции контекста
 <link linkend="context.ssl.cafile"><parameter>cafile</parameter></link> или
 <link linkend="context.ssl.capath"><parameter>capath</parameter></link>.
</para>

<para xmlns="http://docbook.org/ns/docbook">
 Хотя это и не рекомендуется, но можно отключить проверку сертификата пира
 для запроса, установив <link linkend="context.ssl.verify-peer"><parameter>verify_peer</parameter></link>
 опцию контекста в &false;, и можно отключить проверку имени пира, установив
 <link linkend="context.ssl.verify-peer-name"><parameter>verify_peer_name</parameter></link> в &false;.
</para>
'>
<!-- 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: fen fdm=syntax fdl=2 si
vim: et tw=78
vi: ts=1 sw=1
-->