php-doc-ru/language-snippets.ent

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f2019b9d10cbf49d85a4328166de80e6c7e687a4 Maintainer: shein Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
<!-- Keep 'em sorted -->

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

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

<!-- Notes -->

<!ENTITY note.regex.deprecated '<note xmlns="http://docbook.org/ns/docbook"><para>С версии PHP 5.3.0,
расширение regex помечено устаревшим и заменено <link linkend="book.pcre">расширением PCRE</link>. Вызов этой функции
приведет к ошибке уровня <constant>E_DEPRECATED</constant>. Смотрите <link linkend="reference.pcre.pattern.posix">список
отличий</link> для помощи при конвертировании в PCRE.</para></note>'>

<!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 '<note xmlns="http://docbook.org/ns/docbook"><simpara>Поддержка контекста была добавлена
в PHP 5.0.0. Для описания <literal>контекстов</literal> смотрите раздел
<xref linkend="book.stream"/>.</simpara></note>'>

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

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

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

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

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

<!ENTITY note.no-key-association '<note xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция присваивает
новые ключи элементам <parameter>массива</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.randomseed '<note xmlns="http://docbook.org/ns/docbook"><simpara>Начиная с PHP 4.2.0, больше нет
необходимости инициализировать генератор случайных чисел функциями
<function>srand</function> или <function>mt_srand</function>, поскольку
теперь это происходит автоматически.</simpara></note>'>

<!ENTITY note.registerglobals '<note xmlns="http://docbook.org/ns/docbook"><title>register_globals: важное
замечание</title><para>Начиная с PHP 4.2.0, значением директивы PHP
<link linkend="ini.register-globals">register_globals</link> по умолчанию
является <emphasis>off</emphasis> (выключено). Сообщество PHP рекомендует
не полагаться на эту директиву, а использовать вместо этого иные
средства, такие как &link.superglobals;.</para></note>'>

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

<!ENTITY note.superglobals '<note xmlns="http://docbook.org/ns/docbook"><title>Суперглобальные переменные:
замечание о доступности</title><para>Начиная с PHP 4.1.0, стали доступными
суперглобальные массивы, такие как <varname>$_GET</varname>,
<varname>$_POST</varname>, <varname>$_SERVER</varname> и т.д. Дополнительную
информацию смотрите в разделе руководства &link.superglobals;</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.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.passwordhashing '<note xmlns="http://docbook.org/ns/docbook">
<title>Безопасное хэширование паролей</title>
<para>
 В связи с быстрой природой хэширующего алгоритма не рекомендуется
 использовать эту функцию для обеспечения безопасности паролей.
 Подробнее об этом можно прочитать
 <link linkend="faq.passwords.fasthash">здесь</link>.
</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>. Смотрите также список поддерживаемых оберток URL, их возможности, замечания по использованию и список
предопределенных констант в <xref linkend="wrappers"/>.</simpara></tip>'>

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

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

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


<!-- Warnings -->

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

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

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

<!ENTITY warn.deprecated.feature-5-3-0.removed-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>'>

<!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 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.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.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> или <link linkend="book.cyrus">Cyrus</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 note.magicquotes.gpc '<note xmlns="http://docbook.org/ns/docbook"><title>Замечание о директиве: magic_quotes_gpc
</title><para>Директива PHP <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link> имеет значение по умолчанию
<literal>on</literal> (включена). По сути это применяет функцию <function>addslashes</function> ко
всем GET-, POST- и COOKIE-данным. Чтобы удалить добавленные слэши,
вы можете использовать <function>stripslashes</function>.</para></note>'>

<!ENTITY warn.no-win32-fopen-wrapper '<warning xmlns="http://docbook.org/ns/docbook"><para>
Версии PHP для Windows до PHP 4.3.0 не поддерживают возможность использования удаленных файлов этой
функцией даже в том случае, если включена опция
<link linkend="ini.allow-url-fopen">allow_url_fopen</link>.</para></warning>'>

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

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


<!-- Misc -->

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

<!ENTITY version.trunk.after.53 '<emphasis xmlns="http://docbook.org/ns/docbook">Это изменение
существует только в <link linkend="about.phpversions">разрабатываемой версии</link> PHP, и,
возможно, будет существовать и после версии 5.3.</emphasis>'>

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

<!ENTITY seealso.callback 'информация о типе <link xmlns="http://docbook.org/ns/docbook" linkend="language.types.callback">callback</link>'>

<!ENTITY avail.register-long-arrays 'Начиная с PHP 5.0.0, длинные
<link xmlns="http://docbook.org/ns/docbook" linkend="language.variables.predefined">предопределенные переменные</link>
массивов PHP могут быть отключены директивой
<link xmlns="http://docbook.org/ns/docbook" linkend="ini.register-long-arrays">register_long_arrays</link>.'>

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

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

<!ENTITY info.function.alias 'Эта функция является псевдонимом: '>

<!ENTITY info.method.alias 'Этот метод является псевдонимом: '>

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

<!ENTITY ext.windows.path.dll 'Для работы этого расширения системной переменной Windows
<literal xmlns="http://docbook.org/ns/docbook">PATH</literal>должны быть доступны
<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 в
переменную Windows PATH</link>". Хотя копирование DLL-файлов из директории PHP в системную папку Windows
также решает проблему (потому что системная директория по умолчанию находится в переменной
<literal xmlns="http://docbook.org/ns/docbook">PATH</literal>), это не рекомендуется.
<emphasis xmlns="http://docbook.org/ns/docbook">Этому расширению требуются следующие файлы в переменной
 <literal>PATH</literal>:</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 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.falseforfailure ' или &false; в случае возникновения ошибки'>
<!ENTITY return.falseforfailure.style.procedural '&style.procedural; возвращает &false; в случае возникновения ошибки.'>

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

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

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

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

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

<!-- 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.config.jpeg '<note xmlns="http://docbook.org/ns/docbook"><simpara>Поддержка JPEG доступна только в случае,
если PHP был скомпилирован с GD-1.8 или более поздней версии.</simpara></note>'>

<!ENTITY note.config.wbmp '<note xmlns="http://docbook.org/ns/docbook"><simpara>Поддержка WBMP доступна только в случае,
если PHP был скомплирован с GD-1.8 или более поздней версии.</simpara></note>'>

<!ENTITY note.bundled.gd '<note xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция доступна только в
случае, если PHP был скомпилирован со встроенной библиотекой GD.</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.2 '<note xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция нуждается в GD версии 2.0.1 или выше.</simpara></note>'>

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

<!ENTITY gd.image.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
image</parameter></term><listitem><para>Ресурс изображения, полученный одной из функций создания изображений,
например, такой как <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 (более высокое число соответствует большему шрифту) или любому из ваших собственных идентификаторов шрифтов,
зарегистрированных с помощью <function>imageloadfont</function>.
</para></listitem></varlistentry>'>

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

<!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 'Размер шрифта. В зависимости от вашей версии GD, он должен быть указан либо в пикселах (GD1) либо в типографских пунктах (GD2).'>

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

<!-- cURL notes -->

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

<!-- IMAP notes -->

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

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

<!-- mbstring notes -->

<!ENTITY note.mbstring.encoding.internal '<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>
представляет собой символьную кодировку. Если он опущен, вместо него будет использовано значение внутренней кодировки.</para>'>

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

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

<!ENTITY memcached.parameter.server_key 'Ключ, идентифицирующий сервер, на котором хранится значение.'>

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

<!-- 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>.
</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), они существуют только по причинам обратной совместимости.
</simpara>'>


<!ENTITY date.timezone.errors.description '<para xmlns="http://docbook.org/ns/docbook">
Каждый вызов к функциям даты/времени при неправильных настройках временной зоны сгенерирует ошибку уровня <constant>E_NOTICE</constant>,
и/или ошибку уровня <constant>E_STRICT</constant> или <constant>E_WARNING</constant> при использовании системных
настроек или переменной окружения <varname>TZ</varname>. Смотрите также <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>integer</type> метку времени, по умолчанию равную текущему локальному времени, если <parameter>timestamp</parameter>
 не указан. Другими словами, значение по умолчанию равно результату функции <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.retval.changelog '<row xmlns="http://docbook.org/ns/docbook"><entry>5.3.0</entry><entry>Изменено
значение успешной работы функции с &null; на <classname>DateTime</classname>.</entry></row>'>

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

<!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.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.allowstatic '<para xmlns="http://docbook.org/ns/docbook">Этот метод
<emphasis>может</emphasis> быть вызван статически, но при этом будет сгенерирована ошибка
уровня <constant>E_STRICT</constant>.</para>'>
<!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>'>

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

<!-- 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.search 'Этот параметр принимает следующие шаблоны поиска:
"&#x25;" соответствующий нулю или более символам, и "_" соответствующий ровно одному символу.'>

<!-- 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'>Если не указано отдельно, 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
 10g или старше. Easy Connect string для Oracle 10g принимает следующую форму:
 <emphasis>[//]host_name[:port][/service_name]</emphasis>. Для Oracle 11g синтаксис таков:
 <emphasis>[//]host_name[:port][/service_name][:server_type][/instance_name]</emphasis>.
 Названия служб могут быть определены с помощью запуска Oracle утилиты <literal>lsnrctl status</literal>
 на сервере базы данных.
</para>
<para xmlns='http://docbook.org/ns/docbook'>
 Файл <filename>tnsnames.ora</filename> может находиться в поисковом пути Oracle Net, который включает
 <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.name.compat.note 'Старое имя функции также может быть использовано в текущих версиях, хотя оно уже устарело
и не рекомендуется.'>

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

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

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

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


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

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

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

<!-- XSLT Notes -->
<!ENTITY note.xslt.windows '<note xmlns="http://docbook.org/ns/docbook"><para>Учтите, что в случае использования Windows,
вам нужно указать <literal>file://</literal> в начале пути.</para></note>'>


<!-- Notes for safe-mode limited functions: -->
<!ENTITY note.sm.disabled '<note xmlns="http://docbook.org/ns/docbook"><simpara>&sm.disabled;</simpara></note>'>

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

<!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>.</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 -->
<!ENTITY sm.uidcheck 'Проверяет, имеют ли файлы/каталоги, с которыми
вы собираетесь работать, такой же UID (владельца), как и выполняемый скрипт.'>

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

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

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

<!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 'Для подробного описания констант
PHP_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 был собран с поддержкой этого расширения или данное расширение
было подгружено динамечески во время выполнения. Вдобавок, эти драйверо-зависимые константы должны быть использованы только
совместно с этим драйвером. Использование атрибутов, специфичных для некоторого драйвера с другим драйвером может вызвать
неожиданное поведенние. Если ваш код выполняется с несколькими драйверами, то можно использовать функцию
<function>PDO::getAttribute</function> для получения атрибута <constant>PDO_ATTR_DRIVER_NAME</constant>
для проверки драйвера.</simpara>'>

<!-- PECL entities -->
<!ENTITY pecl.moved 'Это расширение <link xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.pecl;">PECL</link>
не поставляется вместе с PHP.'>

<!ENTITY pecl.bundled 'Это расширение <link xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.pecl;">PECL</link>
поставляется вместе с PHP.'>

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

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

<!ENTITY pecl.source.4 'В PHP 4 исходные файлы этого расширения <acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym>
могут быть найдены в директории <filename xmlns="http://docbook.org/ns/docbook">ext/</filename> внутри исходных файлов
PHP или по ссылке <acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym> выше.'>

<!ENTITY pecl.windows.4 'В PHP 4 эта <acronym xmlns="http://docbook.org/ns/docbook">DLL</acronym> находится в
директории <filename xmlns="http://docbook.org/ns/docbook">extensions/</filename> внутри директории бинарного
дистрибутива PHP для Windows.'>

<!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.unbundled '&pecl.windows.download;'>

<!ENTITY pecl.moved-ver 'Это расширение было перемещено в репозиторий
<link xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.pecl;">PECL</link>
и больше не поставляется с PHP '>

<!-- kept for BC -->
<!ENTITY note.pecl-php5 '<note xmlns="http://docbook.org/ns/docbook"><simpara>
Это расширение удалено начиная с PHP 5 и перемещено
в репозиторий <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.pecl;">PECL</link>.
</simpara></note>'>

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


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

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

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

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

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

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

<!-- FBSQL Notes -->
<!ENTITY fbsql.link-identifier.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
link_identifier</parameter></term><listitem><para>Идентификатор соединения FrontBase, полученный из
<function>fbsql_connect</function> или
<function>fbsql_pconnect</function>.</para><para>Если он не был указан, то
функция попытается найти открытое соединение к серверу FrontBase, в случае неудачи попытается создать новое, как если бы
<function>fbsql_connect</function> была вызвана без аргументов.</para>
</listitem></varlistentry>'>

<!ENTITY fbsql.result.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
result</parameter></term><listitem><para>Идентификатор результата запроса, полученный из
<function>fbsql_query</function> или
<function>fbsql_db_query</function>.</para></listitem></varlistentry>'>

<!-- GMP Notes -->
<!ENTITY gmp.return '<link xmlns="http://docbook.org/ns/docbook" linkend="language.types.resource">Число GMP</link>.'>
<!ENTITY gmp.parameter '<para xmlns="http://docbook.org/ns/docbook">Может быть как
<link xmlns="http://docbook.org/ns/docbook" linkend="language.types.resource">числом GMP</link>, так и строкой,
при условии, что ее значение можно конвертировать в число.</para>'>

<!-- MySQLi Notes -->
<!ENTITY mysqli.result.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
result</parameter></term><listitem><para>Только для процедурного стиля: Идентификатор результата запроса, полученный с помощью
<function>mysqli_query</function>, <function>mysqli_store_result</function>
или <function>mysqli_use_result</function>.</para></listitem></varlistentry>'>
<!ENTITY mysqli.link.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
link</parameter></term><listitem><para>Только для процедурного стиля: Идентификатор соединения, полученный с помощью
<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>Только для процедурного стиля: Идентификатор выражения, полученный с помощью
<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>Libmysql по умолчанию использует
кодировку, установленную в <filename>my.cnf</filename> или специальным вызовом <function>mysqli_options</function> до
использования <function>mysqli_real_connect</function>, но после <function>mysqli_init</function>.</para></note>'>

<!-- Notes for SAPI/Apache -->
<!ENTITY note.apache.nsapi-module '<para xmlns="http://docbook.org/ns/docbook">Начиная с PHP 4.3.3 вы также
можете использовать эти функции с <link linkend="book.nsapi">модулем NSAPI</link>
в серверах Netscape/iPlanet/SunONE.</para>'>

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

<!-- 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.include 'Альтернативы данной функции: '>

<!ENTITY mysql.alternative.note '<title xmlns="http://docbook.org/ns/docbook">Предлагаемые альтернативы</title>
<para xmlns="http://docbook.org/ns/docbook">Не рекомендуется использовать это расширение. Используйте вместо
него <link linkend="book.mysqli">MySQLi</link> или <link linkend="ref.pdo-mysql">PDO_MySQL</link>.
Смотрите также <link linkend="mysqlinfo.api.choosing">MySQL: выбор API</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 note.tidy.ze2 '<note xmlns="http://docbook.org/ns/docbook"><simpara> Эта функция доступна только в Zend Engine 2 (PHP &gt;= 5.0.0).</simpara></note>'>

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

<!ENTITY note.tidy.1only '<note xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция доступна только в
Tidy 1.0. С приходом Tidy 2.0 она стала ненужной и была удалена.</simpara></note>'>

<!ENTITY note.tidy.2only '<note xmlns="http://docbook.org/ns/docbook"><simpara>
Необязательные параметры <parameter>config</parameter> и
<parameter>enconding</parameter> были добавлены в Tidy 2.0.</simpara></note>'>

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

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

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

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

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

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

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

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

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

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

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

<!ENTITY listendand ' и'>

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

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

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

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

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

<!-- HTTP -->
<!ENTITY see.http.request.options '<para xmlns="http://docbook.org/ns/docbook">Смотрите полный список &link.http.request.options;.</para>'>
<!ENTITY see.http.configuration.force_exit 'Смотрите &link.http.configuration;
<link xmlns="http://docbook.org/ns/docbook" linkend="http.configuration.force-exit">http.force_exit</link> для пояснения термина "выходит".'>

<!ENTITY link.http.configuration '<link xmlns="http://docbook.org/ns/docbook" linkend="http.configuration">INI-опцию</link>'>
<!ENTITY link.http.request.option '<link xmlns="http://docbook.org/ns/docbook" linkend="http.request.options">опция запроса</link>'>
<!ENTITY link.http.request.options '<link xmlns="http://docbook.org/ns/docbook" linkend="http.request.options">опции запроса</link>'>
<!ENTITY link.http.request.info '<link xmlns="http://docbook.org/ns/docbook" linkend="http.request.info">Информация о запросе/ответе</link>'>
<!ENTITY returns.http.response 'Возвращает строку с HTTP-ответом(ами) при успешном завершении работы, или &false; при ошибке.'>
<!ENTITY returns.http.false.orexits 'Возвращает &false; или <emphasis xmlns="http://docbook.org/ns/docbook">выходит</emphasis> при успешном завершении работы'>
<!ENTITY returns.session.storage.retval 'Возвращаемое значение сессионного хранилища (обычно &true; в случае успеха, &false; в случае ошибки). Данное значение возвращается обратно в PHP для внутренней обработки.'>
<!ENTITY http.request.affects 'Влияет только на следующие методы запроса:'>
<!ENTITY http.request.affects.any 'Влияет на любой метод запроса..'>
<!ENTITY http.response.class.php51 'класс <link xmlns="http://docbook.org/ns/docbook" linkend="class.httpresponse">
<classname>HttpResponse</classname></link> если вы используете PHP 5.1.0 и выше'>
<!ENTITY http.maynotwork.SAPI 'Следующие SAPI(s) могут работать не так как ожидается:'>
<!ENTITY http.content.disposition 'Заголовок <literal xmlns="http://docbook.org/ns/docbook">Content-Disposition</literal>
очень полезен, если данные на самом деле читаются из файла или чего-то подобного, что должно быть
&quot;сохранено&quot; клиентом/пользователем (т.е. с помощью всплывающего окна браузера &quot;Сохранить как...&quot;).'>
<!ENTITY http.use.ob_start 'Используйте вместе с <function xmlns="http://docbook.org/ns/docbook">ob_start</function>.'>

<!ENTITY note.http.response.recalculate.etag.lm '<note xmlns="http://docbook.org/ns/docbook"><simpara>Вычисленные или определенные ранее <literal>ETag</literal>
и <literal>Last-Modified</literal> будут пересчитаны и переопределены заново.</simpara></note>'>
<!ENTITY note.http.throttling.yields.process '<note xmlns="http://docbook.org/ns/docbook"><simpara>Обеспечивает базовый регулирующий механизм, который будет сдерживать
текущий процесс или нить до полной отправки данных.</simpara></note>'>
<!ENTITY note.http.send.API '<note xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция должна быть использована совместно с
<function>http_send_data</function>, <function>http_send_file</function> &listendand; <function>http_send_stream</function>.</simpara></note>'>
<!ENTITY note.http.send.API.mayuse '<note xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция может быть использована совместно с
<function>http_send_data</function>, <function>http_send_file</function> &listendand; <function>http_send_stream</function>.</simpara></note>'>
<!ENTITY note.http.request.encodecookies '<note xmlns="http://docbook.org/ns/docbook"><simpara>&link.http.request.option; <literal>encodecookies</literal> контролирует
необходимость кодирования cookie функцией <function>urlencode</function>.</simpara></note>'>
<!ENTITY note.http.request.affects.any '<note xmlns="http://docbook.org/ns/docbook"><simpara>&http.request.affects.any;</simpara></note>'>
<!ENTITY note.http.ob.once '<note xmlns="http://docbook.org/ns/docbook"><simpara>Этот обработчик вывода может быть использован только один раз.</simpara></note>'>

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

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

<!-- 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.constant.available 'Эта константа доступна, если Imagick был скомпилирован с версией ImageMagick '>

<!-- 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.
 До этой версии при изменении изображения размером 200x150 до 400x300 никаких операций не происходило.
 В Imagick 3.0.0 и далее изображение будет масштабировано до размеров 400x300, так как это наилучшим образом
 соответствует ("best fit") данным размерам. Если используется параметр <parameter>bestfit</parameter>, то ширина и
 высота также должны быть определены.
</simpara>
</note>'>

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

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

<!-- 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">--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 'Экспортируемый объект Reflection.'>

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

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

<!-- SNMP -->
<!ENTITY snmp.set.type.values '<para xmlns="http://docbook.org/ns/docbook">
<acronym>MIB</acronym> указывает тип идентификатора каждого объекта. Он должен быть указан в виде одного символа из
следующего списка.
</para>
<table xmlns="http://docbook.org/ns/docbook">
 <title>types</title>
 <tgroup cols="2">
  <tbody>
   <row><entry>=</entry><entry>Тип, принимаемый MIB</entry></row>
   <row><entry>i</entry><entry>INTEGER</entry> </row>
   <row><entry>u</entry><entry>INTEGER</entry></row>
   <row><entry>s</entry><entry>STRING</entry></row>
   <row><entry>x</entry><entry>HEX STRING</entry></row>
   <row><entry>d</entry><entry>DECIMAL STRING</entry></row>
   <row><entry>n</entry><entry>NULLOBJ</entry></row>
   <row><entry>o</entry><entry>OBJID</entry></row>
   <row><entry>t</entry><entry>TIMETICKS</entry></row>
   <row><entry>a</entry><entry>IPADDRESS</entry></row>
   <row><entry>b</entry><entry>BITS</entry></row>
  </tbody>
 </tgroup>
</table>
<para xmlns="http://docbook.org/ns/docbook">
 Если при компиляции библиотеки <acronym>SNMP</acronym> была определена
 опция <constant>OPAQUE_SPECIAL_TYPES</constant>, то также могут быть использованы
 следующие типы:
</para>
<table xmlns="http://docbook.org/ns/docbook">
 <title>types</title>
 <tgroup cols="2">
  <tbody>
   <row><entry>U</entry><entry>unsigned int64</entry></row>
   <row><entry>I</entry><entry>signed int64</entry></row>
   <row><entry>F</entry><entry>float</entry></row>
   <row><entry>D</entry><entry>double</entry></row>
  </tbody>
 </tgroup>
</table>
'>
<!ENTITY snmp.set.type.values.asn.mapping '<para xmlns="http://docbook.org/ns/docbook">
Большинство этих значений используют очевидный тип ASN.1.
&apos;s&apos;, &apos;x&apos;, &apos;d&apos; и &apos;b&apos; - это
все разные способы указания значения OCTET STRING, а
беззнаковый тип &apos;u&apos; также используется для обработки
значений Gauge32.
</para>
'>
<!ENTITY snmp.set.type.values.equal.note '<para xmlns="http://docbook.org/ns/docbook">
Если MIB-файлы были загружены в MIB-дерево с помощью "snmp_read_mib"
или были указаны в конфигурационном файле libsnmp, то для указания
параметра <parameter>type</parameter> можно использовать нотацию
&apos;=&apos;, т.к. тип всех идентификаторов объектов будет автоматически
считан из MIB.
</para>
'>
<!ENTITY snmp.set.type.values.bitset.note '<para xmlns="http://docbook.org/ns/docbook">
Обратите внимание, что есть два способа установить переменную
типа BITS, например,
"SYNTAX    BITS {telnet(0), ftp(1), http(2), icmp(3), snmp(4), ssh(5), https(6)}":
</para>
<itemizedlist xmlns="http://docbook.org/ns/docbook">
 <listitem>
  <simpara>
   С помощью типа "b" и списка битовых чисел. Не рекомендуется использовать этот метод,
   т.к. GET-запрос для того же OID вернет, к примеру, 0xF8.
  </simpara>
 </listitem>
 <listitem>
  <simpara>
   С помощью типа "x" и шестнадцатеричного числа, но без(!) обычного префикса "0x".
  </simpara>
 </listitem>
</itemizedlist>
<para xmlns="http://docbook.org/ns/docbook">
 Подробнее смотрите в разделе с примерами.
</para>
'>
<!ENTITY snmp.methods.exceptions_enable.refsect '<refsect1 role="errors" xmlns="http://docbook.org/ns/docbook">
&reftitle.errors;
<para>
 Данный метод по умолчанию не генерирует исключения.
 Чтобы включить генерацию исключения SNMPException при возникновении
 некоторых ошибок данной библиотеки, необходимо установить параметр
 <parameter>exceptions_enabled</parameter> класса SNMP в
 соответствующее значение. Подробнее смотрите в <link linkend="snmp.props.exceptions-enabled">
 объяснении параметра <parameter>SNMP::$exceptions_enabled</parameter></link>.
</para>
</refsect1>
'>

<!-- Eio -->
<!ENTITY eio.callback.proto '<para xmlns="http://docbook.org/ns/docbook">
Функция <parameter xmlns="http://docbook.org/ns/docbook">callback</parameter> вызывается при завершении запроса.
Она должна удовлетворять следующему прототипу: <programlisting role="php"><![CDATA[
void callback($data, $result);
]]></programlisting>
<parameter xmlns="http://docbook.org/ns/docbook">$data</parameter> является
пользовательскими данными, переданными в запросе.
<parameter xmlns="http://docbook.org/ns/docbook">$result</parameter> содержит
результирующее значение зависящее от запроса; обычно, это значение возвращаемое соответствующим
системным вызовом.
</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>
'>