language-snippets.ent

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 27aaf9a626b5711866a2e6957f568e3c31143760 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). Используйте <command>php -i</command>
или встроенную константу <constant>PHP_ZTS</constant>, чтобы узнать, собран ли PHP с ZTS.</simpara></note>'>

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

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

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

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

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

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

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

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

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

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

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

<!-- Tips -->

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

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

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

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


<!-- Warnings -->

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

<!ENTITY warn.ssl-non-standard '<warning xmlns="http://docbook.org/ns/docbook"><para>При работе с сервером 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
 и <emphasis>удалили</emphasis> в PHP 7.0.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 В PHP предусмотрели следующие альтернативы функции:
</para>
'>

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

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

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

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

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

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

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

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

<!-- Misc -->

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

<!-- Returns -->

<!ENTITY return.type.true '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.2.0</entry>
 <entry>
  Значение возврата теперь принадлежит типу &true;; раньше значение принадлежало типу <type>bool</type>.
 </entry>
</row>'>

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

<!-- 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
  и <emphasis>УДАЛИЛИ</emphasis> в PHP 8.0.0.
  Вместо этой функции вызывают функцию <function>ldap_search</function>
  с передачей в параметр <parameter>controls</parameter>
  управляющих объектов протокола LDAP.
  Раздел «<link linkend="ldap.controls">Управляющие объекты LDAP</link>»
  даёт дополнительную информацию.
 </simpara>
</warning>'>

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

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

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

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

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

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

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

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

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

<!-- mbstring notes -->

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

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

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

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

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

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

<!-- mcrypt notes -->

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

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

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

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

<!-- MCVE notes -->

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

<!-- memcached notes -->

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

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

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

<!ENTITY memcached.parameter.items 'Массив пар ключей и значений для хранения на сервере.'>

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

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

<!ENTITY memcached.result.getresultcode 'Вызывайте метод
<methodname xmlns="http://docbook.org/ns/docbook">Memcached::getResultCode</methodname>, если требуется.'
>

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

<!-- password notes -->

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

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

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

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

<!-- pspell notes -->

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

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

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

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

<!-- RNP -->

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

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

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

<!-- socket entities -->

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

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

<!-- gearman notes -->

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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


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

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

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

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

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

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

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

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

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

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

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

<!-- GNUPG -->
<!ENTITY gnupg.identifier '<para xmlns="http://docbook.org/ns/docbook">Идентификатор, с которым будет работать модуль
GnuPG: или ресурс, который вернула функция <function>gnupg_init</function>, или объект класса <classname>gnupg</classname>.</para>'>

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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


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

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

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

<!-- XSLT Notes -->

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

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

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

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

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


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

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

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

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

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

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

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

<!-- Common pieces in partintro-sections -->
<!ENTITY no.config '<para xmlns="http://docbook.org/ns/docbook">Файл &php.ini; не содержит директив
для конфигурации модуля.</para>'>

<!ENTITY no.resource '<para xmlns="http://docbook.org/ns/docbook">Модуль не содержит типов ресурсов.</para>'>

<!ENTITY no.constants '<para xmlns="http://docbook.org/ns/docbook">Модуль не содержит констант.</para>'>

<!ENTITY no.requirement '<para xmlns="http://docbook.org/ns/docbook">Модуль не требует внешних библиотек.</para>'>

<!ENTITY no.install '<para xmlns="http://docbook.org/ns/docbook">Функции работают без установки,
поскольку составляют часть PHP-ядра.</para>'>

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

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

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

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

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

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

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

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

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

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

 <!-- PDO errors -->

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

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

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

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

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

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

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

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

<!-- PGSQL entities -->

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

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

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

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

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

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

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

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

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

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

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


<!ENTITY windows.builtin '<simpara xmlns="http://docbook.org/ns/docbook">В версию PHP для Windows
встроили поддержку модуля 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>'>

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

<!-- Snippets for the installation section -->
<!ENTITY warn.apache2.compat '<warning xmlns="http://docbook.org/ns/docbook"><para>Разработчики 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 ' и'>

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

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

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

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

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

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

<!-- HTTP -->

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

<!ENTITY imagick.bestfit.note '<note xmlns="http://docbook.org/ns/docbook">
<simpara>
 Поведение параметра <parameter>bestfit</parameter> изменили в Imagick 3.0.0.
 До этой версии при размерах 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 com.use-oo-instead '<note xmlns="http://docbook.org/ns/docbook">
<simpara>
 Эта функция не существует в PHP 5; вместо этого для доступа к свойствам и вызову методов пользуются
 обычным и более привычным объектно-ориентированным синтаксисом.
</simpara>
</note>
'>

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

<!-- SNMP -->
<!ENTITY snmp.set.type.values '<para xmlns="http://docbook.org/ns/docbook">
База управляющей информации <acronym>MIB</acronym> определяет для каждого объекта тип идентификатора.
Тип указывается одним символом из следующего списка.
</para>
<table xmlns="http://docbook.org/ns/docbook">
 <title>Типы</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.'>

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

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

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

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

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

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

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

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

<!ENTITY mongodb.option.maxCommitTimeMS '
<row xmlns="http://docbook.org/ns/docbook">
 <entry>maxCommitTimeMS</entry>
 <entry>integer</entry>
 <entry>
  <para>
   Максимальный период времени в миллисекундах, в течение которого
   выполняется одна команда <literal>commitTransaction</literal>.
  </para>
  <para>
   Опция принимает <literal>maxCommitTimeMS</literal> 32-разрядное
   целое число со знаком, которое больше или равно нулю.
  </para>
 </entry>
</row>
'>
<!ENTITY mongodb.option.readConcern '
<row xmlns="http://docbook.org/ns/docbook">
 <entry>readConcern</entry>
 <entry><classname>MongoDB\Driver\ReadConcern</classname></entry>
 <entry>
  <para>
   Гарантия чтения для применения к операции.
  </para>
  <para>
   Эта опция доступна в MongoDB 3.2+ и приведёт
   к исключению во время выполнения, если указана для
   более старой версии сервера.
  </para>
 </entry>
</row>
'>
<!ENTITY mongodb.option.readPreference '
<row xmlns="http://docbook.org/ns/docbook">
 <entry>readPreference</entry>
 <entry><classname>MongoDB\Driver\ReadPreference</classname></entry>
 <entry>
  <para>
   Предпочтение чтения, используемая для выбора сервера для выполнения операции.
  </para>
 </entry>
</row>
'>
<!ENTITY mongodb.option.session '
<row xmlns="http://docbook.org/ns/docbook">
 <entry>session</entry>
 <entry><classname>MongoDB\Driver\Session</classname></entry>
 <entry>
  <para>
   Сессия для связывания с операцией.
  </para>
 </entry>
</row>
'>
<!ENTITY mongodb.option.transactionReadWriteConcern '
<warning xmlns="http://docbook.org/ns/docbook">
 <para>
  При использовании <literal>"session"</literal> и наличии незавершённых
  транзакций, вы не можете указать <literal>"readConcern"</literal> or
  <literal>"writeConcern"</literal> option. Это приведёт к выбрасыванию
  исключения <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname>.
  Вместо этого вы должны установить эти две опции при создании транзакции с помощью
  <methodname>MongoDB\Driver\Session::startTransaction</methodname>.
 </para>
</warning>
'>
<!ENTITY mongodb.option.writeConcern '
<row xmlns="http://docbook.org/ns/docbook">
 <entry>writeConcern</entry>
 <entry><classname>MongoDB\Driver\WriteConcern</classname></entry>
 <entry>
  <para>
   Гарантия записи для применения к операции.
  </para>
 </entry>
</row>
'>
<!ENTITY mongodb.parameter.namespace '
<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>namespace</parameter> (<type>string</type>)</term>
 <listitem>
  <para>
   Полностью определённое имя (т.е. <literal>"databaseName.collectionName"</literal>).
  </para>
 </listitem>
</varlistentry>
'>
<!ENTITY mongodb.parameter.db '
<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>db</parameter> (<type>string</type>)</term>
 <listitem>
  <para>
   Имя базы данных, в которой запускается команда.
  </para>
 </listitem>
</varlistentry>
'>
<!ENTITY mongodb.parameter.bulkwrite '
<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>bulk</parameter> (<classname>MongoDB\Driver\BulkWrite</classname>)</term>
 <listitem>
  <para>
   Записи для выполнения.
  </para>
 </listitem>
</varlistentry>
'>
<!ENTITY mongodb.parameter.command '
<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>command</parameter> (<classname>MongoDB\Driver\Command</classname>)</term>
 <listitem>
  <para>
   Команда для выполнения.
  </para>
 </listitem>
</varlistentry>
'>
 <!ENTITY mongodb.parameter.encryptOpts '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>options</parameter></term>
    <listitem>
     <para>
      <table>
       <title>Encryption options</title>
       <tgroup cols="3">
        <thead>
         <row>
          <entry>Опция</entry>
          <entry>Тип</entry>
          <entry>Описание</entry>
         </row>
        </thead>
        <tbody>
         <row>
          <entry>algorithm</entry>
          <entry><type>string</type></entry>
          <entry>
           <para>
            Алгоритм шифрования, который будет использоваться. Опция обязательна.
            Укажите одну из следующих
            <link linkend="mongodb-driver-clientencryption.constants">констант ClientEncryption</link>:
           </para>
           <simplelist>
            <member><constant>MongoDB\Driver\ClientEncryption::AEAD_AES_256_CBC_HMAC_SHA_512_DETERMINISTIC</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::AEAD_AES_256_CBC_HMAC_SHA_512_RANDOM</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::ALGORITHM_UNINDEXED</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE</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="book.bson">классу BSON</link> (т.е. использовать <classname>MongoDB\BSON\ObjectId</classname> для выборке по <link xlink:href="&url.mongodb.docs.objectid;" xmlns:xlink="http://www.w3.org/1999/xlink">ObjectId</link>).
   </simpara>
  </note>
 </listitem>
</varlistentry>
'>
<!ENTITY mongodb.returns.cursor '<para xmlns="http://docbook.org/ns/docbook">В случае успешного выполнения метод возвращает курсор <classname>MongoDB\Driver\Cursor</classname>.</para>'>
<!ENTITY mongodb.returns.writeresult '<para xmlns="http://docbook.org/ns/docbook">В случае успешного выполнения метод возвращает экземпляр класса <classname>MongoDB\Driver\WriteResult</classname>.</para>'>
<!ENTITY mongodb.throws.std '&mongodb.throws.argumentparsing;&mongodb.throws.connection;&mongodb.throws.authentication;'>
<!ENTITY mongodb.throws.session-readwriteconcern '<member xmlns="http://docbook.org/ns/docbook">Выбрасывается исключение <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname>, если опция <literal>"session"</literal> указана с соответствующей транзакцией в сочетании с опцией <literal>"readConcern"</literal> или <literal>"writeConcern"</literal>.</member>'>
<!ENTITY mongodb.throws.session-unacknowledged '<member xmlns="http://docbook.org/ns/docbook">Выбрасывается <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname>, если опция <literal>"session"</literal> указана в сочетании с неподтверждённой гарантией записи.</member>'>
<!ENTITY mongodb.throws.bulkwriteexception '<member xmlns="http://docbook.org/ns/docbook">При ошибке записи метод выбрасывает исключение  <classname>MongoDB\Driver\Exception\BulkWriteException</classname>.</member>'>
<!ENTITY mongodb.throws.argumentparsing '<member xmlns="http://docbook.org/ns/docbook">При ошибке парсинга аргумента метод выбрасывает исключение  <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname>.</member>'>
<!ENTITY mongodb.throws.authentication '<member xmlns="http://docbook.org/ns/docbook">При неудачной аутентификации метод выбрасывает исключение <classname>MongoDB\Driver\Exception\AuthenticationException</classname>.</member>'>
<!ENTITY mongodb.throws.connection '<member xmlns="http://docbook.org/ns/docbook">При неудачном соединении с сервером (кроме ошибок аутентификации) метод выбрасывает исключение <classname>MongoDB\Driver\Exception\ConnectionException</classname>.</member>'>
<!ENTITY mongodb.throws.bson.unexpected '<member xmlns="http://docbook.org/ns/docbook">Исключение <classname>MongoDB\Driver\Exception\UnexpectedValueException</classname> выбрасывается, если входные данные не являются ровно одним документом BSON. Возможные причины включают, но не ограничены некорректным BSON, лишними данными или неожиданной ошибкой <link xlink:href="&url.mongodb.libbson;" xmlns:xlink="http://www.w3.org/1999/xlink">libbson</link>.</member>'>

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  <para>
   <table>
    <title>Флаги</title>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>Флаг</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry><literal>-</literal></entry>
       <entry>
        Выравнивание по левому краю в пределах заданной ширины поля;
        По умолчанию выравнивание происходит по правому краю.
       </entry>
      </row>
      <row>
       <entry><literal>+</literal></entry>
       <entry>
        Печатает плюс <literal>+</literal> у не отрицательных чисел;
        По умолчанию знак печатается только у отрицательных чисел.
       </entry>
      </row>
      <row>
       <entry><literal> </literal>(пробел)</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>
'>

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

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

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

<!-- UOPZ snippets -->

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

<!-- XML snippets -->

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

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

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

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

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

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

<para xmlns="http://docbook.org/ns/docbook">
 Хотя это и не рекомендуется, но можно отключить проверку сертификата пира
 для запроса, установив <link linkend="context.ssl.verify-peer"><parameter>verify_peer</parameter></link>
 опцию контекста в &false;, и можно отключить проверку имени пира, установив
 <link linkend="context.ssl.verify-peer-name"><parameter>verify_peer_name</parameter></link> в &false;.
</para>
'>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: fen fdm=syntax fdl=2 si
vim: et tw=78
vi: ts=1 sw=1
-->