language-snippets.ent

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f0d52500c7f8bda83761b18d6c03965741753abd 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>Включение
опции <link linkend="ini.auto-detect-line-endings">auto_detect_line_endings</link> во время выполнения
иногда помогает исправить неправильное распознавание языком PHP концов строк при чтении файлов
на Macintosh-совместимом компьютере или файлов, которые создали на Макинтоше.</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 —
 потокобезопасность движка Zend). Команда <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>
  Функцию нельзя вызывать внутри callback-функции, которую указали в первом аргументе
  функции <function>ob_start</function>, поскольку когда параметр <parameter>return</parameter>
  настраивают для возврата, а не вывода значения, функция использует внутреннюю буферизацию вывода.
 </para>
</note>'>

<!ENTITY note.uses-ob-php70 '<note xmlns="http://docbook.org/ns/docbook">
 <para>
  Функцию нельзя вызывать внутри callback-функции, которую указали в первом аргументе
  функции <function>ob_start</function>, поскольку когда параметр <parameter>return</parameter>
  настраивают для возврата, а не вывода значения, функция использует внутреннюю буферизацию вывода до PHP 7.1.0.
 </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>escapeshellcmd</function>, а отдельные аргументы команды
функцией <function>escapeshellarg</function>,
когда разрешают передавать в функцию пользовательские данные,
чтобы пользователи обманом не заставили систему выполнить произвольные команды.</para></warning>
'>

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

<!ENTITY deprecated.function 'Функция устарела.'>
<!ENTITY removed.function 'Функцию удалили.'>

<!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>
  С PHP 5.3.0 функция <emphasis>УСТАРЕЛА</emphasis>, а в PHP 5.4.0 её <emphasis>УДАЛИЛИ</emphasis>.
 </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,
  а в PHP 8.0.0 функцию <emphasis>УДАЛИЛИ</emphasis>.
  Пользоваться функцией настоятельно не рекомендуют.
 </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,
  а в PHP 7.2.0 функцию <emphasis>УДАЛИЛИ</emphasis>.
  Пользоваться функцией настоятельно не рекомендуют.
 </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,
  а в PHP 8.0.0 её <emphasis>УДАЛИЛИ</emphasis>
  и настоятельно не рекомендовали пользоваться.
 </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,
  а в PHP 8.0.0 функцию <emphasis>УДАЛИЛИ</emphasis>.
  Пользоваться функцией настоятельно не рекомендуют.
 </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,
  а в PHP 8.0.0 функцию <emphasis>УДАЛИЛИ</emphasis>.
  Пользоваться функцией настоятельно не рекомендуют.
 </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,
  а в PHP 8.0.0 функцию <emphasis>УДАЛИЛИ</emphasis>.
  Пользоваться функцией настоятельно не рекомендуют.
 </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 warn.deprecated.feature-8-4-0 '
 <warning xmlns="http://docbook.org/ns/docbook">
  <simpara>
   Функция <emphasis>УСТАРЕЛА</emphasis> с PHP 8.4.0.
   Пользоваться функцией настоятельно не рекомендуют.
  </simpara>
 </warning>
'>

<!ENTITY warn.deprecated.function-8-4-0 '
<warning xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Функция <emphasis>УСТАРЕЛА</emphasis> с PHP 8.4.0.
  Пользоваться функцией настоятельно не рекомендуют.
 </simpara>
</warning>
'>

<!ENTITY removed.php.future '
Функция устарела и ее <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">
   О безопасности PHP в режиме 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>При работе с сервером Microsoft IIS
по SSL-протоколу разработчик сталкивается с тем, что 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>, и подавляет предупреждение.
За обнаружение и подавление предупреждения отвечает разработчик, который вызывает функцию
<function>fsockopen</function>, чтобы создать сокет <literal>ssl://</literal>.</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,
 а в PHP 7.0.0 функцию <emphasis>УДАЛИЛИ</emphasis>.
</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,
 а в PHP 7.0.0 функцию <emphasis>УДАЛИЛИ</emphasis>.
</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,
 а в PHP 7.0.0 функцию <emphasis>УДАЛИЛИ</emphasis>.
</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,
 а в PHP 7.2.0 функцию <emphasis>УДАЛИЛИ</emphasis>.
</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.84 '
<para xmlns="http://docbook.org/ns/docbook">
 Результат выполнения приведённого примера в PHP 8.4:
</para>
'>

<!ENTITY example.outputs.84.similar '
<para xmlns="http://docbook.org/ns/docbook">
 Результат выполнения приведённого примера в PHP 8.4 аналогичен:
</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>,
  если параметр <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>
  PHP внутренне приведёт значение, которое возвращает 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 'Модуль работает в ОС Windows,
только когда системной переменной <envar xmlns="http://docbook.org/ns/docbook">PATH</envar>
доступны <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 match '<link xmlns="http://docbook.org/ns/docbook" linkend="control-structures.match">match</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>
  Функция больше не гарантирует возврат разницы
  <code>strlen($string1) - strlen($string2)</code>, когда длины строк
  не равны, но теперь вместо этого иногда возвращает <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>'>

<!-- CSV -->
<!ENTITY warning.csv.escape-parameter '<warning xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"><simpara>
 Строка в CSV-формате иногда перестаёт соответствовать стандарту <link xlink:href="&url.rfc;4180">RFC 4180</link>
 или не выдерживает обмена информацией с PHP-функциями
 для работы с CSV-строками, если для символа экранирования <parameter>escape</parameter> устанавливают значение,
 которое отличается от пустой строки <literal>""</literal>.
 Значение по умолчанию для параметра <parameter>escape</parameter> — <literal>"\\"</literal>,
 поэтому рекомендуют явно указывать пустую строку. Значение по умолчанию изменят в будущей версии PHP, но не раньше PHP 9.0.
</simpara></warning>'>

<!-- 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> теперь ожидает экземпляр класса <classname>CurlMultiHandle</classname>;
  раньше ожидался ресурс (<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> теперь ожидает экземпляр класса <classname>CurlShareHandle</classname>;
  рарьше параметр ждал ресурс (<type>resource</type>).
 </entry>
</row>'>

<!-- dba notes -->
<!ENTITY dba.parameter.dba '
 Экземпляр класса <classname xmlns="http://docbook.org/ns/docbook">Dba\Connection</classname>,
 который возвращают функции <function xmlns="http://docbook.org/ns/docbook">dba_open</function>
 и <function xmlns="http://docbook.org/ns/docbook">dba_popen</function>.
'>
<!ENTITY dba.changelog.dba-object '<row xmlns="http://docbook.org/ns/docbook">
<entry>8.4.0</entry>
<entry>
 Параметр <parameter>dba</parameter> теперь ожидает экземпляр класса <classname>Dba\Connection</classname>;
 раньше параметр ждал ресурс (&resource;) <literal>dba</literal> .
</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> вернёт почтовые ящики
только верхнего уровня; с серверов <literal>UW_IMAPD</literal> значение &apos;<literal>~/mail/&#37;</literal>&apos;
вернёт почтовые ящики каталога <filename>~/mail</filename>,
но не подкаталогов этого каталога.</para>'>

<!ENTITY imap.mailboxname.insecure '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
Передача в этот параметр непроверенных данных <emphasis>небезопасна</emphasis>,
если включили директиву <link linkend="ini.imap.enable-insecure-rsh">imap.enable_insecure_rsh</link>.
</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>), если только кодовую точку не передали как строку (<type>string</type>)
в кодировке UTF-8, при передаче которой возвращается строка (<type>string</type>).
Метод возвращает &null;, если возникла ошибка.</para>'>

<!ENTITY intl.codepoint.example 'Пример проверки кодовых точек'>

<!ENTITY intl.property.parameter '<para xmlns="http://docbook.org/ns/docbook">Свойство Юникода
для поиска (см. константы семейства <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
  а в PHP 8.0.0 функцию <emphasis>УДАЛИЛИ</emphasis>.
  Вместо этой функции вызывают функцию <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_<replaceable>*</replaceable></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-объект, который возвращает функция <function xmlns="http://docbook.org/ns/docbook">rnp_ffi_create</function>.'>

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

<!ENTITY rnp.parameter.loadsave-flags 'Смотрите описание флагов <constant xmlns="http://docbook.org/ns/docbook">RNP_LOAD_SAVE_<replaceable>*</replaceable></constant>.'>

<!-- 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'>

<!ENTITY gearman.parameter.callback '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>callback</parameter></term>
 <listitem>
  <para>
   Функция или метод, который требуется вызывать
   и от которого требуется возврат допустимого <link linkend="gearman.constants">значение возврата сервера Gearman</link>.
  </para>
  <para>
   По умолчанию из callback-функции возвращается значение <constant>GEARMAN_SUCCESS</constant>,
   если в функции обратного вызова не указали инструкцию return.
  </para>
  <methodsynopsis>
   <type>int</type><methodname><replaceable>callback</replaceable></methodname>
   <methodparam><type>GearmanTask</type><parameter>task</parameter></methodparam>
   <methodparam><type>mixed</type><parameter>context</parameter></methodparam>
  </methodsynopsis>
  <variablelist>
   <varlistentry>
    <term><parameter>task</parameter></term>
    <listitem>
     <para>
      Задача, для которой вызывается callback-функция.
     </para>
    </listitem>
   </varlistentry>
   <varlistentry>
    <term><parameter>context</parameter></term>
    <listitem>
     <para>
      Данные, которые передали в метод <methodname>GearmanClient::addTask</methodname>
      или эквивалентный метод в аргументе <parameter>context</parameter>.
     </para>
    </listitem>
   </varlistentry>
  </variablelist>
 </listitem>
</varlistentry>'>

<!ENTITY gearman.note.callback '<note xmlns="http://docbook.org/ns/docbook">
 <para>
  Callback-функция запустится только для задач, которые добавили методом
  <methodname>GearmanClient::addTask</methodname> или альтернативным методом после вызова этого метода.
 </para>
</note>'>

<!-- 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;'>

<!-- 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> или <function>iconv</function>,
  или методом <methodname>UConverter::transcode</methodname>.
 </para>
</note>'>

<!ENTITY dom.note.modern.utf8 '<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  При работе с методами или свойствами модуль DOM использует кодировку UTF-8.
  Методы парсера автоматически определяют кодировку или разрешают указать кодировку при вызове.
 </simpara>
</note>'>

<!ENTITY dom.note.json '<note xmlns="http://docbook.org/ns/docbook">
 <para>
  При вызове функции <function>json_encode</function> на объекте <classname>DOMDocument</classname>
  кодируется пустой объект.
 </para>
</note>'>
<!ENTITY dom.domdocument.html5 '<warning xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Для разбора и обработки современной HTML-разметки рекомендуют вместо класса <classname>DOMDocument</classname>
  пользоваться классом <classname>Dom\HTMLDocument</classname>.
 </simpara>
 <simpara>
  Функция разбирает входные данные по стандарту HTML 4. Правила синтаксического анализа
  по стандарту HTML 5, с которым работают современные браузеры, содержат отличия. Итоговая структура DOM
  зависит от входных данных. Поэтому функцию нельзя
  использовать для безопасной очистки HTML-разметки.
 </simpara>
 <simpara>
  Поведение при разборе HTML-разметки зависит от версии библиотеки
  <literal>libxml</literal>, это проявляется острее
  при наступлении граничных условий и при обработке ошибок.
  Разметку, которая соответствует спецификации HTML5, разбирают
  методом <methodname>Dom\HTMLDocument::createFromString</methodname>
  или <methodname>Dom\HTMLDocument::createFromFile</methodname>, которые добавили в PHP 8.4.
 </simpara>
 <simpara>
  Например, отдельные HTML-элементы при встрече неявно закрывают
  родительский элемент. Правила автоматического закрытия родительских элементов
  в спецификациях HTML 4 и HTML 5 неодинаковые. Поэтому итоговая структура DOM, которую
  видит класс <classname>DOMDocument</classname>, отличается от DOM-структуры,
  которую видит браузер, что создаёт риск взлома итоговой HTML-разметки
  злоумышленником.
 </simpara>
</warning>'>
<!ENTITY dom.tokenlist.errors '<itemizedlist xmlns="http://docbook.org/ns/docbook">
<listitem>
 <simpara>
  Выбрасывает ошибку <exceptionname>ValueError</exceptionname>,
  если токен содержит нулевые байты.
 </simpara>
</listitem>
<listitem>
 <simpara>
  Выбрасывает исключение <exceptionname>Dom\DOMException</exceptionname> с кодом <constant>Dom\SYNTAX_ERR</constant>,
  если лексема является пустой строкой.
 </simpara>
</listitem>
<listitem>
 <simpara>
  Выбрасывает исключение <exceptionname>Dom\DOMException</exceptionname> с кодом <constant>Dom\INVALID_CHARACTER_ERR</constant>,
  если лексема содержит любой пробел ASCII.
  ASCII whitespace.
 </simpara>
</listitem>
</itemizedlist>'>

<!-- 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.parameter.compliant.options '&dom.parameter.options;
 <simpara xmlns="http://docbook.org/ns/docbook">
  Разрешается также передавать константу <constant>Dom\HTML_NO_DEFAULT_NS</constant>,
  чтобы отключить пространства имён HTML-документа и элемента шаблона.
  Перед передачей константы лучше убедиться, что последствия этого понятны.
</simpara>'>

<!ENTITY dom.parameter.compliant.encoding '<simpara xmlns="http://docbook.org/ns/docbook">
 Кодировка, в которой создали документ.
 Метод попытается определить наиболее вероятную кодировку, если кодировку не указали.
</simpara>'>

<!ENTITY dom.parser.compliant.note.whitespace '<refsect1 role="notes" xmlns="http://docbook.org/ns/docbook">
 &reftitle.notes;
 <note>
  <simpara>
   Метод не считает пробельные символы в тегах <literal>html</literal> и <literal>head</literal>
   существенными, поэтому иногда такие символы теряются при форматировании.
  </simpara>
 </note>
</refsect1>'>

<!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.parameters.serialize.options '<simpara xmlns="http://docbook.org/ns/docbook">
 Дополнительные параметры.
 Метод поддерживает параметры <constant>LIBXML_NOEMPTYTAG</constant>
 и <constant>LIBXML_NOXMLDECL</constant>.
 До PHP 8.3.0 метод поддерживал только параметр <constant>LIBXML_NOEMPTYTAG</constant>.
</simpara>'>

<!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.errors.compliant.wrong_document '<listitem xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Метод выбрасывает исключение <exceptionname>Dom\DOMException</exceptionname> с кодом
  <constant>Dom\WRONG_DOCUMENT_ERR</constant>, если узел <parameter>node</parameter>
  принадлежит другому документу.
 </simpara>
</listitem>'>

<!ENTITY dom.errors.compliant.common '<listitem xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Метод выбрасывает ошибку <exceptionname>ValueError</exceptionname>,
  если аргумент <parameter>options</parameter> содержит недопустимые параметры.
 </simpara>
</listitem>
<listitem>
 <simpara>
  Метод выбрасывает ошибку <exceptionname>ValueError</exceptionname>,
  если в аргументе <parameter>overrideEncoding</parameter> передали неизвестную кодировку.
 </simpara>
</listitem>'>

<!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>.'
>

<!ENTITY dom.c14n.xpath_array '<listitem xmlns="http://docbook.org/ns/docbook">
  <para>
   Массив XPath-выражений для фильтрации узлов.
   Каждый элемент в этом массиве — ассоциативный массив с:
   <itemizedlist>
    <listitem>
     <simpara>
      Обязательным ключом запроса <literal>query</literal>, который содержит XPath-выражение в виде строки.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Необязательным ключом пространств имён <literal>namespaces</literal>,
      который содержит массив для сопоставления префиксов пространств имён (ключей)
      и URI-идентификаторов пространств имён (значений).
     </simpara>
    </listitem>
   </itemizedlist>
  </para>
 </listitem>'>

<!-- 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>
На 32-разрядных платформах отдельные PHP-функции для работы с файловой системой иногда возвращают
неожиданные результаты для файлов размером больше 2 ГБ, поскольку в PHP тип integer хранит числа со знаком,
а архитектура платформы ограничивает диапазон положительных значений типа.
</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.result.object 'Объект ODBC с результатом'>

<!ENTITY odbc.result.object-return 'Функция возвращает объект ODBC с результатом'>

<!ENTITY odbc.result.object-return-falseforfailure '&odbc.result.object-return;&return.falseforfailure;.'>

<!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 'Драйвер иногда сообщает о дополнительных столбцах.'>

<!ENTITY odbc.changelog.connection-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.4.0</entry>
 <entry>
  Параметр <parameter>odbc</parameter> теперь ожидает экземпляр соединения <classname>Odbc\Connection</classname>;
  раньше ожидался аргумент с типом <type>resource</type>.
 </entry>
</row>'>

<!ENTITY odbc.changelog.connection-return '&odbc.changelog.connection-param;
 <row xmlns="http://docbook.org/ns/docbook">
  <entry>8.4.0</entry>
  <entry>
   Функция теперь возвращает экземпляр соединения <classname>Odbc\Connection</classname>;
   раньше возвращалось значение с типом <type>resource</type>.
  </entry>
 </row>'>

<!ENTITY odbc.changelog.credential-params '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.4.0</entry>
 <entry>
  Параметры <parameter>user</parameter> и <parameter>password</parameter> теперь допускают
  значение &null;; они теперь являются необязательными и по умолчанию имеют значение &null;.
 </entry>
</row>
<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.4.0</entry>
 <entry>
  Ранее использование пустой строки для параметра <parameter>password</parameter> не включало <literal>pwd</literal>
  в генерируемую строку подключения параметра <parameter>dsn</parameter>.
  Теперь он генерируется для включения <literal>pwd</literal>,
  который имеет пустую строку в качестве своего значения.
  Чтобы восстановить прежнее поведение, в параметр <parameter>password</parameter>
  теперь можно передать значение &null;.
 </entry>
</row>
<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.4.0</entry>
 <entry>
  Ранее, если <parameter>dsn</parameter> содержал <literal>uid</literal> или <literal>pwd</literal>,
  параметры <parameter>user</parameter> и <parameter>password</parameter> игнорировались.
  Теперь параметр <parameter>user</parameter> игнорируется, только если значение параметра <parameter>dsn</parameter>
  содержит <literal>uid</literal>, а параметр <parameter>password</parameter> игнорируется,
  только если значение параметра <parameter>dsn</parameter> содержит <literal>pwd</literal>.
 </entry>
</row>'>

<!ENTITY odbc.changelog.result-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.4.0</entry>
 <entry>
  Параметр <parameter>statement</parameter> теперь ожидает экземпляр с результом OBDC-запроса <classname>Odbc\Result</classname>;
  раньше ожидался аргумент с типом <type>resource</type>.
 </entry>
</row>'>

<!ENTITY odbc.changelog.result-return '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.4.0</entry>
 <entry>
  Функция теперь возвращает объект с результатом ODBC-запроса <classname>Odbc\Result</classname>;
  раньше возвращалось значение с типом <type>resource</type>.
 </entry>
</row>'>

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

<!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 -->

<!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 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>'>

<!-- 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">SVN</acronym>-систему
репозитория <acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym>
по адресу: '>

<!ENTITY pecl.info.dead.git 'Модуль не поддерживается и больше неактуален.
Однако исходный код модуля по-прежнему доступен доступен для скачивания
через систему <acronym xmlns="http://docbook.org/ns/docbook">GIT</acronym>
репозитория <acronym xmlns="http://docbook.org/ns/docbook">PECL</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 '>

<!ENTITY warn.pecl.unmaintained '<warning xmlns="http://docbook.org/ns/docbook">
 <simpara>Модуль больше <emphasis>не поддерживается</emphasis>.</simpara>
</warning>'>

<!-- 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
встроили поддержку модуля PCRE. Доступ к функция модуля открыт без загрузки
дополнительных модулей.</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>'>

<!-- CTYPE Notes -->
<!ENTITY note.ctype.parameter.integer ' <note xmlns="http://docbook.org/ns/docbook">
 <para>
  Функция интерпретирует целое число (<type>int</type>) как ASCII-значение одного символа,
  если передали целое число в диапазоне между -128 и 255 включительно; к отрицательным
  значениям добавляется 256, чтобы разрешить символы из диапазона кодировки Extended 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">Экземпляр класса <classname>FTP\Connection</classname>.</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;), которая интерпретируется как число по той же логике
 как если бы строка использовалась в функции <function>gmp_init</function> с автоматическим
 определением основания системы счисления — когда значение параметра <parameter>base</parameter> равно 0.
</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>'>

<!-- 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, а в PHP 7.0.0 функцию удалили
 вместе <link linkend="book.mysql">с модулем MySQL</link>.
 Вместо этой функции пользуются модулями <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, а в PHP в 7.0.0 функцию удалили
 вместе <link linkend="book.mysql">с модулем MySQL</link>.
 Вместо этой функции пользуются модулями <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, а в PHP 7.0.0 функцию удалили
 вместе <link linkend="book.mysql">с модулем MySQL</link>.
 Вместо этой функции пользуются модулями <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, а в PHP 7.0.0 функцию удалили
 вместе <link linkend="book.mysql">с модулем MySQL</link>.
 Вместо этой функции пользуются модулями <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>
'>

<!-- 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>'>

<!-- 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>Разработчики PHP не рекомендуют
использовать многопоточный MPM-модуль в производственной среде, в которой работает Apache 2.
Лучше предпочесть prefork-версию модуля MPM, которая в Apache 2.0 и 2.2 идёт по умолчанию. Подробнее о причинах
рассказывает ответ раздела FAQ
<link linkend="faq.installation.apache2">о работе Apache2 с многопоточным MPM-модулем</link></para></warning>'>
<!ENTITY warn.install.third-party-support '<warning xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <para>
  Проект PHP считает сторонние сборки неофициальными
  и не поддерживает сборки, которые скомпилировали третьи лица. Об ошибках, которые обнаруживают
  в таких сборках, сообщают поставщику этих неофициальных сборок, если только ошибки не воспроизводятся
  в сборках <link xlink:href="&url.php.downloads;">с официальной страницы
  загрузки</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 ' и'>

<!-- runkit entities -->

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

<!ENTITY stream.bucket.param 'Параметр <parameter>bucket</parameter> теперь ожидает экземпляр класса <classname>StreamBucket</classname>; раньше ожидался объект <classname>stdClass</classname>.'>
<!ENTITY stream.bucket.return 'Функция теперь возвращает объект класса <classname>StreamBucket</classname>; раньше возвращался объект <classname>stdClass</classname>.'>

<!-- 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.
 До этой версии при размерах 400 x 300 точек изображение размером 200 x 150 точек оставалось нетронутым.
 В Imagick 3.0.0 и более поздних версиях изображение будет масштабироваться до размера 400 x 300 точек, поскольку такой размер
 «больше остальных соответствует» заданным размерам. Потребуется указать как ширину, так и высоту, если задали
 параметр <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-типы — целые числа, строки, числа с плавающей точкой, логические значения
 или &null;, — так и экземпляры классов COM, VARIANT или DOTNET. Встроенные типы языка PHP
 преобразуются в варианты по тем же правилам, которые содержит конструктор
 класса <xref linkend="class.variant"/>. Объекты классов COM и DOTNET получат
 значение их свойства по умолчанию, которое функция возьмёт и будет использовать
 как значение варианта.
</para>
<para>
 Вариантные арифметические функции — обёртки одноимённых
 функций библиотеки COM; дополнительную информацию по этим функциям содержит
 библиотека технической документации MSDN. Названия PHP-функций немного отличаются; например,
 функция <function>variant_add</function> в PHP соответствует функции <literal>VarAdd()
 </literal> в документации MSDN.
</para>
</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>'>

<!-- 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>'>

<!-- 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>Типы</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>Типы</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">
Разрешается указывать тип &apos;=&apos; как значение параметра <parameter>type</parameter>
для каждого идентификатора объекта, если MIB-файлы загружаются в MIB-дерево функцией snmp_read_mib
или путём указания в конфигурационном файле библиотеки libsnmp, поскольку тогда функция
автоматически считает тип из базы 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 при библиотечных ошибках включают
 путём установки свойству класса SNMP <parameter>exceptions_enabled</parameter> значения,
 которое определит конкретные ошибки, которые вызовут исключение.
 Подробнее смотрите <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 'Тип скользящей средней для линии Fast-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.'>

<!-- 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>
      <row>
       <entry>delegated</entry>
       <entry>bool</entry>
       <entry>Необязательный. Установка значения &true; передаёт управление расшифровкой ключа KMIP-серверу.</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</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</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</constant></member>
           </simplelist>
           <para>
            Опция применяется и может быть указана только тогда, когда
            опция <literal>algorithm</literal> равна
            <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED</constant>
            или <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE</constant>.
           </para>
          </entry>
         </row>
         <row>
          <entry>rangeOpts</entry>
          <entry><type>array</type></entry>
          <entry>
           <para>
            Опции индекса для шифруемого поля с поддержкой запросов «range».
            Параметры, которые приводят следующие абзацы, должны соответствовать значениям, которые установили
            в параметре <literal>encryptedFields</literal> целевой коллекции.
            Для BSON-полей с типом double и decimal128 требуется либо установить все опции
            <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> установили. Минимальное
                 BSON-значение в диапазоне.
                </entry>
               </row>
               <row>
                <entry>max</entry>
                <entry><type>mixed</type></entry>
                <entry>
                 Обязательна, если опцию <literal>precision</literal> установили. Максимальное
                 BSON-значение в диапазоне.
                </entry>
               </row>
               <row>
                <entry>sparsity</entry>
                <entry><type>int</type></entry>
                <entry>Необязательна. Опция принимает положительное 64-битное целое число.</entry>
               </row>
               <row>
                <entry>precision</entry>
                <entry><type>int</type></entry>
                <entry>
                 Небязательна. Опция принимает положительное 32-битное целое число, которое указывает точность
                 для явного шифрования. Опцию устанавливают только для BSON-полей с типом double
                 или decimal128.
                </entry>
               </row>
               <row>
                <entry>trimFactor</entry>
                <entry><type>int</type></entry>
                <entry>Необязательна. Положительное 32-битное целое число.</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="mongodb.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 модуль чувствителен к сценариям, которые используют
  системный вызов 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.stripped.characters '
<itemizedlist xmlns="http://docbook.org/ns/docbook">
   <listitem>
    <simpara>
     <literal>" "</literal>: <acronym>ASCII</acronym>-символ <acronym>SP</acronym>
     с кодом <literal>0x20</literal> — стандартный пробел.
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <literal>"\t"</literal>: <acronym>ASCII</acronym>-символ <acronym>HT</acronym>
     с кодом <literal>0x09</literal> — символ табуляции.
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <literal>"\n"</literal>: <acronym>ASCII</acronym>-символ <acronym>LF</acronym>
     с кодом <literal>0x0A</literal> — символ перевода строки.
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <literal>"\r"</literal>: <acronym>ASCII</acronym>-символ <acronym>CR</acronym>
     с кодом <literal>0x0D</literal> — символ возврата каретки.
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <literal>"\0"</literal>: <acronym>ASCII</acronym>-символ <acronym>NUL</acronym>
     с кодом <literal>0x00</literal> — NUL-байт.
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <literal>"\v"</literal>: <acronym>ASCII</acronym>-символ <acronym>VT</acronym>
     с кодом <literal>0x0B</literal> — символ вертикальной табуляции.
    </simpara>
   </listitem>
  </itemizedlist>
'>

<!ENTITY strings.stripped.unicode '
 <itemizedlist xmlns="http://docbook.org/ns/docbook">
    <listitem>
     <simpara>
      <literal>" "</literal> (<acronym>Unicode</acronym> U+0020), стандартный пробел.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\t"</literal> (<acronym>Unicode</acronym> U+0009), символ табуляции.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\n"</literal> (<acronym>Unicode</acronym> U+000A), новая строка (символ перевода строки).
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\r"</literal> (<acronym>Unicode</acronym> U+000D), возврат каретки.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\0"</literal> (<acronym>Unicode</acronym> U+0000), NUL-байт.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\v"</literal> (<acronym>Unicode</acronym> U+000B), символ вертикальной табуляции.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\f"</literal> (<acronym>Unicode</acronym> U+000C), перевод формы.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u00A0"</literal> (<acronym>Unicode</acronym> U+00A0), NO-BREAK SPACE (неразрывный пробел).
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u1680"</literal> (<acronym>Unicode</acronym> U+1680), OGHAM SPACE MARK (огамический знак пробела).
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u2000"</literal> (<acronym>Unicode</acronym> U+2000), EN QUAD (пробел в виде узкого «квадрата»).
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u2001"</literal> (<acronym>Unicode</acronym> U+2001), EM QUAD (пробел в виде широкого «квадрата»).
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u2002"</literal> (<acronym>Unicode</acronym> U+2002), EN SPACE (узкий пробел).
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u2003"</literal> (<acronym>Unicode</acronym> U+2003), EM SPACE (широкий пробел).
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u2004"</literal> (<acronym>Unicode</acronym> U+2004), THREE-PER-EM SPACE (треть широкого пробела).
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u2005"</literal> (<acronym>Unicode</acronym> U+2005), FOUR-PER-EM SPACE (четверть широкого пробела).
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <literal>"\u2006"</literal> (<acronym>Unicode</acronym> U+2006), SIX-PER-EM SPACE (одна шестая широкого пробела).
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u2007"</literal> (<acronym>Unicode</acronym> U+2007), FIGURE SPACE (цифровой пробел).
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u2008"</literal> (<acronym>Unicode</acronym> U+2008), PUNCTUATION SPACE (пунктуационный пробел).
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u2009"</literal> (<acronym>Unicode</acronym> U+2009), THIN SPACE (тонкий пробел).
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u200A"</literal> (<acronym>Unicode</acronym> U+200A), HAIR SPACE (самый тонкий пробел).
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u2028"</literal> (<acronym>Unicode</acronym> U+2028), LINE SEPARATOR (разделительная линия).
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u2029"</literal> (<acronym>Unicode</acronym> U+2029), PARAGRAPH SEPARATOR (разделительная параграф).
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u202F"</literal> (<acronym>Unicode</acronym> U+202F), NARROW NO-BREAK SPACE (узкий неразрывный пробел).
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u205F"</literal> (<acronym>Unicode</acronym> U+205F), MEDIUM MATHEMATICAL SPACE (средний математический пробел).
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u3000"</literal> (<acronym>Unicode</acronym> U+3000), IDEOGRAPHIC SPACE (пробел шириной в иероглиф).
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u0085"</literal> (<acronym>Unicode</acronym> U+0085), NEXT LINE (NEL) (следующая строка; одновременно переводит строку и возвращает позицию печати к началу строки).
     </simpara>
    </listitem>
    <listitem>
     <simpara>
     <literal>"\u180E"</literal> (<acronym>Unicode</acronym> U+180E), MONGOLIAN VOWEL SEPARATOR (монгольская гласная разделитель).
     </simpara>
    </listitem>
   </itemizedlist>
'>


<!ENTITY strings.parameter.characters.optional '
<simpara xmlns="http://docbook.org/ns/docbook">
 Параметр <parameter>characters</parameter> принимает символы, которые удалит функция.
 В аргументе перечисляют символы, которые требуется удалить.
 Возрастающий диапазон символов указывают конструкцией <literal>..</literal> — две точки.
</simpara>
'>

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


<!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>(пробел)</entry>
       <entry>
        Дополняет результат пробелами.
        Это поведение по умолчанию.
       </entry>
      </row>
      <row>
       <entry><literal>0</literal></entry>
       <entry>
        Дополняет числа нулями (только слева).
        Со спецификатором <literal>s</literal> также может
        дополнять нулями справа.
       </entry>
      </row>
      <row>
       <entry><literal>&apos;</literal>(символ)</entry>
       <entry>
        Дополняет результат символом (символ).
       </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>
'>

<!ENTITY strings.comparison.return '
  <simpara xmlns="http://docbook.org/ns/docbook">
   Функция возвращает значение меньше 0, если строка <parameter>string1</parameter>
   меньше строки <parameter>string2</parameter>; значение больше
   0, если строка <parameter>string1</parameter> больше строки
   <parameter>string2</parameter>, и <literal>0</literal>, если строки
   равны.
   Из значения возврата невозможно надёжно вывести конкретное значение,
   кроме знака числа.
  </simpara>
'>

<!-- filter snippets -->
<!-- TODO: Remove -->
<!ENTITY filter.param.filter '
<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>filter</parameter></term>
 <listitem>
  <para>
   Фильтр, который требуется применить.
   Параметр принимает фильтры проверки в виде константы семейства
   <constant>FILTER_VALIDATE_<replaceable>*</replaceable></constant>,
   фильтр очистки в виде константы семейства
   <constant>FILTER_SANITIZE_<replaceable>*</replaceable></constant>
   или фильтр <constant>FILTER_UNSAFE_RAW</constant>, или пользовательский фильтр в виде
   константы <constant>FILTER_CALLBACK</constant>.
  </para>
  <para>
   По умолчанию функция применяет фильтр <constant>FILTER_DEFAULT</constant> —
   псевдоним фильтра <constant>FILTER_UNSAFE_RAW</constant>.
   В результате поведением по умолчанию становится отсутствие фильтрации.
  </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; обработчик возвращается в состояние по умолчанию.
 <warning>
  <simpara>
    Пустая строка тоже сбросит обработчик,
    однако начиная с PHP 8.4.0 передача в параметр пустой строки устарела.
  </simpara>
 </warning>
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Функция установит как обработчик функцию, на которую указывает <type>callable</type>-выражение,
 если в параметр <parameter>handler</parameter> передали значение, которое вызывается как функция.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Параметр <parameter>handler</parameter> принимает строку (<type>string</type>)
 с названием метода объекта, который установили функцией <function>xml_set_object</function>.
 <warning>
  <simpara>
   Начиная с PHP 8.4.0 передача в параметр строки с названием метода устарела.
  </simpara>
 </warning>
</para>
<warning xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Начиная с PHP 8.4.0 корректность callable-выражения проверяется
  при установке, а не при вызове обработчика.
  Поэтому вызвать функцию <function>xml_set_object</function> потребуется
  до установки строки с названием метода, который вызывается как callback-функция.
  Однако, поскольку такое поведение тоже устарело с PHP 8.4.0,
  вместо передачи строки с названием метода рекомендуют указывать метод
  в правильном <type>callable</type>-выражении.
 </simpara>
</warning>
'>

<!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.handler-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.4.0</entry>
 <entry>
  Передача в параметр <parameter>handler</parameter> строки (<type>string</type>),
  которую невозможно вызывать как <type>callable</type>-выражение, устарела;
  теперь рекомендуют передавать в параметр правильное callable-выражение для установки метода
  или &null; для сброса обработчика.
 </entry>
</row>
<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.4.0</entry>
 <entry>
  Корректность обработчика <parameter>handler</parameter> как <type>callable</type>-выражения
  теперь проверяется при установке обработчика, а не при вызове.
 </entry>
</row>'>

<!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
-->