git-svn-id: https://svn.php.net/repository/phpdoc/ru/trunk@340891 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Andrey Gromov
2016-11-06 17:55:45 +00:00
parent 40f7da177a
commit 74e458d8bd
3 changed files with 287 additions and 277 deletions

View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 625495757f32dddde62c8f585675107021155bbf Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: b02aa7df13d43f1cb1efe8c905d19034735ec97c Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
<!-- Keep 'em sorted -->
@ -136,7 +136,7 @@ xmlns="http://docbook.org/ns/docbook"><simpara>Эта функция была п
<!ENTITY warn.deprecated.func-5-5-0 '<warning xmlns="http://docbook.org/ns/docbook">
<simpara>Эта функция была помечена <emphasis>УСТАРЕВШЕЙ</emphasis> начиная с версии
PHP 5.5.0. Крайне не рекомендуется полагаться на эту функцию.</simpara></warning>'>
PHP 5.5.0. Крайне не рекомендуется полагаться на эту функцию.</simpara></warning>'>
<!ENTITY warn.deprecated.feature-5-5-0.removed-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Эта функциональность считается
@ -378,11 +378,11 @@ latin2 (более высокое число соответствует боль
<!ENTITY gd.font.size 'Размер шрифта. В зависимости от вашей версии GD, он должен быть указан либо в пикселах (GD1) либо в типографских пунктах (GD2).'>
<!ENTITY gd.constants.types '<simpara xmlns="http://docbook.org/ns/docbook">
Used as a return value by <function>imagetypes</function>
Used as a return value by <function>imagetypes</function>
</simpara>'>
<!ENTITY gd.constants.color '<simpara xmlns="http://docbook.org/ns/docbook">Специальный вариант цвета, который может быть использован вместо определенного с помощью
<function>imagecolorallocate</function> и <function>imagecolorallocatealpha</function>.
<function>imagecolorallocate</function> и <function>imagecolorallocatealpha</function>.
</simpara>'>
<!ENTITY gd.constants.affine '<simpara xmlns="http://docbook.org/ns/docbook">Константа типа аффинного преобразования, используется с функцией <function>imageaffinematrixget</function> .</simpara>'>
@ -394,23 +394,23 @@ latin2 (более высокое число соответствует боль
<!ENTITY gd.constants.effect '<simpara xmlns="http://docbook.org/ns/docbook">Эффект альфа-смешения, используется с функцией <function>imagelayereffect</function>.</simpara>'>
<!ENTITY gd.constants.filter '<simpara xmlns="http://docbook.org/ns/docbook">
Специальный фильтр GD, используется с функцией <function>imagefilter</function>.
Специальный фильтр GD, используется с функцией <function>imagefilter</function>.
</simpara>'>
<!ENTITY gd.constants.type '<simpara xmlns="http://docbook.org/ns/docbook">
Константа типа изображения, используется с функциями <function>image_type_to_mime_type</function> и <function>image_type_to_extension</function>.
Константа типа изображения, используется с функциями <function>image_type_to_mime_type</function> и <function>image_type_to_extension</function>.
</simpara>'>
<!ENTITY gd.constants.png-filter '<simpara xmlns="http://docbook.org/ns/docbook">
Специальный фильтр PNG filter, используется с функцией <function>imagepng</function>.
Специальный фильтр PNG filter, используется с функцией <function>imagepng</function>.
</simpara>'>
<!ENTITY gd.constants.flip '<simpara xmlns="http://docbook.org/ns/docbook">
Используется с функцией <function>imageflip</function>, доступна с PHP 5.5.0.
Используется с функцией <function>imageflip</function>, доступна с PHP 5.5.0.
</simpara>'>
<!ENTITY gd.constants.interpolation '<simpara xmlns="http://docbook.org/ns/docbook">
Используется с функцией <function>imagesetinterpolation</function>, доступна с PHP 5.5.0.
Используется с функцией <function>imagesetinterpolation</function>, доступна с PHP 5.5.0.
</simpara>'>
<!-- DBM notes -->
@ -422,12 +422,12 @@ dbm_identifier</parameter></term><listitem><para>Идентификатор со
<!-- JSON notes -->
<!ENTITY json.implementation.superset '
<note xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<para>
PHP реализует надмножество JSON, который описан в первоначальном
<link xlink:href="&url.rfc;7159">RFC 7159</link>.
</para>
</note>
<note xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<para>
PHP реализует надмножество JSON, который описан в первоначальном
<link xlink:href="&url.rfc;7159">RFC 7159</link>.
</para>
</note>
'>
<!-- cURL notes -->
@ -441,32 +441,32 @@ dbm_identifier</parameter></term><listitem><para>Идентификатор со
<!-- dbase notes -->
<!ENTITY dbase.type-conversion '<para xmlns="http://docbook.org/ns/docbook">
Каждое поле преобразуется в соответствующий тип PHP, за исключением:
<itemizedlist>
<listitem>
<simpara>
Date преобразуется в строку.
</simpara>
</listitem>
<listitem>
<simpara>
DateTime преобразуется в строку.
</simpara>
</listitem>
<listitem>
<simpara>
Целые, выходящие из диапазона
<constant>PHP_INT_MIN</constant>..<constant>PHP_INT_MAX</constant> преобразуются в строки.
</simpara>
</listitem>
<listitem>
<simpara>
До dbase 7.0.0, логические значение (<literal>L</literal>) преобразуются в
<literal>1</literal> или <literal>0</literal>.
</simpara>
</listitem>
</itemizedlist>
</para>'>
Каждое поле преобразуется в соответствующий тип PHP, за исключением:
<itemizedlist>
<listitem>
<simpara>
Date преобразуется в строку.
</simpara>
</listitem>
<listitem>
<simpara>
DateTime преобразуется в строку.
</simpara>
</listitem>
<listitem>
<simpara>
Целые, выходящие из диапазона
<constant>PHP_INT_MIN</constant>..<constant>PHP_INT_MAX</constant> преобразуются в строки.
</simpara>
</listitem>
<listitem>
<simpara>
До dbase 7.0.0, логические значение (<literal>L</literal>) преобразуются в
<literal>1</literal> или <literal>0</literal>.
</simpara>
</listitem>
</itemizedlist>
</para>'>
<!-- IMAP notes -->
@ -588,9 +588,9 @@ linkend="memcached.expiration" xmlns="http://docbook.org/ns/docbook">Время
</simpara>'>
<!ENTITY date.timezone.posix-signs '<simpara xmlns="http://docbook.org/ns/docbook">
Если вы игнорируете вышестоящее предупреждение, то учтите, что
база данных временных зон IANA, которая используется для временных зон PHP,
поддерживает использование POSIX-стиля знаков, поэтому обозначения временных зон
Если вы игнорируете вышестоящее предупреждение, то учтите, что
база данных временных зон IANA, которая используется для временных зон PHP,
поддерживает использование POSIX-стиля знаков, поэтому обозначения временных зон
Etc/GMT+n и Etc/GMT-n обратны общепринятым.
</simpara>
<simpara xmlns="http://docbook.org/ns/docbook">
@ -681,12 +681,12 @@ object</parameter></term><listitem><para>Только для процедурн
может генерировать ошибки уровня <constant>E_WARNING</constant> при обнаружении
плохой разметки. Для обработки данных ошибок можно воспользоваться
<link linkend="function.libxml-use-internal-errors">функциями обработки
ошибок libxml</link>.</para>'>
ошибок libxml</link>.</para>'>
<!-- Dom Examples -->
<!ENTITY dom.book.example '<para xmlns="http://docbook.org/ns/docbook">Следующие примеры используют файл <filename>book.xml</filename>, который содержит следующие данные:</para>
<programlisting role="xml" xmlns="http://docbook.org/ns/docbook">
<!-- Warning: The CDATA markup here is a little tricky. Please DO NOT BREAK it! -->
<!-- Warning: The CDATA markup here is a little tricky. Please DO NOT BREAK it! -->
<![CDATA[
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE books [
@ -736,13 +736,13 @@ object</parameter></term><listitem><para>Только для процедурн
</simpara></note>'>
<!ENTITY ini.scanner.typed '<para xmlns="http://docbook.org/ns/docbook">
С версии PHP 5.6.1 также можео задать <constant>INI_SCANNER_TYPED</constant>.
С версии PHP 5.6.1 также можео задать <constant>INI_SCANNER_TYPED</constant>.
В этом режиме типы boolean, null и integer будут, по возможности, сохраняться.
Строковые значения <literal>"true"</literal>, <literal>"on"</literal> и <literal>"yes"</literal>
будут преобразованы в &true;. <literal>"false"</literal>, <literal>"off"</literal>, <literal>"no"</literal>
и <literal>"none"</literal> в &false;. <literal>"null"</literal> преобразуется в &null;.
Строковые значения <literal>"true"</literal>, <literal>"on"</literal> и <literal>"yes"</literal>
будут преобразованы в &true;. <literal>"false"</literal>, <literal>"off"</literal>, <literal>"no"</literal>
и <literal>"none"</literal> в &false;. <literal>"null"</literal> преобразуется в &null;.
Также, все числовые строки будут, по возможности, преобразованы к целым числам.
</para>'>
</para>'>
<!-- GNUPG -->
<!ENTITY gnupg.identifier '<para xmlns="http://docbook.org/ns/docbook">Идентификатор gnupg, полученный из
@ -807,7 +807,7 @@ object</parameter></term><listitem><para>Только для процедурн
</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 по причинам безопасности.
<constant>OCI_CRED_EXT</constant> не поддерживается в Windows по причинам безопасности.
</para>'>
<!ENTITY oci.datatypes '<para xmlns="http://docbook.org/ns/docbook">За подробностями по операции отображения типов данных, осуществляемым расширением OCI8, обратитесь к <link linkend="oci8.datatypes">типам данных, поддерживаемых драйвером</link></para>'>
@ -932,7 +932,8 @@ PECL расширений</link>. Дополнительная информац
<!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.legacy.building">сборка на Windows</link>.'>
<!ENTITY pecl.windows.download.avail 'Бинарные файлы Windows (файлы <acronym xmlns="http://docbook.org/ns/docbook">DLL</acronym>)
для этого расширения <acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym> доступны на сайте PECL.'>
<!ENTITY pecl.windows.download.unbundled '&pecl.windows.download;'>
<!ENTITY pecl.moved-ver 'Это расширение было перемещено в репозиторий
@ -1013,7 +1014,7 @@ stmt</parameter></term><listitem><para>Только для процедурно
linkend="book.mysqlnd">mysqlnd</link>.'>
<!ENTITY mysqli.charset.note '<note xmlns="http://docbook.org/ns/docbook">
<para>MySQLnd всегда подразумевает кодировку, которую использует по умолчанию сервер. Эта кодировка передается во время
установки соединения/авторизации, которые использует mysqlnd.</para><para>Libmysqlclient по умолчанию использует
установки соединения/авторизации, которые использует mysqlnd.</para><para>Libmysqlclient по умолчанию использует
кодировку, установленную в <filename>my.cnf</filename> или специальным вызовом <function>mysqli_options</function> до
использования <function>mysqli_real_connect</function>, но после <function>mysqli_init</function>.</para></note>'>
@ -1599,19 +1600,19 @@ PHP скомпилирован с поддержкой libxml 20620 или ст
void callback(mixed $data, int $result[, resource $req]);
]]></programlisting>
<variablelist xmlns="http://docbook.org/ns/docbook">
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>data</parameter></term>
<listitem><para>является пользовательскими данными, переданными в запросе.</para></listitem>
</varlistentry>
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>result</parameter></term>
<listitem><para>содержит результирующее значение, зависящее от запроса; обычно это значение, возвращаемое соответствующим
системным вызовом.</para></listitem>
</varlistentry>
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>req</parameter></term>
<listitem><para>является опциональным запрашиваемым ресурсом, который может использоваться с такими функциями как <function>eio_get_last_error</function></para></listitem>
</varlistentry>
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>data</parameter></term>
<listitem><para>является пользовательскими данными, переданными в запросе.</para></listitem>
</varlistentry>
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>result</parameter></term>
<listitem><para>содержит результирующее значение, зависящее от запроса; обычно это значение, возвращаемое соответствующим
системным вызовом.</para></listitem>
</varlistentry>
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>req</parameter></term>
<listitem><para>является опциональным запрашиваемым ресурсом, который может использоваться с такими функциями как <function>eio_get_last_error</function></para></listitem>
</varlistentry>
</variablelist>
</para>
'>
@ -1698,8 +1699,8 @@ xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docb
<!ENTITY mongo.mongowritebatch.writeoptions.description '<listitem xmlns="http://docbook.org/ns/docbook"><para>Массив опций записи.<informaltable><thead><row><entry>ключ</entry><entry>значение</entry></row></thead><tbody><row><entry>w (int|string)</entry><entry>Значения <link linkend="mongo.writeconcerns">контроля записи</link></entry></row><row><entry>wtimeout (int)</entry><entry><link linkend="mongo.writeconcerns">Максимальное время ожидания репликации</link></entry></row><row><entry>ordered</entry><entry>Определяет, должна ли MongoDB применять этот пакет в определенном по порядку. Упорядоченная запись запускается последовательно (по одному элементу за раз) и запись прекращается после первой же ошибки. Неупорядоченная запись может запускаться параллельно и ошибки не приводят к остановке записи. По умолчанию &true;</entry></row><row><entry>j (bool)</entry><entry>Ожидать журналирование на основном сервере (primary). Не рекомендуется, используйте вместо него опцию Контроля Записи (WriteConcern)</entry></row><row><entry>fsync (bool)</entry><entry>Ожидать fsync на основном сервере (primary). Не рекомендуется, используйте вместо него опцию Контроля Записи (WriteConcern)</entry></row></tbody></informaltable></para></listitem>'>
<!ENTITY mongo.mongowritebatch.collection.description '<listitem xmlns="http://docbook.org/ns/docbook"><para>Объект <classname>MongoCollection</classname> для выполняемого пакета. Его опции <link linkend="mongo.writeconcerns">контроля записи</link> будут скопированы и использованы по умолчанию, если не будут переданы через <parameter>$write_options</parameter> или <methodname>MongoWriteBatch::execute</methodname>.</para></listitem>'>
<!ENTITY mongo.context.server ' <varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>server</parameter> </term> <listitem> <para> Массив, содержащий основную информацию о выбранном сервере. <informaltable> <tgroup cols="2"> <thead> <row> <entry>ключ</entry> <entry>значение</entry> </row> </thead> <tbody> <row> <entry>hash</entry> <entry>хэш сервера, например: <literal>localhost:27017;-;X;56052</literal></entry> </row> <row> <entry>type</entry> <entry>Тип узла (primary/secondary/mongos/arbiter): <literal>2</literal></entry> </row> <row> <entry>max_bson_size</entry> <entry>максимальный размер BSON, который этот узел поддерживает: <literal>16777216</literal></entry> </row> <row> <entry>max_message_size</entry> <entry>Максимальный размер сообщения, который этот узел поддерживает: <literal>48000000</literal></entry> </row> <row> <entry>request_id</entry> <entry>Идентификатор запроса для этого сообщения: <literal>42</literal></entry> </row> </tbody> </tgroup> </informaltable> </para> </listitem> </varlistentry>'>
<!ENTITY mongo.context.writeoptions '<varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>writeOptions</parameter> </term> <listitem> <para> <informaltable> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>ordered</entry> <entry>булево, если операция (в случае пакетных операций) должна выполняться последовательно (ordered=true)</entry> </row> <row> <entry>writeConcern</entry> <entry>Массив опций контроля записи (writeConcern, смотри ниже)</entry> </row> </tbody> </tgroup> </informaltable> <table> <title>значения массива writeConcern</title> <tgroup cols="2"> <thead> <row> <entry>ключ</entry> <entry>значение</entry> </row> </thead> <tbody> <row> <entry>fsync</entry> <entry>булево, сбрасывать на диск перед запуском</entry> </row> <row> <entry>j</entry> <entry>булево, записывать в журнал перед запуском</entry> </row> <row> <entry>wtimeout</entry> <entry>целое число, миллисекунды, максимальное время, которое основной сервер (primary) ждет подтверждение репликации</entry> </row> <row> <entry>w</entry> <entry>integer=число серверов, или string=тэг-репликации</entry> </row> </tbody> </tgroup> </table> </para> </listitem> </varlistentry>'>
<!ENTITY mongo.context.protocoloptions ' <varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>protocolOptions</parameter> </term> <listitem> <para> <informaltable> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>message_length</entry> <entry>Общий размер в байтах закодированного сообщения, отправляемого по сети</entry> </row> <row> <entry>request_id</entry> <entry>Идентификатор для сообщения: <literal>42</literal></entry> </row> <row> <entry>namespace</entry> <entry>Пространство имен MongoDB , используемого для сообщений протокола <literal>dbname.collectionname</literal></entry> </row> </tbody> </tgroup> </informaltable> </para> </listitem> </varlistentry>'>
<!ENTITY mongo.context.writeoptions '<varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>writeOptions</parameter> </term> <listitem> <para> <informaltable> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>ordered</entry> <entry>булево, если операция (в случае пакетных операций) должна выполняться последовательно (ordered=true)</entry> </row> <row> <entry>writeConcern</entry> <entry>Массив опций контроля записи (writeConcern, смотри ниже)</entry> </row> </tbody> </tgroup> </informaltable> <table> <title>значения массива writeConcern</title> <tgroup cols="2"> <thead> <row> <entry>ключ</entry> <entry>значение</entry> </row> </thead> <tbody> <row> <entry>fsync</entry> <entry>булево, сбрасывать на диск перед запуском</entry> </row> <row> <entry>j</entry> <entry>булево, записывать в журнал перед запуском</entry> </row> <row> <entry>wtimeout</entry> <entry>целое число, миллисекунды, максимальное время, которое основной сервер (primary) ждет подтверждение репликации</entry> </row> <row> <entry>w</entry> <entry>integer=число серверов, или string=тэг-репликации</entry> </row> </tbody> </tgroup> </table> </para> </listitem> </varlistentry>'>
<!ENTITY mongo.context.protocoloptions ' <varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>protocolOptions</parameter> </term> <listitem> <para> <informaltable> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>message_length</entry> <entry>Общий размер в байтах закодированного сообщения, отправляемого по сети</entry> </row> <row> <entry>request_id</entry> <entry>Идентификатор для сообщения: <literal>42</literal></entry> </row> <row> <entry>namespace</entry> <entry>Пространство имен MongoDB , используемого для сообщений протокола <literal>dbname.collectionname</literal></entry> </row> </tbody> </tgroup> </informaltable> </para> </listitem> </varlistentry>'>
<!ENTITY mongo.alternative.class.note '<para
xmlns="http://docbook.org/ns/docbook">Расширение, задающее этот класс, объявлено устаревшим. Вместо него используйте расширение <link linkend="set.mongodb">MongoDB</link>.
Есть такие альтернативы:</para>'>
@ -1721,112 +1722,112 @@ xmlns="http://docbook.org/ns/docbook">Это расширение объявле
<!-- mongodb -->
<!ENTITY mongodb.option.collation '
<row xmlns="http://docbook.org/ns/docbook">
<entry>collation</entry>
<entry><type>array|object</type></entry>
<entry>
<para>
<link xlink:href="&url.mongodb.docs.collation;" xmlns:xlink="http://www.w3.org/1999/xlink">Сопоставление</link> позволяет пользователям указывать специфичные для конкретного языка правила для сравнения строк, такие как реакцию на регистр букв и надстрочные знаки. Если задано сопоставление, то поле <literal>"locale"</literal> также обязательно. Описание полей смотрите в разделе <link xlink:href="&url.mongodb.docs.collation;#collation-document" xmlns:xlink="http://www.w3.org/1999/xlink">Сопоставление</link>.
</para>
<para>
Если сопоставление не задано явно, но у коллекции определено сопоставление по умолчанию, то будет использовано оно. Если нет ни того ни того, то MongoDB будет использовать простое бинарное сравнение строк.
</para>
<para>
Эта опция доступна в MongoDB 3.4+ и, если будет использована для более старых версий, вызовет исключение во время исполнения.
</para>
</entry>
</row>
<row xmlns="http://docbook.org/ns/docbook">
<entry>collation</entry>
<entry><type>array|object</type></entry>
<entry>
<para>
<link xlink:href="&url.mongodb.docs.collation;" xmlns:xlink="http://www.w3.org/1999/xlink">Сопоставление</link> позволяет пользователям указывать специфичные для конкретного языка правила для сравнения строк, такие как реакцию на регистр букв и надстрочные знаки. Если задано сопоставление, то поле <literal>"locale"</literal> также обязательно. Описание полей смотрите в разделе <link xlink:href="&url.mongodb.docs.collation;#collation-document" xmlns:xlink="http://www.w3.org/1999/xlink">Сопоставление</link>.
</para>
<para>
Если сопоставление не задано явно, но у коллекции определено сопоставление по умолчанию, то будет использовано оно. Если нет ни того ни того, то MongoDB будет использовать простое бинарное сравнение строк.
</para>
<para>
Эта опция доступна в MongoDB 3.4+ и, если будет использована для более старых версий, вызовет исключение во время исполнения.
</para>
</entry>
</row>
'>
<!ENTITY mongodb.parameter.namespace '
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>namespace</parameter> (<type>string</type>)</term>
<listitem>
<para>
Полностью определенное имя (т.е. <literal>"databaseName.collectionName"</literal>).
</para>
</listitem>
</varlistentry>
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>namespace</parameter> (<type>string</type>)</term>
<listitem>
<para>
Полностью определенное имя (т.е. <literal>"databaseName.collectionName"</literal>).
</para>
</listitem>
</varlistentry>
'>
<!ENTITY mongodb.parameter.db '
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>db</parameter> (<type>string</type>)</term>
<listitem>
<para>
Имя базы данных, в которой запускается комманда.
</para>
</listitem>
</varlistentry>
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>db</parameter> (<type>string</type>)</term>
<listitem>
<para>
Имя базы данных, в которой запускается комманда.
</para>
</listitem>
</varlistentry>
'>
<!ENTITY mongodb.parameter.bulkwrite '
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>bulk</parameter> (<type>MongoDB\Driver\BulkWrite</type>)</term>
<listitem>
<para>
<classname>MongoDB\Driver\BulkWrite</classname> для выполнения.
</para>
</listitem>
</varlistentry>
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>bulk</parameter> (<type>MongoDB\Driver\BulkWrite</type>)</term>
<listitem>
<para>
<classname>MongoDB\Driver\BulkWrite</classname> для выполнения.
</para>
</listitem>
</varlistentry>
'>
<!ENTITY mongodb.parameter.command '
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>command</parameter> (<type>MongoDB\Driver\Command</type>)</term>
<listitem>
<para>
<classname>MongoDB\Driver\Command</classname> для выполнения.
</para>
</listitem>
</varlistentry>
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>command</parameter> (<type>MongoDB\Driver\Command</type>)</term>
<listitem>
<para>
<classname>MongoDB\Driver\Command</classname> для выполнения.
</para>
</listitem>
</varlistentry>
'>
<!ENTITY mongodb.parameter.query '
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>query</parameter> (<type>MongoDB\Driver\Query</type>)</term>
<listitem>
<para>
The <classname>MongoDB\Driver\Query</classname> для выполнения.
</para>
</listitem>
</varlistentry>
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>query</parameter> (<type>MongoDB\Driver\Query</type>)</term>
<listitem>
<para>
The <classname>MongoDB\Driver\Query</classname> для выполнения.
</para>
</listitem>
</varlistentry>
'>
<!ENTITY mongodb.parameter.readPreference '
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>readPreference</parameter> (<type>MongoDB\Driver\ReadPreference</type>)</term>
<listitem>
<para>
Опционально <classname>MongoDB\Driver\ReadPreference</classname> для выбора сервера для этой операции. Если не задано, то он будет выбран из <link linkend="mongodb-driver-manager.construct-uri">URI соединения MongoDB</link>.
</para>
</listitem>
</varlistentry>
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>readPreference</parameter> (<type>MongoDB\Driver\ReadPreference</type>)</term>
<listitem>
<para>
Опционально <classname>MongoDB\Driver\ReadPreference</classname> для выбора сервера для этой операции. Если не задано, то он будет выбран из <link linkend="mongodb-driver-manager.construct-uri">URI соединения MongoDB</link>.
</para>
</listitem>
</varlistentry>
'>
<!ENTITY mongodb.parameter.typeMap '
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>typeMap</parameter> (<type>array</type>)</term>
<listitem>
<para>
<link linkend="mongodb.persistence.typemaps">Конфигурация карты типов</link>.
</para>
</listitem>
</varlistentry>
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>typeMap</parameter> (<type>array</type>)</term>
<listitem>
<para>
<link linkend="mongodb.persistence.typemaps">Конфигурация карты типов</link>.
</para>
</listitem>
</varlistentry>
'>
<!ENTITY mongodb.parameter.writeConcern '
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>writeConcern</parameter> (<type>MongoDB\Driver\WriteConcern</type>)</term>
<listitem>
<para>
Опционально <classname>MongoDB\Driver\WriteConcern</classname> для наложения на операцию записи. Если не задано, то будет использовано значение из <link linkend="mongodb-driver-manager.construct-uri">URI соединения MongoDB</link>.
</para>
</listitem>
</varlistentry>
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>writeConcern</parameter> (<type>MongoDB\Driver\WriteConcern</type>)</term>
<listitem>
<para>
Опционально <classname>MongoDB\Driver\WriteConcern</classname> для наложения на операцию записи. Если не задано, то будет использовано значение из <link linkend="mongodb-driver-manager.construct-uri">URI соединения MongoDB</link>.
</para>
</listitem>
</varlistentry>
'>
<!ENTITY mongodb.parameter.filter '
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>filter</parameter> (<type>array|object</type>)</term>
<listitem>
<para>
<link xlink:href="&url.mongodb.docs;tutorial/query-documents/" xmlns:xlink="http://www.w3.org/1999/xlink">Предикат запроса</link>.
Пустой предикат совпадет со всеми элементами коллекции.
</para>
</listitem>
</varlistentry>
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>filter</parameter> (<type>array|object</type>)</term>
<listitem>
<para>
<link xlink:href="&url.mongodb.docs;tutorial/query-documents/" xmlns:xlink="http://www.w3.org/1999/xlink">Предикат запроса</link>.
Пустой предикат совпадет со всеми элементами коллекции.
</para>
</listitem>
</varlistentry>
'>
<!ENTITY mongodb.returns.cursor '<para xmlns="http://docbook.org/ns/docbook">В случае успеха возвращает <classname>MongoDB\Driver\Cursor</classname>.</para>'>
<!ENTITY mongodb.returns.writeresult '<para xmlns="http://docbook.org/ns/docbook">В случае успеха возвращает <classname>MongoDB\Driver\WriteResult</classname>.</para>'>
@ -1836,44 +1837,44 @@ xmlns="http://docbook.org/ns/docbook">Это расширение объявле
<!ENTITY mongodb.throws.authentication '<member xmlns="http://docbook.org/ns/docbook">При неудачной аутентификации бросает исключение <classname>MongoDB\Driver\Exception\AuthenticationException</classname>.</member>'>
<!ENTITY mongodb.throws.connection '<member xmlns="http://docbook.org/ns/docbook">При неудачном соединении с сервером (кроме ошибок аутентификации), бросает исключение <classname>MongoDB\Driver\Exception\ConnectionException</classname>.</member>'>
<!ENTITY mongodb.note.decimal128 '
<note xmlns="http://docbook.org/ns/docbook">
<simpara>
<classname>MongoDB\BSON\Decimal128</classname> совместим только с
MongoDB 3.4+. При попытке использовать тип BSON с более ранними версиями приведет
к ошибке.
</simpara>
</note>
<note xmlns="http://docbook.org/ns/docbook">
<simpara>
<classname>MongoDB\BSON\Decimal128</classname> совместим только с
MongoDB 3.4+. При попытке использовать тип BSON с более ранними версиями приведет
к ошибке.
</simpara>
</note>
'>
<!ENTITY mongodb.note.forking '
<tip xmlns="http://docbook.org/ns/docbook">
<simpara>
На Unix, драйвер MongoDB чувствителен к сценариям, которые используют
системный вызов fork() без последующего exec(). Пользователям рекомендуется
не переиспользовать экземпляр <classname>MongoDB\Driver\Manager</classname>
в дочернем процессе.
child process.
</simpara>
</tip>
<tip xmlns="http://docbook.org/ns/docbook">
<simpara>
На Unix, драйвер MongoDB чувствителен к сценариям, которые используют
системный вызов fork() без последующего exec(). Пользователям рекомендуется
не переиспользовать экземпляр <classname>MongoDB\Driver\Manager</classname>
в дочернем процессе.
child process.
</simpara>
</tip>
'>
<!ENTITY mongodb.note.getwriteerrors '
<note xmlns="http://docbook.org/ns/docbook">
<para>
При неудачной записи,
<methodname>MongoDB\Driver\WriteResult::getWriteErrors</methodname> выдаст массив содержащий только одну ошибку <classname>MongoDB\Driver\WriteError</classname>,
и <methodname>MongoDB\Driver\WriteError::getIndex</methodname>
всегда будет возвращать 0 (индекс операции в пачке).
</para>
</note>
<note xmlns="http://docbook.org/ns/docbook">
<para>
При неудачной записи,
<methodname>MongoDB\Driver\WriteResult::getWriteErrors</methodname> выдаст массив содержащий только одну ошибку <classname>MongoDB\Driver\WriteError</classname>,
и <methodname>MongoDB\Driver\WriteError::getIndex</methodname>
всегда будет возвращать 0 (индекс операции в пачке).
</para>
</note>
'>
<!ENTITY mongodb.note.getupsertedids '
<note xmlns="http://docbook.org/ns/docbook">
<para>
<methodname>MongoDB\Driver\WriteResult::getUpsertedIds</methodname> всегда имеет только один элемент <classname>BSON\ObjectID</classname> в массиве,
и его индекс всегда будет 0 (индекс операции в пачке).
</para>
</note>
<note xmlns="http://docbook.org/ns/docbook">
<para>
<methodname>MongoDB\Driver\WriteResult::getUpsertedIds</methodname> всегда имеет только один элемент <classname>BSON\ObjectID</classname> в массиве,
и его индекс всегда будет 0 (индекс операции в пачке).
</para>
</note>
'>
<!-- Radius -->
<!-- Radius -->
<!ENTITY radius.request.required '<note xmlns="http://docbook.org/ns/docbook"><para>Перед вызовом данной функции необходимо создать запрос с помощью функции <function>radius_create_request</function>.</para></note>'>
<!ENTITY radius.parameter.attribute-type '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>type</parameter></term><listitem><para>Тип атрибута.</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.handle '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>radius_handle</parameter></term><listitem><para>Ресурс RADIUS.</para></listitem></varlistentry>'>
@ -1883,17 +1884,17 @@ xmlns="http://docbook.org/ns/docbook">Это расширение объявле
<!-- posix snippets -->
<!ENTITY posix.parameter.fd '<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>fd</parameter></term>
<listitem>
<para>
Файловый дескриптор, который ожидается в виде или ресурса <type>resource</type>
или целого числа <type>integer</type>. Под <type>integer</type> подразумевается
файловый дескриптор, который можно передать непосредственно в базовый системный вызов.
</para>
<para>
В большинстве случаев, вам нужно будет передавать файловый <type>resource</type>.
</para>
</listitem>
<term><parameter>fd</parameter></term>
<listitem>
<para>
Файловый дескриптор, который ожидается в виде или ресурса <type>resource</type>
или целого числа <type>integer</type>. Под <type>integer</type> подразумевается
файловый дескриптор, который можно передать непосредственно в базовый системный вызов.
</para>
<para>
В большинстве случаев, вам нужно будет передавать файловый <type>resource</type>.
</para>
</listitem>
</varlistentry>'>
<!ENTITY posix.rlimits '
@ -1908,52 +1909,52 @@ xmlns="http://docbook.org/ns/docbook">Это расширение объявле
<!-- strings snippets -->
<!ENTITY strings.parameter.encoding '
<para xmlns="http://docbook.org/ns/docbook">
Необязательный аргумент определяющий кодировку, используемую при конвертации симоволов.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Необязательный аргумент определяющий кодировку, используемую при конвертации симоволов.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Если не указан, то значением по умолчанию для <parameter>encoding</parameter> зависит
от используемой версии PHP. В PHP 5.6 и старше, для значения по умолчанию используется
конфигурационная опция <link linkend="ini.default-charset">default_charset</link>.
В PHP 5.4 и 5.5 используется <literal>UTF-8</literal> по умолчанию. Более ранние версии PHP
используют <literal>ISO-8859-1</literal>.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Если не указан, то значением по умолчанию для <parameter>encoding</parameter> зависит
от используемой версии PHP. В PHP 5.6 и старше, для значения по умолчанию используется
конфигурационная опция <link linkend="ini.default-charset">default_charset</link>.
В PHP 5.4 и 5.5 используется <literal>UTF-8</literal> по умолчанию. Более ранние версии PHP
используют <literal>ISO-8859-1</literal>.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Хотя этот аргумент является технически необязательным, настоятельно рекомендуется
  указать правильное значение для вашего кода, если вы используете PHP 5.5 или выше,
  или если ваша опция конфигурации <link linkend="ini.default-charset">default_charset</link>
  может быть задана неверно для входных данных.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Хотя этот аргумент является технически необязательным, настоятельно рекомендуется
указать правильное значение для вашего кода, если вы используете PHP 5.5 или выше,
или если ваша опция конфигурации <link linkend="ini.default-charset">default_charset</link>
может быть задана неверно для входных данных.
</para>
'>
<!ENTITY strings.changelog.encoding '
<row xmlns="http://docbook.org/ns/docbook">
<entry>5.6.0</entry>
<entry>
Значение по умолчанию для параметра <parameter>encoding</parameter> было изменено
на значение конфигурационной опции <link linkend="ini.default-charset">default_charset</link>.
</entry>
</row>
<row xmlns="http://docbook.org/ns/docbook">
<entry>5.6.0</entry>
<entry>
Значение по умолчанию для параметра <parameter>encoding</parameter> было изменено
на значение конфигурационной опции <link linkend="ini.default-charset">default_charset</link>.
</entry>
</row>
'>
<!-- filter snippets -->
<!ENTITY filter.param.filter '
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>filter</parameter></term>
<listitem>
<para>
Идентификатор (ID) применяемого фильтра. На странице <xref linkend="filter.filters" />
приведен список доступных фильтров.
</para>
<para>
Если не указан, то используется <constant>FILTER_DEFAULT</constant>, который
равнозначен <link linkend="filter.filters.sanitize"><constant>FILTER_UNSAFE_RAW</constant></link>.
Это значит, что по умолчанию не применяется никакого фильтра.
</para>
</listitem>
</varlistentry>
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>filter</parameter></term>
<listitem>
<para>
Идентификатор (ID) применяемого фильтра. На странице <xref linkend="filter.filters" />
приведен список доступных фильтров.
</para>
<para>
Если не указан, то используется <constant>FILTER_DEFAULT</constant>, который
равнозначен <link linkend="filter.filters.sanitize"><constant>FILTER_UNSAFE_RAW</constant></link>.
Это значит, что по умолчанию не применяется никакого фильтра.
</para>
</listitem>
</varlistentry>
'>
<!-- csprng snippets -->
@ -1988,51 +1989,51 @@ xmlns="http://docbook.org/ns/docbook">Это расширение объявле
</itemizedlist>
'>
<!ENTITY csprng.errors '
<listitem xmlns="http://docbook.org/ns/docbook">
<simpara>
Если подходящие источники случайных величин отсутствуют, то бросается исключение
<classname>Exception</classname>.
</simpara>
</listitem>
<listitem xmlns="http://docbook.org/ns/docbook">
<simpara>
Если задан некорректный параметр, то бросается исключение <classname>TypeError</classname>.
</simpara>
</listitem>
<listitem xmlns="http://docbook.org/ns/docbook">
<simpara>
Если подходящие источники случайных величин отсутствуют, то бросается исключение
<classname>Exception</classname>.
</simpara>
</listitem>
<listitem xmlns="http://docbook.org/ns/docbook">
<simpara>
Если задан некорректный параметр, то бросается исключение <classname>TypeError</classname>.
</simpara>
</listitem>
'>
<!ENTITY csprng.function.backport '
<note xmlns="http://docbook.org/ns/docbook">
<simpara>
Эта функция была добавлена в PHP 7.0, а для версий с 5.2 по 5.2, существуют ее
<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.csprng.compat;">пользовательские реализации</link>.
</simpara>
</note>
<note xmlns="http://docbook.org/ns/docbook">
<simpara>
Эта функция была добавлена в PHP 7.0, а для версий с 5.2 по 5.2, существуют ее
<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.csprng.compat;">пользовательские реализации</link>.
</simpara>
</note>
'>
<!-- Migration Guide snippets -->
<!ENTITY migration56.openssl.peer-verification '
<para xmlns="http://docbook.org/ns/docbook">
Все шифруемые клиентские потоки теперь по умолчанию включают проверку пиров.
По умолчанию используется OpenSSL CA пакет для проверки сертификата
пира. В большинстве случаев не требуется ничего делать для
соединения с серверами с правильным SSL сертификатом, так как обычно
OpenSSL уже настроен для использования хороших CA пакетов.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Все шифруемые клиентские потоки теперь по умолчанию включают проверку пиров.
По умолчанию используется OpenSSL CA пакет для проверки сертификата
пира. В большинстве случаев не требуется ничего делать для
соединения с серверами с правильным SSL сертификатом, так как обычно
OpenSSL уже настроен для использования хороших CA пакетов.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Стандартный CA пакет может быть переопределен глобально с помощью
установки или openssl.cafile или openssl.capath строк конфигурации,
или же на уровне каждого запроса используя опции контекста
<link linkend="context.ssl.cafile"><parameter>cafile</parameter></link> или
<link linkend="context.ssl.capath"><parameter>capath</parameter></link>.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Стандартный CA пакет может быть переопределен глобально с помощью
установки или openssl.cafile или openssl.capath строк конфигурации,
или же на уровне каждого запроса используя опции контекста
<link linkend="context.ssl.cafile"><parameter>cafile</parameter></link> или
<link linkend="context.ssl.capath"><parameter>capath</parameter></link>.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Хотя это и не рекомендуется, но можно отклчить проверку сертификата пира
для запроса, установив <link linkend="context.ssl.verify-peer"><parameter>verify_peer</parameter></link>
опцию контекста в &false;, и можно отключить проверку имени пира, установив
<link linkend="context.ssl.verify-peer-name"><parameter>verify_peer_name</parameter></link> в &false;.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Хотя это и не рекомендуется, но можно отклчить проверку сертификата пира
для запроса, установив <link linkend="context.ssl.verify-peer"><parameter>verify_peer</parameter></link>
опцию контекста в &false;, и можно отключить проверку имени пира, установив
<link linkend="context.ssl.verify-peer-name"><parameter>verify_peer_name</parameter></link> в &false;.
</para>
'>
<!-- Keep this comment at the end of the file

View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: ae48f384160615ce29ce231b7e85290427b64c44 Maintainer: aur Status: ready -->
<!-- EN-Revision: 72c73f0a7ea7dfc5cc2d8a41ddc3bd02b1384df8 Maintainer: aur Status: ready -->
<!-- Reviewed: no -->
<!-- $Revision$ -->
@ -119,6 +119,15 @@
</tgroup>
</table>
</para>
<note>
<para>
Начиная с dbase 7.0.0 поддерживаются обнуляемые поля
для баз данных <constant>DBASE_TYPE_FOXPRO</constant>. Если поле
обнуляемое. При передаче &null; будет установлен
соответствующий флаг и, при дальней шем извлечении
поля, будет возвращено значение &null;.
</para>
</note>
<note>
<para>
Поддержки для индексов и memo-полей нет.

View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: ae48f384160615ce29ce231b7e85290427b64c44 Maintainer: aur Status: ready -->
<!-- EN-Revision: 72c73f0a7ea7dfc5cc2d8a41ddc3bd02b1384df8 Maintainer: aur Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
<refentry xml:id="function.dbase-create" xmlns="http://docbook.org/ns/docbook">
@ -42,7 +42,7 @@
<para>
Массив массивов, в котором каждый массив описывает формат одного поля базы данных.
Формат каждого поля состоит из имени этого поля, символа, указывающего тип поля,
и, при необходимости, его длину и точность. Поддерживаемые типы файлов перечислены
и, при необходимости, его длину, точность и флаг обнуляемости. Поддерживаемые типы файлов перечислены
в <link linkend="intro.dbase">вводной секции</link>.
</para>
<note>