Added unreviewed translation. Thanks to E-moe.

git-svn-id: https://svn.php.net/repository/phpdoc/ru/trunk@319195 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Max Chaban
2011-11-14 19:26:27 +00:00
parent 743f769e73
commit dd5f7ed600
7 changed files with 672 additions and 0 deletions

View File

@ -0,0 +1,41 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: mch Status: ready -->
<!-- $Revision$ -->
<!-- Reviewed: no -->
<section xml:id="memcache.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.install;
<para>
&pecl.moved;
&pecl.info;
<link xlink:href="&url.pecl.package;memcache">&url.pecl.package;memcache</link>.
</para>
<note>
<para>
Существует возможность запретить использование memcache в качестве обработчика сессий (session handler). Команда 'pecl install'
выдает об этом запрос (по-умолчанию включено). Кроме того, при статической компиляции в PHP для этой цели возможно использование
опции конфигурации <option role="configure">--disable-memcache-session</option>.
</para>
</note>
</section>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View File

@ -0,0 +1,86 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 79dcbe011fb254dcd92c597064571fe313362a09 Maintainer: mch Status: ready -->
<!-- $Revision$ -->
<!-- Reviewed: no -->
<chapter xml:id="memcache.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.examples;
<section xml:id="memcache.examples-overview">
<title>Базовое использование</title>
<para>
<example>
<title>Пример использования расширения memcache</title>
<para>
В этом примере происходит сохранение объекта в кеше и его последующее
чтение. Объекты и другие не скалярные типы сериализируются перед сохранением,
что делает невозможным хранение ресурсов наподобие идентетификаторов
подключений в кеше.
</para>
<programlisting role="php">
<![CDATA[
<?php
$memcache = new Memcache;
$memcache->connect('localhost', 11211) or die ("Не могу подключиться");
$version = $memcache->getVersion();
echo "Версия сервера: ".$version."<br/>\n";
$tmp_object = new stdClass;
$tmp_object->str_attr = 'test';
$tmp_object->int_attr = 123;
$memcache->set('key', $tmp_object, false, 10) or die ("Ошибка при сохранении данных на сервере");
echo "Данные сохранены в кеше. (время жизни данных 10 секунд)<br/>\n";
$get_result = $memcache->get('key');
echo "Данные из кеша:<br/>\n";
var_dump($get_result);
?>
]]>
</programlisting>
</example>
</para>
<para>
<example>
<title>Использование memcache в качестве обработчика сессий</title>
<programlisting role="php">
<![CDATA[
<?php
$session_save_path = "tcp://$host:$port?persistent=1&weight=2&timeout=2&retry_interval=10, ,tcp://$host:$port ";
ini_set('session.save_handler', 'memcache');
ini_set('session.save_path', $session_save_path);
?>
]]>
</programlisting>
</example>
</para>
</section>
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View File

@ -0,0 +1,77 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: mch Status: ready -->
<!-- $Revision$ -->
<!-- Reviewed: no -->
<refentry xml:id="function.memcache-debug" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>memcache_debug</refname>
<refpurpose>Включить/выключить вывод отладочной информации</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>memcache_debug</methodname>
<methodparam><type>bool</type><parameter>on_off</parameter></methodparam>
</methodsynopsis>
<para>
<function>memcache_debug</function> включает вывод отладочной информации, если
<parameter>on_off</parameter> установлен в &true; и выключает, если в &false;.
<note>
<para>
Функция <function>memcache_debug</function> доступна, только если PHP был собран
с использованием опции --enable-debug и в этом случае всегда возвращает &true;.
Иначе вызов этой функции ничего не делает и возвращает &false;.
</para>
</note>
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>on_off</parameter></term>
<listitem>
<para>
Включает вывод отладочной информации если уставновлено в &true;.
Выключает вывод отладочной информации если уставновлено в &false;.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает &true;, если PHP был собран с опцией --enable-debug, иначе - &false;.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

305
reference/memcache/ini.xml Normal file
View File

@ -0,0 +1,305 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f99e201a27ae05f5126ef28a4a5dda464050f162 Maintainer: mch Status: ready -->
<!-- $Revision$ -->
<!-- Reviewed: no -->
<section xml:id="memcache.ini" xmlns="http://docbook.org/ns/docbook">
&reftitle.runtime;
&extension.runtime;
<para>
<table>
<title>Конфигурационные параметры Memcache</title>
<tgroup cols="4">
<thead>
<row>
<entry>Название</entry>
<entry>Значение по-умолчанию</entry>
<entry>Изменяется</entry>
<entry>История</entry>
</row>
</thead>
<tbody>
<row>
<entry><link linkend="ini.memcache.allow-failover">memcache.allow_failover</link></entry>
<entry>"1"</entry>
<entry>PHP_INI_ALL</entry>
<entry>Доступно с memcache 2.0.2.</entry>
</row>
<row>
<entry><link linkend="ini.memcache.max-failover-attempts">memcache.max_failover_attempts</link></entry>
<entry>"20"</entry>
<entry>PHP_INI_ALL</entry>
<entry>Доступно с memcache 2.1.0.</entry>
</row>
<row>
<entry><link linkend="ini.memcache.chunk-size">memcache.chunk_size</link></entry>
<entry>"8192"</entry>
<entry>PHP_INI_ALL</entry>
<entry>Доступно с memcache 2.0.2.</entry>
</row>
<row>
<entry><link linkend="ini.memcache.default-port">memcache.default_port</link></entry>
<entry>"11211"</entry>
<entry>PHP_INI_ALL</entry>
<entry>Доступно с memcache 2.0.2.</entry>
</row>
<row>
<entry><link linkend="ini.memcache.hash-strategy">memcache.hash_strategy</link></entry>
<entry>"standard"</entry>
<entry>PHP_INI_ALL</entry>
<entry>Доступно с memcache 2.2.0.</entry>
</row>
<row>
<entry><link linkend="ini.memcache.hash-function">memcache.hash_function</link></entry>
<entry>"crc32"</entry>
<entry>PHP_INI_ALL</entry>
<entry>Доступно с memcache 2.2.0.</entry>
</row>
<row>
<entry>session.save_handler</entry>
<entry>"files"</entry>
<entry>PHP_INI_ALL</entry>
<entry>Поддерживается с memcache 2.1.2</entry>
</row>
<row>
<entry>session.save_path</entry>
<entry>""</entry>
<entry>PHP_INI_ALL</entry>
<entry>Поддерживается с memcache 2.1.2</entry>
</row>
<row>
<entry>memcache.protocol</entry>
<entry>ascii</entry>
<entry>>PHP_INI_ALL</entry>
<entry>Поддерживается с memcache 3.0.0</entry>
</row>
<row>
<entry>memcache.redundancy</entry>
<entry>1</entry>
<entry>>PHP_INI_ALL</entry>
<entry>Поддерживается с memcache 3.0.0</entry>
</row>
<row>
<entry>memcache.session_redundancy</entry>
<entry>2</entry>
<entry>>PHP_INI_ALL</entry>
<entry>Поддерживается с memcache 3.0.0</entry>
</row>
<row>
<entry>memcache.compress_threshold</entry>
<entry>20000</entry>
<entry>>PHP_INI_ALL</entry>
<entry>Поддерживается с memcache 3.0.3</entry>
</row>
<row>
<entry>memcache.lock_timeout</entry>
<entry>15</entry>
<entry>>PHP_INI_ALL</entry>
<entry>Поддерживается с memcache 3.0.4</entry>
</row>
</tbody>
</tgroup>
</table>
&ini.php.constants;
</para>
&ini.descriptions.title;
<para>
<variablelist>
<varlistentry xml:id="ini.memcache.allow-failover">
<term>
<parameter>memcache.allow_failover</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
Разрешение прозрачного переключения на другие сервера при
возникновении ошибок.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.memcache.max-failover-attempts">
<term>
<parameter>memcache.max_failover_attempts</parameter>
<type>integer</type>
</term>
<listitem>
<para>
Устанавливает число попыток чтения и записи данных.
Используется только в сочетании с memcache.allow_failover.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.memcache.chunk-size">
<term>
<parameter>memcache.chunk_size</parameter>
<type>integer</type>
</term>
<listitem>
<para>
Устанавливает размер передаваемых блоков данных. Использование
малых значений приводит к повышению сетевой активности. В случае
неожиданного замедления работы попробуйте увеличить значение до
32768.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.memcache.default-port">
<term>
<parameter>memcache.default_port</parameter>
<type>string</type>
</term>
<listitem>
<para>
Устанавливает номер TCP порта по умолчанию для подключения к
memcached-серверу, если явно не указан иной.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.memcache.hash-strategy">
<term>
<parameter>memcache.hash_strategy</parameter>
<type>string</type>
</term>
<listitem>
<para>
Контролирует стратегию функций отображения ключей на сервера. Установите этот параметр в
<literal>consistent</literal> для включения последовательного хеширования, которое не требует
переназначения ключей кеша при добавлении и удалении серверов из пула. Уставнока же этого
параметра в <literal>standard</literal> приводит к использованию старой стратегии.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.memcache.hash-function">
<term>
<parameter>memcache.hash_function</parameter>
<type>string</type>
</term>
<listitem>
<para>
Устанавливает хеш-функцию для отображения ключей на сервера. При значении <literal>crc32</literal>
будет использоваться стандартный CRC32 хеш, а при <literal>fnv</literal> - FNV-1a.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.memcache.session-handler">
<term>
<parameter>session.save_handler</parameter>
<type>string</type>
</term>
<listitem>
<para>
Установите этот параметр в <literal>memcache</literal> для использовать memcache в качестве обработчика сессий.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.memcache.save-path">
<term>
<parameter>session.save_path</parameter>
<type>string</type>
</term>
<listitem>
<para>
Устанавливает список адресов серверов, разделенных запятой, для хранений сессий. Например,
<literal>"tcp://host1:11211, tcp://host2:11211"</literal>.
</para>
<para>
Каждый адрес может содержать параметры аналогичные используемым в методе <function>Memcache::addServer</function>,
которые будут применены сервером. Например,
<literal>"tcp://host1:11211?persistent=1&amp;weight=1&amp;timeout=1&amp;retry_interval=15"</literal>
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.memcache.protocol">
<term>
<parameter>memcache.protocol</parameter>
<type>string</type>
</term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.memcache.redundancy">
<term>
<parameter>memcache.redundancy</parameter>
<type>integer</type>
</term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.memcache.session-redundancy">
<term>
<parameter>memcache.session_redundancy</parameter>
<type>integer</type>
</term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.memcache.compress-threshold">
<term>
<parameter>memcache.compress_threshold</parameter>
<type>integer</type>
</term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.memcache.lock-timeout">
<term>
<parameter>memcache.lock_timeout</parameter>
<type>integer</type>
</term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</section>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View File

@ -0,0 +1,68 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8b6d169424ff189bb563ef4c3f35f8adff3f42c5 Maintainer: mch Status: ready -->
<!-- $Revision$ -->
<!-- Reviewed: no -->
<phpdoc:classref xml:id="class.memcache" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Класс Memcache</title>
<titleabbrev>Memcache</titleabbrev>
<partintro>
<!-- {{{ Memcache intro -->
<section xml:id="memcache.intro">
&reftitle.intro;
<para>
Представляет подключение к множесту memcache серверов.
</para>
</section>
<!-- }}} -->
<section xml:id="memcache.synopsis">
&reftitle.classsynopsis;
<!-- {{{ Synopsis -->
<classsynopsis>
<ooclass><classname>Memcache</classname></ooclass>
<!-- {{{ Class synopsis -->
<classsynopsisinfo>
<ooclass>
<classname>Memcache</classname>
</ooclass>
</classsynopsisinfo>
<!-- }}} -->
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.memcache')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" />
</classsynopsis>
<!-- }}} -->
</section>
</partintro>
&reference.memcache.entities.memcache;
</phpdoc:classref>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View File

@ -0,0 +1,32 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: mch Status: ready -->
<!-- $Revision$ -->
<!-- Reviewed: no -->
<reference xml:id="ref.memcache" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Memcache &Functions;</title>
&reference.memcache.entities.functions;
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View File

@ -0,0 +1,63 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: mch Status: ready -->
<!-- $Revision$ -->
<!-- Reviewed: no -->
<chapter xml:id="memcache.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.setup;
<!-- {{{ Requirements -->
<section xml:id="memcache.requirements">
&reftitle.required;
<para>
Этот модуль использует функции <link xlink:href="&url.zlib;">zlib</link>
для поддержки сжатия "на лету". В связи с этим Zlib необходим для уставноки
данного модуля.
</para>
<para>
PHP 4.3.3 или новее необходим для расширения memcache.
</para>
</section>
<!-- }}} -->
<!-- {{{ Installation -->
&reference.memcache.configure;
<!-- }}} -->
<!-- {{{ Configuration -->
&reference.memcache.ini;
<!-- }}} -->
<!-- {{{ Resources -->
<section xml:id="memcache.resources">
&reftitle.resources;
<para>
Существует всего один тип ресурсов, используемых в модуле memcache -
это идентификатор ссылки для подключения к кеш-серверу.
</para>
</section>
<!-- }}} -->
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->