com doc/ru: Обновлен ие до англи йской верси и: language/oop5/constants.xml language/oop5/i nterfaces.xml
reference/memcached/ini.xml reference/rpm info/constants.xml
| From: | Sergey Panteleev | Date: | Thu, 21 Jan 2021 19:55:25 +0000 |
| Subject: | com doc/ru: Обновлен ие до англи йской верси и: language/oop5/constants.xml language/oop5/i nterfaces.xml reference/memcached/ini.xml reference/rpm info/constants.xml |
||
| Groups: | php.doc.ru | ||
| Request: | Send a blank email to doc-ru+get-8764@lists.php.net to get a copy of this message | ||
Commit: 73ef80accc4fd5fc9cad2c900d672550507af830
Author: Sergey Panteleev <sergey@php.net> Thu, 21 Jan 2021 22:52:42 +0300
Parents: fbaa8bf15021123be54b6cf3c86891999ab3fdb9
Branches: master
Link: http://git.php.net/?p=doc/ru.git;a=commitdiff;h=73ef80accc4fd5fc9cad2c900d672550507af830
Log:
Обновление до английской версии
Changed paths:
M language/oop5/constants.xml
M language/oop5/interfaces.xml
M reference/memcached/ini.xml
M reference/rpminfo/constants.xml
diff --git a/language/oop5/constants.xml b/language/oop5/constants.xml index 0e2bd509c..80fc0df7d 100644 --- a/language/oop5/constants.xml +++ b/language/oop5/constants.xml @@ -1,26 +1,25 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: b08540046ece3586e543293d3c01630d9127b285 Maintainer: shein Status: ready --> +<!-- EN-Revision: a9edd62d087ab1eb6292c795b7256e14ff9f1234 Maintainer: shein Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <sect1 xml:id="language.oop5.constants" xmlns="http://docbook.org/ns/docbook"> <title>Константы классов</title> <para> - Константы также могут быть объявлены в пределах одного класса. - Отличие переменных от констант состоит в том, что при объявлении последних - или при обращении к ним не используется символ <varname>$</varname>. + <link linkend="language.constants">Константы</link> также могут быть объявлены в пределах одного класса. Область видимости констант по умолчанию <literal>public</literal>. </para> + <note> + <para> + Константы класса могут быть переопределены дочерним классом. + </para> + </note> <para> - Значение должно быть неизменяемым выражением, а не (к примеру) переменной, - свойством или вызовом функции. - </para> - <para> - Интерфейсы также могут содержать константы (<literal>constants</literal>). За примерами + Интерфейсы также могут содержать <literal>константы</literal>. За примерами обращайтесь к разделу об <link linkend="language.oop5.interfaces">интерфейсах</link>. </para> <para> - Начиная с PHP 5.3.0, стало возможным обратиться к классу с помощью - переменной. Значение переменной не может быть ключевым словом + К классу можно обратиться с помощью переменной. + Значение переменной не может быть ключевым словом (например, <literal>self</literal>, <literal>parent</literal> и <literal>static</literal>). </para> @@ -45,43 +44,19 @@ class MyClass echo MyClass::CONSTANT . "\n"; $classname = "MyClass"; -echo $classname::CONSTANT . "\n"; // начиная с PHP 5.3.0 +echo $classname::CONSTANT . "\n"; $class = new MyClass(); $class->showConstant(); -echo $class::CONSTANT."\n"; // начиная с PHP 5.3.0 -?> -]]> - </programlisting> - </example> - <example> - <title>Пример со статичными данными</title> - <programlisting role="php"> -<![CDATA[ -<?php -class foo { - // Начиная с PHP 5.3.0 - const BAR = <<<'EOT' -bar -EOT; - // Начиная с PHP 5.3.0 - const BAZ = <<<EOT -baz -EOT; -} +echo $class::CONSTANT."\n"; ?> ]]> </programlisting> </example> - <note> - <para> - Поддержка синтаксиса Heredoc и Nowdoc при инициализации констант была добавлена в версии PHP 5.3.0. - </para> - </note> <para> - Начиная с PHP 5.5.0 доступна специальная константа <constant>::class</constant>, - которой на этапе компиляции присваивается полное имя класса. Полезна при использовании с классами, + Специальная константа <constant>::class</constant>, + которой на этапе компиляции присваивается полное имя класса, полезна при использовании с классами, использующими пространства имён. </para> <example> @@ -107,7 +82,6 @@ namespace foo { const ONE = 1; class foo { - // Начиная с PHP 5.6.0 const TWO = ONE * 2; const THREE = ONE + self::TWO; const SENTENCE = 'Значение константы THREE - ' . self::THREE; @@ -115,24 +89,14 @@ class foo { ?> ]]> </programlisting> - <para> - Для задания констант класса возможно использовать скалярные выражения с цифрами, - строками и/или другими константами. - </para> </example> - <note> - <para> - Поддержка константных выражений была добавлена в PHP 5.6.0. - </para> - </note> <example> - <title>Модификаторы видимости констант класса</title> + <title>Модификаторы видимости констант класса, начиная с PHP 7.1.0</title> <programlisting role="php"> <![CDATA[ <?php class Foo { - // Начиная с PHP 7.1.0 public const BAR = 'bar'; private const BAZ = 'baz'; } @@ -156,7 +120,6 @@ Fatal error: Uncaught Error: Cannot access private const Foo::BAZ in … </para> </note> </sect1> - <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/language/oop5/interfaces.xml b/language/oop5/interfaces.xml index 658f00ad9..3d29f825f 100644 --- a/language/oop5/interfaces.xml +++ b/language/oop5/interfaces.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: a9a6224ca97531df0a4e4b9b16b59c3f2baf1b09 Maintainer: shein Status: ready --> +<!-- EN-Revision: 4317fec7555dd42621f88162cc5068092e5c5cfb Maintainer: shein Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <sect1 xml:id="language.oop5.interfaces" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -30,14 +30,12 @@ произойдёт фатальная ошибка. При желании классы могут реализовывать более одного интерфейса, разделяя каждый интерфейс запятой. </para> - <note> - <para> - До версии PHP 5.3.9 класс не мог реализовать два интерфейса, содержащих - одноимённую функцию, так как это влекло за собой неоднозначность. В более - новых версиях PHP это допустимо, но только при условии, что одноимённые - методы в разных интерфейсах определены одинаково. - </para> - </note> + <warning> + <para> + Класс может реализовать два интерфейса, которые определяют метод с тем же именем, + только если объявление метода в обоих интерфейсах идентично. + </para> + </warning> <note> <para> Интерфейсы могут быть унаследованы друг от друга, так же, как и классы, @@ -46,12 +44,12 @@ </note> <note> <para> - Объявления методов в классе, реализующем интерфейс, должны быть совместимы - с принципом подстановки Барбары Лисков (Liskov Substitution Principle, LSP), - в противном случае будет вызвана фатальная ошибка. + Класс, реализующий интерфейс, должен объявить метод, имеющий + <link linkend="language.oop.lsp">совместимую сигнатуру</link>. </para> </note> </sect2> + <!-- Move this to OOP constants page? --> <sect2 xml:id="language.oop5.interfaces.constants"> <title>Константы (<literal>Constants</literal>)</title> <para> @@ -220,7 +218,7 @@ class b implements a </programlisting> </example> <para> - Интерфейс, совместно с контролем типов, предоставляет отличный + Интерфейс, совместно с объявлениями типов, предоставляет отличный способ проверки того, что определённый объект содержит определённый набор методов. Смотрите также оператор <link linkend="language.operators.type">instanceof</link> и @@ -229,7 +227,6 @@ class b implements a </sect2> </sect1> - <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/reference/memcached/ini.xml b/reference/memcached/ini.xml index 95d310f25..08778fa59 100644 --- a/reference/memcached/ini.xml +++ b/reference/memcached/ini.xml @@ -1,8 +1,7 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: c2db1519bfc31c28a2ed60bb0ecb49e60d6871a1 Maintainer: rjhdby Status: ready --> <!-- Reviewed: no --> - <section xml:id="memcached.configuration" xmlns="http://docbook.org/ns/docbook"> &reftitle.runtime; &extension.runtime; @@ -21,81 +20,177 @@ <tbody> <row> <entry><link linkend="ini.memcached.sess-locking">memcached.sess_locking</link></entry> - <entry>1</entry> + <entry>On</entry> <entry>PHP_INI_ALL</entry> - <entry><!-- leave empty, this will be filled by an automatic script --></entry> + <entry>Доступно с memcached 0.1.0.</entry> </row> <row> <entry><link linkend="ini.memcached.sess-consistent-hash">memcached.sess_consistent_hash</link></entry> - <entry>0</entry> + <entry>On</entry> <entry>PHP_INI_ALL</entry> - <entry><!-- leave empty, this will be filled by an automatic script --></entry> + <entry>Доступно с memcached 2.1.0. Значение по умолчанию - On, начиная с memcached 3.0.0.</entry> </row> <row> <entry><link linkend="ini.memcached.sess-binary">memcached.sess_binary</link></entry> - <entry>0</entry> + <entry>Off</entry> <entry>PHP_INI_ALL</entry> - <entry><!-- leave empty, this will be filled by an automatic script --></entry> + <entry>Доступно с memcached 2.0.0. Заменено на memcached.sess_binary_protocol в memcached 3.0.0.</entry> </row> <row> <entry><link linkend="ini.memcached.sess-lock-wait">memcached.sess_lock_wait</link></entry> <entry>150000</entry> <entry>PHP_INI_ALL</entry> - <entry><!-- leave empty, this will be filled by an automatic script --></entry> + <entry>Доступно с memcached 0.1.0. Удалено в memcached 3.0.0.</entry> </row> <row> <entry><link linkend="ini.memcached.sess-prefix">memcached.sess_prefix</link></entry> <entry>memc.sess.key.</entry> <entry>PHP_INI_ALL</entry> - <entry><!-- leave empty, this will be filled by an automatic script --></entry> + <entry>Доступно с memcached 0.1.0.</entry> </row> <row> <entry><link linkend="ini.memcached.sess-number-of-replicas">memcached.sess_number_of_replicas</link></entry> <entry>0</entry> <entry>PHP_INI_ALL</entry> - <entry><!-- leave empty, this will be filled by an automatic script --></entry> + <entry>Доступно с memcached 2.1.0.</entry> </row> <row> <entry><link linkend="ini.memcached.sess-randomize-replica-read">memcached.sess_randomize_replica_read</link></entry> - <entry>0</entry> + <entry>Off</entry> <entry>PHP_INI_ALL</entry> - <entry><!-- leave empty, this will be filled by an automatic script --></entry> + <entry>Доступно с memcached 2.1.0.</entry> </row> <row> <entry><link linkend="ini.memcached.sess-remove-failed">memcached.sess_remove_failed</link></entry> - <entry>0</entry> + <entry>On</entry> <entry>PHP_INI_ALL</entry> - <entry><!-- leave empty, this will be filled by an automatic script --></entry> + <entry>Доступно с memcached 2.1.0. Заменено на memcached.sess_remove_failed_servers в memcached 3.0.0.</entry> </row> <row> <entry><link linkend="ini.memcached.compression-type">memcached.compression_type</link></entry> <entry>fastlz</entry> <entry>PHP_INI_ALL</entry> - <entry><!-- leave empty, this will be filled by an automatic script --></entry> + <entry>Доступно с memcached 0.1.0.</entry> </row> <row> <entry><link linkend="ini.memcached.compression-factor">memcached.compression_factor</link></entry> <entry>1.3</entry> <entry>PHP_INI_ALL</entry> - <entry><!-- leave empty, this will be filled by an automatic script --></entry> + <entry>Доступно с memcached 0.1.0.</entry> </row> <row> <entry><link linkend="ini.memcached.compression-threshold">memcached.compression_threshold</link></entry> <entry>2000</entry> <entry>PHP_INI_ALL</entry> - <entry><!-- leave empty, this will be filled by an automatic script --></entry> + <entry>Доступно с memcached 0.1.0.</entry> </row> <row> <entry><link linkend="ini.memcached.serializer">memcached.serializer</link></entry> - <entry>php</entry> + <entry>igbinary</entry> <entry>PHP_INI_ALL</entry> - <entry><!-- leave empty, this will be filled by an automatic script --></entry> + <entry>Доступно с memcached 0.1.0.</entry> </row> <row> <entry><link linkend="ini.memcached.use-sasl">memcached.use_sasl</link></entry> - <entry>0</entry> + <entry>Off</entry> <entry>PHP_INI_SYSTEM</entry> - <entry><!-- leave empty, this will be filled by an automatic script --></entry> + <entry>Доступно с memcached 2.2.0. Удалено в memcached 3.0.0.</entry> + </row> + <row> + <entry><link linkend="ini.memcached.default-binary-protocol">memcached.default_binary_protocol</link></entry> + <entry>Off</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с memcached 3.0.0.</entry> + </row> + <row> + <entry><link linkend="ini.memcached.default-connect-timeout">memcached.default_connect_timeout</link></entry> + <entry>0</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с memcached 3.0.0.</entry> + </row> + <row> + <entry><link linkend="ini.memcached.default-consistent-hash">memcached.default_consistent_hash</link></entry> + <entry>Off</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с memcached 3.0.0.</entry> + </row> + <row> + <entry><link linkend="ini.memcached.sess-binary-protocol">memcached.sess_binary_protocol</link></entry> + <entry>On</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с memcached 3.0.0. Заменено на memcached.sess_binary.</entry> + </row> + <row> + <entry><link linkend="ini.memcached.sess-connect-timeout">memcached.sess_connect_timeout</link></entry> + <entry>1000</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с memcached 2.2.0.</entry> + </row> + <row> + <entry><link linkend="ini.memcached.sess-consistent-hash-type">memcached.sess_consistent_hash_type</link></entry> + <entry>ketama</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с memcached 3.1.0.</entry> + </row> + <row> + <entry><link linkend="ini.memcached.sess-lock-expire">memcached.sess_lock_expire</link></entry> + <entry>0</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с memcached 2.2.0.</entry> + </row> + <row> + <entry><link linkend="ini.memcached.sess-lock-retries">memcached.sess_lock_retries</link></entry> + <entry>5</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с memcached 3.0.0.</entry> + </row> + <row> + <entry><link linkend="ini.memcached.sess-lock-wait-max">memcached.sess_lock_wait_max</link></entry> + <entry>150</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с memcached 3.0.0. Значение по умолчанию 150 с memcached 3.1.0 (previously 2000).</entry> + </row> + <row> + <entry><link linkend="ini.memcached.sess-lock-wait-min">memcached.sess_lock_wait_min</link></entry> + <entry>150</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с memcached 3.0.0. Значение по умолчанию 150 с memcached 3.1.0 (previously 1000).</entry> + </row> + <row> + <entry><link linkend="ini.memcached.sess-persistent">memcached.sess_persistent</link></entry> + <entry>Off</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с memcached 3.0.0.</entry> + </row> + <row> + <entry><link linkend="ini.memcached.sess-remove-failed-servers">memcached.sess_remove_failed_servers</link></entry> + <entry>Off</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с memcached 3.0.0. Заменено на memcached.sess_remove_failed.</entry> + </row> + <row> + <entry><link linkend="ini.memcached.sess-server-failure-limit">memcached.sess_server_failure_limit</link></entry> + <entry>0</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с memcached 3.0.0.</entry> + </row> + <row> + <entry><link linkend="ini.memcached.sess-sasl-password">memcached.sess_sasl_password</link></entry> + <entry>null</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с memcached 2.2.0.</entry> + </row> + <row> + <entry><link linkend="ini.memcached.sess-sasl-username">memcached.sess_sasl_username</link></entry> + <entry>null</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с memcached 2.2.0.</entry> + </row> + <row> + <entry><link linkend="ini.memcached.store-retry-count">memcached.store_retry_count</link></entry> + <entry>2</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с memcached 2.2.0.</entry> </row> </tbody> </tgroup> @@ -106,11 +201,10 @@ <para> <variablelist> - <varlistentry xml:id="ini.memcached.sess-locking"> <term> <parameter>memcached.sess_locking</parameter> - <type>int</type> + <type>bool</type> </term> <listitem> <para> @@ -118,28 +212,24 @@ </para> </listitem> </varlistentry> - <varlistentry xml:id="ini.memcached.sess-consistent-hash"> <term> <parameter>memcached.sess_consistent_hash</parameter> - <type>int</type> + <type>bool</type> </term> <listitem> <para> - Режим консистентного хеширования сессий. Если включено, то для - обработки сессий будет использовано консистентное хеширование. - При использовании консистентного хеширования можно - добавлять или удалять узлы кеширования без больших потерь - кешированных ключей. - По умолчанию Off. + Если включено, то для обработки сессий будет использовано согласованное хеширование. + При использовании согласованного хеширования можно + добавлять или удалять узлы кеширования без больших потерь кешированных ключей. + По умолчанию On. </para> </listitem> </varlistentry> - <varlistentry xml:id="ini.memcached.sess-binary"> <term> <parameter>memcached.sess_binary</parameter> - <type>int</type> + <type>bool</type> </term> <listitem> <para> @@ -148,7 +238,6 @@ </para> </listitem> </varlistentry> - <varlistentry xml:id="ini.memcached.sess-lock-wait"> <term> <parameter>memcached.sess_lock_wait</parameter> @@ -165,7 +254,6 @@ </para> </listitem> </varlistentry> - <varlistentry xml:id="ini.memcached.sess-prefix"> <term> <parameter>memcached.sess_prefix</parameter> @@ -177,7 +265,6 @@ </para> </listitem> </varlistentry> - <varlistentry xml:id="ini.memcached.sess-number-of-replicas"> <term> <parameter>memcached.sess_number_of_replicas</parameter> @@ -185,15 +272,17 @@ </term> <listitem> <para> - Количество реплик сессии memcached. + Записывать данные на ряд дополнительных серверов memcached. Это "высокая доступность для бедняков", как её называет libmemcached. + Если это значение положительное, и активирован режим sessions_remove_failed_servers, когда сервер memcached выходит из строя, сессия будет по-прежнему доступна из реплики. + Однако, если отказавший сервер memcache снова становится доступным, он будет читать сессию оттуда, которая может иметь старые данные или вообще не иметь данных. + По умолчанию 0. </para> </listitem> </varlistentry> - <varlistentry xml:id="ini.memcached.sess-randomize-replica-read"> <term> <parameter>memcached.sess_randomize_replica_read</parameter> - <type>int</type> + <type>bool</type> </term> <listitem> <para> @@ -201,7 +290,6 @@ </para> </listitem> </varlistentry> - <varlistentry xml:id="ini.memcached.sess-remove-failed"> <term> <parameter>memcached.sess_remove_failed</parameter> @@ -213,7 +301,6 @@ </para> </listitem> </varlistentry> - <varlistentry xml:id="ini.memcached.compression-type"> <term> <parameter>memcached.compression_type</parameter> @@ -225,7 +312,6 @@ </para> </listitem> </varlistentry> - <varlistentry xml:id="ini.memcached.compression-factor"> <term> <parameter>memcached.compression_factor</parameter> @@ -239,7 +325,6 @@ </para> </listitem> </varlistentry> - <varlistentry xml:id="ini.memcached.compression-threshold"> <term> <parameter>memcached.compression_threshold</parameter> @@ -252,7 +337,6 @@ </para> </listitem> </varlistentry> - <varlistentry xml:id="ini.memcached.serializer"> <term> <parameter>memcached.serializer</parameter> @@ -260,7 +344,7 @@ </term> <listitem> <para> - Настройка сериализатора по умолчанию для новых объектов memcached. Допустимые значения: php, igbinary, json, json_array. + Настройка сериализатора по умолчанию для новых объектов memcached. Допустимые значения: php, igbinary, json, json_array, msgpack. </para> <variablelist> <varlistentry> @@ -269,7 +353,7 @@ <para> Стандартное кодирование JSON. Этот сериализатор быстрый и компактный, но работает только с данными в UTF-8 и не полностью реализует сериализацию. - Подробности смотри в описании расширения JSON. + Подробности смотрите в описании модуле JSON. Доступно с memcached 0.2.0. </para> </listitem> </varlistentry> @@ -277,7 +361,7 @@ <term>json_array</term> <listitem> <para> - Тот же json, но раскодируется в массивы. + Тот же json, но раскодируется в массивы. Доступно с memcached 2.0.0. </para> </listitem> </varlistentry> @@ -293,21 +377,28 @@ <term>igbinary</term> <listitem> <para> - Бинарный сериализатор. + Бинарный сериализатор. Доступно с memcached 0.1.4 </para> </listitem> </varlistentry> + <varlistentry> + <term>msgpack</term> + <listitem> + <para> + Межъязыковой двоичный сериализатор. Доступно с memcached 2.2.0. + </para> + </listitem> + </varlistentry> </variablelist> <para> - По умолчанию igbinary, если доступен. Иначе PHP. + По умолчанию igbinary, если доступен, затем igbinary, если доступен, иначе PHP. </para> </listitem> </varlistentry> - <varlistentry xml:id="ini.memcached.use-sasl"> <term> <parameter>memcached.use_sasl</parameter> - <type>int</type> + <type>bool</type> </term> <listitem> <para> @@ -315,7 +406,193 @@ </para> </listitem> </varlistentry> +<varlistentry xml:id="ini.memcached.default-binary-protocol"> + <term> + <parameter>memcached.default_binary_protocol</parameter> + <type>bool</type> + </term> + <listitem> + <para> + Устанавливает протокол memcached по умолчанию для новых подключений. (Чтобы настроить протокол memcached для соединений, используемых сессиями, используйте вместо него memcached.sess_binary_protocol) + + Если установлено значение On, по умолчанию используется двоичный протокол memcached. Если установлено значение Off, используется текстовый протокол memcached. По умолчанию Off + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.memcached.default-connect-timeout"> + <term> + <parameter>memcached.default_connect_timeout</parameter> + <type>int</type> + </term> + <listitem> + <para> + Устанавливает время ожидания соединения memcached по умолчанию для новых соединений. (Чтобы настроить время ожидания соединения memcached для сессий, используйте вместо этого memcached.sess_connect_timeout) + + В неблокирующем режиме это изменяет значение времени ожидания во время подключения к сокету в миллисекундах. Указание -1 означает бесконечное время ожидания. + Указание 0 означает использование времени ожидания соединения по умолчанию для библиотеки memcached. По умолчанию 0. + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.memcached.default-consistent-hash"> + <term> + <parameter>memcached.default_consistent_hash</parameter> + <type>bool</type> + </term> + <listitem> + <para> + Устанавливает значение по умолчанию для согласованного хеширования для новых подключений. (Чтобы настроить согласованное хеширование для сессий, используйте вместо этого memcached.sess_consistent_hash) + Если установлено значение On, для обработки сессии используется согласованное хеширование (libketama). Когда используется согласованное хеширование, можно добавлять или удалять узлы кеша, не беспокоясь о том, что существующие ключи по умолчанию отключены. + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.memcached.sess-binary-protocol"> + <term> + <parameter>memcached.sess_binary_protocol</parameter> + <type>bool</type> + </term> + <listitem> + <para> + Используйте двоичный протокол memcached для сессий memcached (вместо текстового протокола). Реплики libmemcached работают, только если включён двоичный режим. Однако некоторые прокси (например, twemproxy) будут работать, только если двоичный протокол отключён. В более старых версиях php-memcached этот параметр был выключен и назывался memcached.sess_binary. По умолчанию включено с libmemcached 1.0.18 или новее. По умолчанию в старой версии отключено. + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.memcached.sess-connect-timeout"> + <term> + <parameter>memcached.sess_connect_timeout</parameter> + <type>int</type> + </term> + <listitem> + <para> + Значение времени ожидания соединения memcached + В неблокирующем режиме это изменяет значение времени ожидания во время соединения сокета в миллисекундах. Указание -1 означает бесконечное время ожидания. + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.memcached.sess-consistent-hash-type"> + <term> + <parameter>memcached.sess_consistent_hash_type</parameter> + <type>string</type> + </term> + <listitem> + <para> + Тип согласованного хеширования сессии Memcached. Если установлено значение 'ketama' (по умолчанию для php-memcached 3.x), для обработки сессии используется согласованное хеширование libketama, если установлено значение 'ketama_weighted' (по умолчанию для php-memcached 2.x), для обработки сессии используется взвешенное согласованное хеширование (libketama). По умолчанию - "ketama". + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.memcached.sess-lock-expire"> + <term> + <parameter>memcached.sess_lock_expire</parameter> + <type>int</type> + </term> + <listitem> + <para> + Время в секундах до того, как должна сработать блокировка. Установка в 0 приводит к поведению по умолчанию, которое заключается в использовании PHP max_execution_time. По умолчанию 0. + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.memcached.sess-lock-retries"> + <term> + <parameter>memcached.sess_lock_retries</parameter> + <type>int</type> + </term> + <listitem> + <para> + Количество попыток повторной блокировки блокировки сессии, не включая первую попытку. По умолчанию 5. + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.memcached.sess-lock-wait-max"> + <term> + <parameter>memcached.sess_lock_wait_max</parameter> + <type>int</type> + </term> + <listitem> + <para> + Максимальное время ожидания в миллисекундах между попытками блокировки сессии. По умолчанию 150. + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.memcached.sess-lock-wait-min"> + <term> + <parameter>memcached.sess_lock_wait_min</parameter> + <type>int</type> + </term> + <listitem> + <para> + Минимальное время ожидания в миллисекундах между попытками блокировки сессии. Это значение удваивается при каждой попытке блокировки до тех пор, пока не будет достигнута memcached.sess_lock_wait_max, после чего любые дальнейшие попытки будут занимать sessions_lock_wait_max секунд. По умолчанию 150. + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.memcached.sess-persistent"> + <term> + <parameter>memcached.sess_persistent</parameter> + <type>bool</type> + </term> + <listitem> + <para> + Следует ли повторно использовать соединения memcached, соответствующие значению (значениям) session.save_path после завершения выполнения скрипта. Не используйте это, если определённые настройки (например, настройки SASL, sess_binary_protocol) будут переопределены между запросами. По умолчанию Off. + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.memcached.sess-remove-failed-servers"> + <term> + <parameter>memcached.sess_remove_failed_servers</parameter> + <type>bool</type> + </term> + <listitem> + <para> + Разрешить автоматическое удаление отказавшего сервера memcached. По умолчанию Off. (В предыдущих версиях этот параметр назывался memcached.sess_remove_failed) + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.memcached.sess-server-failure-limit"> + <term> + <parameter>memcached.sess_server_failure_limit</parameter> + <type>int</type> + </term> + <listitem> + <para> + Установите это значение, чтобы разрешить удаление сервера после заданного количества непрерывных сбоев подключения. По умолчанию 0. + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.memcached.sess-sasl-password"> + <term> + <parameter>memcached.sess_sasl_password</parameter> + <type>string</type> + </term> + <listitem> + <para> + Пароль сессии SASL + Для включения SASL необходимо указать имя пользователя и пароль. + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.memcached.sess-sasl-username"> + <term> + <parameter>memcached.sess_sasl_username</parameter> + <type>string</type> + </term> + <listitem> + <para> + Имя пользователя сессии SASL + Для включения SASL необходимо указать имя пользователя и пароль. + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.memcached.store-retry-count"> + <term> + <parameter>memcached.store_retry_count</parameter> + <type>int</type> + </term> + <listitem> + <para> + Количество повторных попыток для неудачных команд сохранения. + Этот механизм обеспечивает прозрачное переключение на вторичные серверы при сбое операций set/increment/decrement/setMulti на желаемом сервере в среде c множеством серверов. по умолчанию — 2 + </para> + </listitem> + </varlistentry> </variablelist> </para> </section> diff --git a/reference/rpminfo/constants.xml b/reference/rpminfo/constants.xml index 8a27d1280..30328b3a7 100644 --- a/reference/rpminfo/constants.xml +++ b/reference/rpminfo/constants.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: sergey Status: ready --> +<!-- EN-Revision: 6e30ba482b992c476f4646168a082ee45fe2d0c0 Maintainer: sergey Status: ready --> <!-- Reviewed: no --> <appendix xml:id="rpminfo.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.constants; @@ -1712,6 +1712,17 @@ </simpara> </listitem> </varlistentry> + <varlistentry xml:id="constant.rpmtag-payloaddigestalt"> + <term> + <constant>RPMTAG_PAYLOADDIGESTALT</constant> + (<type>int</type>) + </term> + <listitem> + <simpara> + С librpm >= 4.16. + </simpara> + </listitem> + </varlistentry> <varlistentry xml:id="constant.rpmtag-payloaddigestalgo"> <term> <constant>RPMTAG_PAYLOADDIGESTALGO</constant>
diff --git a/language/oop5/constants.xml b/language/oop5/constants.xml index 0e2bd509c..80fc0df7d 100644 --- a/language/oop5/constants.xml +++ b/language/oop5/constants.xml @@ -1,26 +1,25 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: b08540046ece3586e543293d3c01630d9127b285 Maintainer: shein Status: ready --> +<!-- EN-Revision: a9edd62d087ab1eb6292c795b7256e14ff9f1234 Maintainer: shein Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <sect1 xml:id="language.oop5.constants" xmlns="http://docbook.org/ns/docbook"> <title>Константы классов</title> <para> - Константы также могут быть объявлены в пределах одного класса. - Отличие переменных от констант состоит в том, что при объявлении последних - или при обращении к ним не используется символ <varname>$</varname>. + <link linkend="language.constants">Константы</link> также могут быть объявлены в пределах одного класса. Область видимости констант по умолчанию <literal>public</literal>. </para> + <note> + <para> + Константы класса могут быть переопределены дочерним классом. + </para> + </note> <para> - Значение должно быть неизменяемым выражением, а не (к примеру) переменной, - свойством или вызовом функции. - </para> - <para> - Интерфейсы также могут содержать константы (<literal>constants</literal>). За примерами + Интерфейсы также могут содержать <literal>константы</literal>. За примерами обращайтесь к разделу об <link linkend="language.oop5.interfaces">интерфейсах</link>. </para> <para> - Начиная с PHP 5.3.0, стало возможным обратиться к классу с помощью - переменной. Значение переменной не может быть ключевым словом + К классу можно обратиться с помощью переменной. + Значение переменной не может быть ключевым словом (например, <literal>self</literal>, <literal>parent</literal> и <literal>static</literal>). </para> @@ -45,43 +44,19 @@ class MyClass echo MyClass::CONSTANT . "\n"; $classname = "MyClass"; -echo $classname::CONSTANT . "\n"; // начиная с PHP 5.3.0 +echo $classname::CONSTANT . "\n"; $class = new MyClass(); $class->showConstant(); -echo $class::CONSTANT."\n"; // начиная с PHP 5.3.0 -?> -]]> - </programlisting> - </example> - <example> - <title>Пример со статичными данными</title> - <programlisting role="php"> -<![CDATA[ -<?php -class foo { - // Начиная с PHP 5.3.0 - const BAR = <<<'EOT' -bar -EOT; - // Начиная с PHP 5.3.0 - const BAZ = <<<EOT -baz -EOT; -} +echo $class::CONSTANT."\n"; ?> ]]> </programlisting> </example> - <note> - <para> - Поддержка синтаксиса Heredoc и Nowdoc при инициализации констант была добавлена в версии PHP 5.3.0. - </para> - </note> <para> - Начиная с PHP 5.5.0 доступна специальная константа <constant>::class</constant>, - которой на этапе компиляции присваивается полное имя класса. Полезна при использовании с классами, + Специальная константа <constant>::class</constant>, + которой на этапе компиляции присваивается полное имя класса, полезна при использовании с классами, использующими пространства имён. </para> <example> @@ -107,7 +82,6 @@ namespace foo { const ONE = 1; class foo { - // Начиная с PHP 5.6.0 const TWO = ONE * 2; const THREE = ONE + self::TWO; const SENTENCE = 'Значение константы THREE - ' . self::THREE; @@ -115,24 +89,14 @@ class foo { ?> ]]> </programlisting> - <para> - Для задания констант класса возможно использовать скалярные выражения с цифрами, - строками и/или другими константами. - </para> </example> - <note> - <para> - Поддержка константных выражений была добавлена в PHP 5.6.0. - </para> - </note> <example> - <title>Модификаторы видимости констант класса</title> + <title>Модификаторы видимости констант класса, начиная с PHP 7.1.0</title> <programlisting role="php"> <![CDATA[ <?php class Foo { - // Начиная с PHP 7.1.0 public const BAR = 'bar'; private const BAZ = 'baz'; } @@ -156,7 +120,6 @@ Fatal error: Uncaught Error: Cannot access private const Foo::BAZ in … </para> </note> </sect1> - <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/language/oop5/interfaces.xml b/language/oop5/interfaces.xml index 658f00ad9..3d29f825f 100644 --- a/language/oop5/interfaces.xml +++ b/language/oop5/interfaces.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: a9a6224ca97531df0a4e4b9b16b59c3f2baf1b09 Maintainer: shein Status: ready --> +<!-- EN-Revision: 4317fec7555dd42621f88162cc5068092e5c5cfb Maintainer: shein Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <sect1 xml:id="language.oop5.interfaces" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -30,14 +30,12 @@ произойдёт фатальная ошибка. При желании классы могут реализовывать более одного интерфейса, разделяя каждый интерфейс запятой. </para> - <note> - <para> - До версии PHP 5.3.9 класс не мог реализовать два интерфейса, содержащих - одноимённую функцию, так как это влекло за собой неоднозначность. В более - новых версиях PHP это допустимо, но только при условии, что одноимённые - методы в разных интерфейсах определены одинаково. - </para> - </note> + <warning> + <para> + Класс может реализовать два интерфейса, которые определяют метод с тем же именем, + только если объявление метода в обоих интерфейсах идентично. + </para> + </warning> <note> <para> Интерфейсы могут быть унаследованы друг от друга, так же, как и классы, @@ -46,12 +44,12 @@ </note> <note> <para> - Объявления методов в классе, реализующем интерфейс, должны быть совместимы - с принципом подстановки Барбары Лисков (Liskov Substitution Principle, LSP), - в противном случае будет вызвана фатальная ошибка. + Класс, реализующий интерфейс, должен объявить метод, имеющий + <link linkend="language.oop.lsp">совместимую сигнатуру</link>. </para> </note> </sect2> + <!-- Move this to OOP constants page? --> <sect2 xml:id="language.oop5.interfaces.constants"> <title>Константы (<literal>Constants</literal>)</title> <para> @@ -220,7 +218,7 @@ class b implements a </programlisting> </example> <para> - Интерфейс, совместно с контролем типов, предоставляет отличный + Интерфейс, совместно с объявлениями типов, предоставляет отличный способ проверки того, что определённый объект содержит определённый набор методов. Смотрите также оператор <link linkend="language.operators.type">instanceof</link> и @@ -229,7 +227,6 @@ class b implements a </sect2> </sect1> - <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/reference/memcached/ini.xml b/reference/memcached/ini.xml index 95d310f25..08778fa59 100644 --- a/reference/memcached/ini.xml +++ b/reference/memcached/ini.xml @@ -1,8 +1,7 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: c2db1519bfc31c28a2ed60bb0ecb49e60d6871a1 Maintainer: rjhdby Status: ready --> <!-- Reviewed: no --> - <section xml:id="memcached.configuration" xmlns="http://docbook.org/ns/docbook"> &reftitle.runtime; &extension.runtime; @@ -21,81 +20,177 @@ <tbody> <row> <entry><link linkend="ini.memcached.sess-locking">memcached.sess_locking</link></entry> - <entry>1</entry> + <entry>On</entry> <entry>PHP_INI_ALL</entry> - <entry><!-- leave empty, this will be filled by an automatic script --></entry> + <entry>Доступно с memcached 0.1.0.</entry> </row> <row> <entry><link linkend="ini.memcached.sess-consistent-hash">memcached.sess_consistent_hash</link></entry> - <entry>0</entry> + <entry>On</entry> <entry>PHP_INI_ALL</entry> - <entry><!-- leave empty, this will be filled by an automatic script --></entry> + <entry>Доступно с memcached 2.1.0. Значение по умолчанию - On, начиная с memcached 3.0.0.</entry> </row> <row> <entry><link linkend="ini.memcached.sess-binary">memcached.sess_binary</link></entry> - <entry>0</entry> + <entry>Off</entry> <entry>PHP_INI_ALL</entry> - <entry><!-- leave empty, this will be filled by an automatic script --></entry> + <entry>Доступно с memcached 2.0.0. Заменено на memcached.sess_binary_protocol в memcached 3.0.0.</entry> </row> <row> <entry><link linkend="ini.memcached.sess-lock-wait">memcached.sess_lock_wait</link></entry> <entry>150000</entry> <entry>PHP_INI_ALL</entry> - <entry><!-- leave empty, this will be filled by an automatic script --></entry> + <entry>Доступно с memcached 0.1.0. Удалено в memcached 3.0.0.</entry> </row> <row> <entry><link linkend="ini.memcached.sess-prefix">memcached.sess_prefix</link></entry> <entry>memc.sess.key.</entry> <entry>PHP_INI_ALL</entry> - <entry><!-- leave empty, this will be filled by an automatic script --></entry> + <entry>Доступно с memcached 0.1.0.</entry> </row> <row> <entry><link linkend="ini.memcached.sess-number-of-replicas">memcached.sess_number_of_replicas</link></entry> <entry>0</entry> <entry>PHP_INI_ALL</entry> - <entry><!-- leave empty, this will be filled by an automatic script --></entry> + <entry>Доступно с memcached 2.1.0.</entry> </row> <row> <entry><link linkend="ini.memcached.sess-randomize-replica-read">memcached.sess_randomize_replica_read</link></entry> - <entry>0</entry> + <entry>Off</entry> <entry>PHP_INI_ALL</entry> - <entry><!-- leave empty, this will be filled by an automatic script --></entry> + <entry>Доступно с memcached 2.1.0.</entry> </row> <row> <entry><link linkend="ini.memcached.sess-remove-failed">memcached.sess_remove_failed</link></entry> - <entry>0</entry> + <entry>On</entry> <entry>PHP_INI_ALL</entry> - <entry><!-- leave empty, this will be filled by an automatic script --></entry> + <entry>Доступно с memcached 2.1.0. Заменено на memcached.sess_remove_failed_servers в memcached 3.0.0.</entry> </row> <row> <entry><link linkend="ini.memcached.compression-type">memcached.compression_type</link></entry> <entry>fastlz</entry> <entry>PHP_INI_ALL</entry> - <entry><!-- leave empty, this will be filled by an automatic script --></entry> + <entry>Доступно с memcached 0.1.0.</entry> </row> <row> <entry><link linkend="ini.memcached.compression-factor">memcached.compression_factor</link></entry> <entry>1.3</entry> <entry>PHP_INI_ALL</entry> - <entry><!-- leave empty, this will be filled by an automatic script --></entry> + <entry>Доступно с memcached 0.1.0.</entry> </row> <row> <entry><link linkend="ini.memcached.compression-threshold">memcached.compression_threshold</link></entry> <entry>2000</entry> <entry>PHP_INI_ALL</entry> - <entry><!-- leave empty, this will be filled by an automatic script --></entry> + <entry>Доступно с memcached 0.1.0.</entry> </row> <row> <entry><link linkend="ini.memcached.serializer">memcached.serializer</link></entry> - <entry>php</entry> + <entry>igbinary</entry> <entry>PHP_INI_ALL</entry> - <entry><!-- leave empty, this will be filled by an automatic script --></entry> + <entry>Доступно с memcached 0.1.0.</entry> </row> <row> <entry><link linkend="ini.memcached.use-sasl">memcached.use_sasl</link></entry> - <entry>0</entry> + <entry>Off</entry> <entry>PHP_INI_SYSTEM</entry> - <entry><!-- leave empty, this will be filled by an automatic script --></entry> + <entry>Доступно с memcached 2.2.0. Удалено в memcached 3.0.0.</entry> + </row> + <row> + <entry><link linkend="ini.memcached.default-binary-protocol">memcached.default_binary_protocol</link></entry> + <entry>Off</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с memcached 3.0.0.</entry> + </row> + <row> + <entry><link linkend="ini.memcached.default-connect-timeout">memcached.default_connect_timeout</link></entry> + <entry>0</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с memcached 3.0.0.</entry> + </row> + <row> + <entry><link linkend="ini.memcached.default-consistent-hash">memcached.default_consistent_hash</link></entry> + <entry>Off</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с memcached 3.0.0.</entry> + </row> + <row> + <entry><link linkend="ini.memcached.sess-binary-protocol">memcached.sess_binary_protocol</link></entry> + <entry>On</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с memcached 3.0.0. Заменено на memcached.sess_binary.</entry> + </row> + <row> + <entry><link linkend="ini.memcached.sess-connect-timeout">memcached.sess_connect_timeout</link></entry> + <entry>1000</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с memcached 2.2.0.</entry> + </row> + <row> + <entry><link linkend="ini.memcached.sess-consistent-hash-type">memcached.sess_consistent_hash_type</link></entry> + <entry>ketama</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с memcached 3.1.0.</entry> + </row> + <row> + <entry><link linkend="ini.memcached.sess-lock-expire">memcached.sess_lock_expire</link></entry> + <entry>0</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с memcached 2.2.0.</entry> + </row> + <row> + <entry><link linkend="ini.memcached.sess-lock-retries">memcached.sess_lock_retries</link></entry> + <entry>5</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с memcached 3.0.0.</entry> + </row> + <row> + <entry><link linkend="ini.memcached.sess-lock-wait-max">memcached.sess_lock_wait_max</link></entry> + <entry>150</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с memcached 3.0.0. Значение по умолчанию 150 с memcached 3.1.0 (previously 2000).</entry> + </row> + <row> + <entry><link linkend="ini.memcached.sess-lock-wait-min">memcached.sess_lock_wait_min</link></entry> + <entry>150</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с memcached 3.0.0. Значение по умолчанию 150 с memcached 3.1.0 (previously 1000).</entry> + </row> + <row> + <entry><link linkend="ini.memcached.sess-persistent">memcached.sess_persistent</link></entry> + <entry>Off</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с memcached 3.0.0.</entry> + </row> + <row> + <entry><link linkend="ini.memcached.sess-remove-failed-servers">memcached.sess_remove_failed_servers</link></entry> + <entry>Off</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с memcached 3.0.0. Заменено на memcached.sess_remove_failed.</entry> + </row> + <row> + <entry><link linkend="ini.memcached.sess-server-failure-limit">memcached.sess_server_failure_limit</link></entry> + <entry>0</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с memcached 3.0.0.</entry> + </row> + <row> + <entry><link linkend="ini.memcached.sess-sasl-password">memcached.sess_sasl_password</link></entry> + <entry>null</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с memcached 2.2.0.</entry> + </row> + <row> + <entry><link linkend="ini.memcached.sess-sasl-username">memcached.sess_sasl_username</link></entry> + <entry>null</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с memcached 2.2.0.</entry> + </row> + <row> + <entry><link linkend="ini.memcached.store-retry-count">memcached.store_retry_count</link></entry> + <entry>2</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с memcached 2.2.0.</entry> </row> </tbody> </tgroup> @@ -106,11 +201,10 @@ <para> <variablelist> - <varlistentry xml:id="ini.memcached.sess-locking"> <term> <parameter>memcached.sess_locking</parameter> - <type>int</type> + <type>bool</type> </term> <listitem> <para> @@ -118,28 +212,24 @@ </para> </listitem> </varlistentry> - <varlistentry xml:id="ini.memcached.sess-consistent-hash"> <term> <parameter>memcached.sess_consistent_hash</parameter> - <type>int</type> + <type>bool</type> </term> <listitem> <para> - Режим консистентного хеширования сессий. Если включено, то для - обработки сессий будет использовано консистентное хеширование. - При использовании консистентного хеширования можно - добавлять или удалять узлы кеширования без больших потерь - кешированных ключей. - По умолчанию Off. + Если включено, то для обработки сессий будет использовано согласованное хеширование. + При использовании согласованного хеширования можно + добавлять или удалять узлы кеширования без больших потерь кешированных ключей. + По умолчанию On. </para> </listitem> </varlistentry> - <varlistentry xml:id="ini.memcached.sess-binary"> <term> <parameter>memcached.sess_binary</parameter> - <type>int</type> + <type>bool</type> </term> <listitem> <para> @@ -148,7 +238,6 @@ </para> </listitem> </varlistentry> - <varlistentry xml:id="ini.memcached.sess-lock-wait"> <term> <parameter>memcached.sess_lock_wait</parameter> @@ -165,7 +254,6 @@ </para> </listitem> </varlistentry> - <varlistentry xml:id="ini.memcached.sess-prefix"> <term> <parameter>memcached.sess_prefix</parameter> @@ -177,7 +265,6 @@ </para> </listitem> </varlistentry> - <varlistentry xml:id="ini.memcached.sess-number-of-replicas"> <term> <parameter>memcached.sess_number_of_replicas</parameter> @@ -185,15 +272,17 @@ </term> <listitem> <para> - Количество реплик сессии memcached. + Записывать данные на ряд дополнительных серверов memcached. Это "высокая доступность для бедняков", как её называет libmemcached. + Если это значение положительное, и активирован режим sessions_remove_failed_servers, когда сервер memcached выходит из строя, сессия будет по-прежнему доступна из реплики. + Однако, если отказавший сервер memcache снова становится доступным, он будет читать сессию оттуда, которая может иметь старые данные или вообще не иметь данных. + По умолчанию 0. </para> </listitem> </varlistentry> - <varlistentry xml:id="ini.memcached.sess-randomize-replica-read"> <term> <parameter>memcached.sess_randomize_replica_read</parameter> - <type>int</type> + <type>bool</type> </term> <listitem> <para> @@ -201,7 +290,6 @@ </para> </listitem> </varlistentry> - <varlistentry xml:id="ini.memcached.sess-remove-failed"> <term> <parameter>memcached.sess_remove_failed</parameter> @@ -213,7 +301,6 @@ </para> </listitem> </varlistentry> - <varlistentry xml:id="ini.memcached.compression-type"> <term> <parameter>memcached.compression_type</parameter> @@ -225,7 +312,6 @@ </para> </listitem> </varlistentry> - <varlistentry xml:id="ini.memcached.compression-factor"> <term> <parameter>memcached.compression_factor</parameter> @@ -239,7 +325,6 @@ </para> </listitem> </varlistentry> - <varlistentry xml:id="ini.memcached.compression-threshold"> <term> <parameter>memcached.compression_threshold</parameter> @@ -252,7 +337,6 @@ </para> </listitem> </varlistentry> - <varlistentry xml:id="ini.memcached.serializer"> <term> <parameter>memcached.serializer</parameter> @@ -260,7 +344,7 @@ </term> <listitem> <para> - Настройка сериализатора по умолчанию для новых объектов memcached. Допустимые значения: php, igbinary, json, json_array. + Настройка сериализатора по умолчанию для новых объектов memcached. Допустимые значения: php, igbinary, json, json_array, msgpack. </para> <variablelist> <varlistentry> @@ -269,7 +353,7 @@ <para> Стандартное кодирование JSON. Этот сериализатор быстрый и компактный, но работает только с данными в UTF-8 и не полностью реализует сериализацию. - Подробности смотри в описании расширения JSON. + Подробности смотрите в описании модуле JSON. Доступно с memcached 0.2.0. </para> </listitem> </varlistentry> @@ -277,7 +361,7 @@ <term>json_array</term> <listitem> <para> - Тот же json, но раскодируется в массивы. + Тот же json, но раскодируется в массивы. Доступно с memcached 2.0.0. </para> </listitem> </varlistentry> @@ -293,21 +377,28 @@ <term>igbinary</term> <listitem> <para> - Бинарный сериализатор. + Бинарный сериализатор. Доступно с memcached 0.1.4 </para> </listitem> </varlistentry> + <varlistentry> + <term>msgpack</term> + <listitem> + <para> + Межъязыковой двоичный сериализатор. Доступно с memcached 2.2.0. + </para> + </listitem> + </varlistentry> </variablelist> <para> - По умолчанию igbinary, если доступен. Иначе PHP. + По умолчанию igbinary, если доступен, затем igbinary, если доступен, иначе PHP. </para> </listitem> </varlistentry> - <varlistentry xml:id="ini.memcached.use-sasl"> <term> <parameter>memcached.use_sasl</parameter> - <type>int</type> + <type>bool</type> </term> <listitem> <para> @@ -315,7 +406,193 @@ </para> </listitem> </varlistentry> +<varlistentry xml:id="ini.memcached.default-binary-protocol"> + <term> + <parameter>memcached.default_binary_protocol</parameter> + <type>bool</type> + </term> + <listitem> + <para> + Устанавливает протокол memcached по умолчанию для новых подключений. (Чтобы настроить протокол memcached для соединений, используемых сессиями, используйте вместо него memcached.sess_binary_protocol) + + Если установлено значение On, по умолчанию используется двоичный протокол memcached. Если установлено значение Off, используется текстовый протокол memcached. По умолчанию Off + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.memcached.default-connect-timeout"> + <term> + <parameter>memcached.default_connect_timeout</parameter> + <type>int</type> + </term> + <listitem> + <para> + Устанавливает время ожидания соединения memcached по умолчанию для новых соединений. (Чтобы настроить время ожидания соединения memcached для сессий, используйте вместо этого memcached.sess_connect_timeout) + + В неблокирующем режиме это изменяет значение времени ожидания во время подключения к сокету в миллисекундах. Указание -1 означает бесконечное время ожидания. + Указание 0 означает использование времени ожидания соединения по умолчанию для библиотеки memcached. По умолчанию 0. + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.memcached.default-consistent-hash"> + <term> + <parameter>memcached.default_consistent_hash</parameter> + <type>bool</type> + </term> + <listitem> + <para> + Устанавливает значение по умолчанию для согласованного хеширования для новых подключений. (Чтобы настроить согласованное хеширование для сессий, используйте вместо этого memcached.sess_consistent_hash) + Если установлено значение On, для обработки сессии используется согласованное хеширование (libketama). Когда используется согласованное хеширование, можно добавлять или удалять узлы кеша, не беспокоясь о том, что существующие ключи по умолчанию отключены. + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.memcached.sess-binary-protocol"> + <term> + <parameter>memcached.sess_binary_protocol</parameter> + <type>bool</type> + </term> + <listitem> + <para> + Используйте двоичный протокол memcached для сессий memcached (вместо текстового протокола). Реплики libmemcached работают, только если включён двоичный режим. Однако некоторые прокси (например, twemproxy) будут работать, только если двоичный протокол отключён. В более старых версиях php-memcached этот параметр был выключен и назывался memcached.sess_binary. По умолчанию включено с libmemcached 1.0.18 или новее. По умолчанию в старой версии отключено. + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.memcached.sess-connect-timeout"> + <term> + <parameter>memcached.sess_connect_timeout</parameter> + <type>int</type> + </term> + <listitem> + <para> + Значение времени ожидания соединения memcached + В неблокирующем режиме это изменяет значение времени ожидания во время соединения сокета в миллисекундах. Указание -1 означает бесконечное время ожидания. + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.memcached.sess-consistent-hash-type"> + <term> + <parameter>memcached.sess_consistent_hash_type</parameter> + <type>string</type> + </term> + <listitem> + <para> + Тип согласованного хеширования сессии Memcached. Если установлено значение 'ketama' (по умолчанию для php-memcached 3.x), для обработки сессии используется согласованное хеширование libketama, если установлено значение 'ketama_weighted' (по умолчанию для php-memcached 2.x), для обработки сессии используется взвешенное согласованное хеширование (libketama). По умолчанию - "ketama". + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.memcached.sess-lock-expire"> + <term> + <parameter>memcached.sess_lock_expire</parameter> + <type>int</type> + </term> + <listitem> + <para> + Время в секундах до того, как должна сработать блокировка. Установка в 0 приводит к поведению по умолчанию, которое заключается в использовании PHP max_execution_time. По умолчанию 0. + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.memcached.sess-lock-retries"> + <term> + <parameter>memcached.sess_lock_retries</parameter> + <type>int</type> + </term> + <listitem> + <para> + Количество попыток повторной блокировки блокировки сессии, не включая первую попытку. По умолчанию 5. + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.memcached.sess-lock-wait-max"> + <term> + <parameter>memcached.sess_lock_wait_max</parameter> + <type>int</type> + </term> + <listitem> + <para> + Максимальное время ожидания в миллисекундах между попытками блокировки сессии. По умолчанию 150. + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.memcached.sess-lock-wait-min"> + <term> + <parameter>memcached.sess_lock_wait_min</parameter> + <type>int</type> + </term> + <listitem> + <para> + Минимальное время ожидания в миллисекундах между попытками блокировки сессии. Это значение удваивается при каждой попытке блокировки до тех пор, пока не будет достигнута memcached.sess_lock_wait_max, после чего любые дальнейшие попытки будут занимать sessions_lock_wait_max секунд. По умолчанию 150. + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.memcached.sess-persistent"> + <term> + <parameter>memcached.sess_persistent</parameter> + <type>bool</type> + </term> + <listitem> + <para> + Следует ли повторно использовать соединения memcached, соответствующие значению (значениям) session.save_path после завершения выполнения скрипта. Не используйте это, если определённые настройки (например, настройки SASL, sess_binary_protocol) будут переопределены между запросами. По умолчанию Off. + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.memcached.sess-remove-failed-servers"> + <term> + <parameter>memcached.sess_remove_failed_servers</parameter> + <type>bool</type> + </term> + <listitem> + <para> + Разрешить автоматическое удаление отказавшего сервера memcached. По умолчанию Off. (В предыдущих версиях этот параметр назывался memcached.sess_remove_failed) + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.memcached.sess-server-failure-limit"> + <term> + <parameter>memcached.sess_server_failure_limit</parameter> + <type>int</type> + </term> + <listitem> + <para> + Установите это значение, чтобы разрешить удаление сервера после заданного количества непрерывных сбоев подключения. По умолчанию 0. + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.memcached.sess-sasl-password"> + <term> + <parameter>memcached.sess_sasl_password</parameter> + <type>string</type> + </term> + <listitem> + <para> + Пароль сессии SASL + Для включения SASL необходимо указать имя пользователя и пароль. + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.memcached.sess-sasl-username"> + <term> + <parameter>memcached.sess_sasl_username</parameter> + <type>string</type> + </term> + <listitem> + <para> + Имя пользователя сессии SASL + Для включения SASL необходимо указать имя пользователя и пароль. + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.memcached.store-retry-count"> + <term> + <parameter>memcached.store_retry_count</parameter> + <type>int</type> + </term> + <listitem> + <para> + Количество повторных попыток для неудачных команд сохранения. + Этот механизм обеспечивает прозрачное переключение на вторичные серверы при сбое операций set/increment/decrement/setMulti на желаемом сервере в среде c множеством серверов. по умолчанию — 2 + </para> + </listitem> + </varlistentry> </variablelist> </para> </section> diff --git a/reference/rpminfo/constants.xml b/reference/rpminfo/constants.xml index 8a27d1280..30328b3a7 100644 --- a/reference/rpminfo/constants.xml +++ b/reference/rpminfo/constants.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: sergey Status: ready --> +<!-- EN-Revision: 6e30ba482b992c476f4646168a082ee45fe2d0c0 Maintainer: sergey Status: ready --> <!-- Reviewed: no --> <appendix xml:id="rpminfo.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.constants; @@ -1712,6 +1712,17 @@ </simpara> </listitem> </varlistentry> + <varlistentry xml:id="constant.rpmtag-payloaddigestalt"> + <term> + <constant>RPMTAG_PAYLOADDIGESTALT</constant> + (<type>int</type>) + </term> + <listitem> + <simpara> + С librpm >= 4.16. + </simpara> + </listitem> + </varlistentry> <varlistentry xml:id="constant.rpmtag-payloaddigestalgo"> <term> <constant>RPMTAG_PAYLOADDIGESTALGO</constant>