php/archived-doc-ru
1
0
Fork 0
mirror of https://github.com/php/doc-ru.git synced 2026-03-23 23:32:16 +01:00
Code Issues Packages Projects Releases Wiki Activity

memcache : fix XML by converting para to simpara tags via script

Browse Source
This commit is contained in:
Gina Peter Banyard
2026-01-19 03:25:45 +00:00
parent 2cab8c0d8e
commit 2cf87a3d85
25 changed files with 285 additions and 289 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
reference/memcache/book.xml
View File

@@ -1,28 +1,26 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 2e8ef0a1bd98243cb2c6c5c627a195bb53a7a440 Maintainer: aur Status: ready -->
<!-- EN-Revision: f4098e2bac4bcc136b95b85badcf4476fa683477 Maintainer: aur Status: ready -->
<!-- Reviewed: no -->
<book xml:id="book.memcache" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="book.memcache">
<?phpdoc extension-membership="pecl" ?>
<title>Memcache</title>
<!-- {{{ preface -->
<preface xml:id="intro.memcache">
&reftitle.intro;
<para>
<simpara>
Модуль Memcache предоставляет удобный процедурный и объектно-ориентированный
интерфейс к memcached, высокоэффективному кеширующему демону, который
был специально разработан для снижения нагрузки на базу данных
в динамических веб приложениях.
</para>
<para>
</simpara>
<simpara>
Модуль Memcache также предоставляет дескриптор <link linkend="ref.session">сессий</link>
(<literal>memcache</literal>).
</para>
<para>
Больше информации о memcached вы сможете найти на <link
xlink:href="&url.memcache;">&url.memcache;</link>.
</para>
</simpara>
<simpara>
Больше информации о memcached вы сможете найти на <link xlink:href="&url.memcache;">&url.memcache;</link>.
</simpara>
</preface>
<!-- }}} -->

12
reference/memcache/configure.xml
View File

@@ -1,19 +1,19 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: mch Status: ready -->
<!-- EN-Revision: f4098e2bac4bcc136b95b85badcf4476fa683477 Maintainer: mch Status: ready -->
<!-- Reviewed: no -->
<section xml:id="memcache.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="memcache.installation">
&reftitle.install;
<para>
<simpara>
&pecl.moved;
&pecl.info;
<link xlink:href="&url.pecl.package;memcache">&url.pecl.package;memcache</link>.
</para>
</simpara>
<note>
<para>
<simpara>
Существует возможность запретить использование memcache в качестве обработчика сессий (session handler). Команда 'pecl install'
выдаёт об этом запрос (по умолчанию включено). Кроме того, при статической компиляции в PHP для этой цели возможно использование
опции конфигурации <option role="configure">--disable-memcache-session</option>.
</para>
</simpara>
</note>
</section>

6
reference/memcache/examples.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f77acbec03e0937e560e9f901a26bb5f6f6992fb Maintainer: mch Status: ready -->
<!-- EN-Revision: f4098e2bac4bcc136b95b85badcf4476fa683477 Maintainer: mch Status: ready -->
<!-- Reviewed: no -->
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="memcache.examples">
&reftitle.examples;
@@ -7,12 +7,12 @@
<title>Базовое использование</title>
<example>
<title>Пример использования модуля memcache</title>
<para>
<simpara>
В этом примере происходит сохранение объекта в кеше и его последующее
чтение. Объекты и другие нескалярные типы сериализируются перед сохранением,
что делает невозможным хранение ресурсов (например, идентификаторов
подключений и др.) в кеше.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

14
reference/memcache/functions/memcache-debug.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f77acbec03e0937e560e9f901a26bb5f6f6992fb Maintainer: mch Status: ready -->
<!-- EN-Revision: f4098e2bac4bcc136b95b85badcf4476fa683477 Maintainer: mch Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.memcache-debug">
<refnamediv>
@@ -18,11 +18,11 @@
<function>memcache_debug</function> включает вывод отладочной информации, если
<parameter>on_off</parameter> установлен в &true; и выключает, если в &false;.
<note>
<para>
<simpara>
Функция <function>memcache_debug</function> доступна, только если PHP был собран
с использованием опции --enable-debug и в этом случае всегда возвращает &true;.
Иначе вызов этой функции ничего не делает и возвращает &false;.
</para>
</simpara>
</note>
</para>
@@ -34,10 +34,10 @@
<varlistentry>
<term><parameter>on_off</parameter></term>
<listitem>
<para>
<simpara>
Включает вывод отладочной информации, если установлено в &true;.
Выключает вывод отладочной информации, если установлено в &false;.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -45,9 +45,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Возвращает &true;, если PHP был собран с опцией --enable-debug, иначе - &false;.
</para>
</simpara>
</refsect1>
</refentry>

58
reference/memcache/ini.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f77acbec03e0937e560e9f901a26bb5f6f6992fb Maintainer: mch Status: ready -->
<!-- EN-Revision: f4098e2bac4bcc136b95b85badcf4476fa683477 Maintainer: mch Status: ready -->
<!-- Reviewed: no -->
<section xmlns="http://docbook.org/ns/docbook" xml:id="memcache.ini">
&reftitle.runtime;
@@ -126,10 +126,10 @@
<type>bool</type>
</term>
<listitem>
<para>
<simpara>
Разрешение прозрачного переключения (failover) на другие сервера при
возникновении ошибок.
</para>
</simpara>
</listitem>
</varlistentry>
@@ -139,10 +139,10 @@
<type>int</type>
</term>
<listitem>
<para>
<simpara>
Устанавливает число попыток чтения и записи данных.
Используется только в сочетании с memcache.allow_failover.
</para>
</simpara>
</listitem>
</varlistentry>
@@ -152,12 +152,12 @@
<type>int</type>
</term>
<listitem>
<para>
<simpara>
Устанавливает размер передаваемых блоков данных. Использование
малых значений приводит к повышению сетевой активности. В случае
неожиданного замедления работы попробуйте увеличить значение до
32768.
</para>
</simpara>
</listitem>
</varlistentry>
@@ -167,10 +167,10 @@
<type>string</type>
</term>
<listitem>
<para>
<simpara>
Устанавливает номер TCP-порта по умолчанию для подключения к
серверу memcached, если явно не указан иной.
</para>
</simpara>
</listitem>
</varlistentry>
@@ -180,12 +180,12 @@
<type>string</type>
</term>
<listitem>
<para>
<simpara>
Контролирует стратегию функций отображения ключей на сервера. Установите этот параметр в
<literal>consistent</literal> для включения последовательного хеширования, которое не требует
переназначения ключей кеша при добавлении и удалении серверов из пула. Установка же этого
параметра в <literal>standard</literal> приводит к использованию старой стратегии.
</para>
</simpara>
</listitem>
</varlistentry>
@@ -195,10 +195,10 @@
<type>string</type>
</term>
<listitem>
<para>
<simpara>
Устанавливает хеш-функцию для отображения ключей на сервера. При значении <literal>crc32</literal>
будет использоваться стандартный CRC32 хеш, а при <literal>fnv</literal> - FNV-1a.
</para>
</simpara>
</listitem>
</varlistentry>
@@ -208,9 +208,9 @@
<type>string</type>
</term>
<listitem>
<para>
<simpara>
</para>
</simpara>
</listitem>
</varlistentry>
@@ -220,9 +220,9 @@
<type>int</type>
</term>
<listitem>
<para>
<simpara>
</para>
</simpara>
</listitem>
</varlistentry>
@@ -232,9 +232,9 @@
<type>int</type>
</term>
<listitem>
<para>
<simpara>
</para>
</simpara>
</listitem>
</varlistentry>
@@ -244,9 +244,9 @@
<type>int</type>
</term>
<listitem>
<para>
<simpara>
</para>
</simpara>
</listitem>
</varlistentry>
@@ -256,9 +256,9 @@
<type>int</type>
</term>
<listitem>
<para>
<simpara>
</para>
</simpara>
</listitem>
</varlistentry>
@@ -268,9 +268,9 @@
<type>string</type>
</term>
<listitem>
<para>
<simpara>
Установите этот параметр в <literal>memcache</literal> для использования memcache в качестве обработчика сессий.
</para>
</simpara>
</listitem>
</varlistentry>
@@ -280,15 +280,15 @@
<type>string</type>
</term>
<listitem>
<para>
<simpara>
Устанавливает список адресов серверов, разделённых запятой, для хранений сессий. Например,
<literal>"tcp://host1:11211, tcp://host2:11211"</literal>.
</para>
<para>
</simpara>
<simpara>
Каждый адрес может содержать параметры, аналогичные используемым в методе <function>Memcache::addServer</function>,
которые будут применены сервером. Например,
<literal>"tcp://host1:11211?persistent=1&amp;weight=1&amp;timeout=1&amp;retry_interval=15"</literal>
</para>
</simpara>
</listitem>
</varlistentry>

11
reference/memcache/memcache.xml
View File

@@ -1,8 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8b6d169424ff189bb563ef4c3f35f8adff3f42c5 Maintainer: mch Status: ready -->
<!-- EN-Revision: f4098e2bac4bcc136b95b85badcf4476fa683477 Maintainer: mch Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.memcache" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<reference xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="class.memcache" role="class">
<title>Класс Memcache</title>
<titleabbrev>Memcache</titleabbrev>
@@ -12,9 +11,9 @@
<!-- {{{ Memcache intro -->
<section xml:id="memcache.intro">
&reftitle.intro;
<para>
<simpara>
Представляет подключение к набору серверов memcache.
</para>
</simpara>
</section>
<!-- }}} -->
@@ -33,7 +32,7 @@
</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])" />
<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>
<!-- }}} -->

26
reference/memcache/memcache/add.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f77acbec03e0937e560e9f901a26bb5f6f6992fb Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: f4098e2bac4bcc136b95b85badcf4476fa683477 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="memcache.add">
<refnamediv>
@@ -26,11 +26,11 @@
<methodparam choice="opt"><type>int</type><parameter>expire</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Метод <function>Memcache::add</function> записывает элемент
<parameter>var</parameter> с ключом <parameter>key</parameter>,
только если сервер ещё не содержит ключ.
</para>
</simpara>
</refsect1>
@@ -40,37 +40,37 @@
<varlistentry>
<term><parameter>key</parameter></term>
<listitem>
<para>
<simpara>
Ключ, с которым свяжется элемент.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>var</parameter></term>
<listitem>
<para>
<simpara>
Переменная для сохранения. Строковые и числовые значения сохраняются как есть,
а остальные типы сериализируются.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>flag</parameter></term>
<listitem>
<para>
<simpara>
При передаче флага <constant>MEMCACHE_COMPRESSED</constant> элемент
сохраняется в сжатом виде. Модуль сжимает элемент средствами библиотеки zlib.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>expire</parameter></term>
<listitem>
<para>
<simpara>
Время жизни элемента. При передаче значения 0 элемент никогда не устаревает. Параметр также принимает
метку времени Unix или число секунд, начиная с текущего момента, но тогда числу секунд
нельзя превышать значение 2592000, что эквивалентно 30 дням.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -78,11 +78,11 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
Метод возвращает &false;, если такой ключ уже существует, иначе поведение
метода <function>Memcache::add</function> аналогично методу <function>Memcache::set</function>.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

70
reference/memcache/memcache/addserver.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f77acbec03e0937e560e9f901a26bb5f6f6992fb Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: f4098e2bac4bcc136b95b85badcf4476fa683477 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="memcache.addserver">
<refnamediv>
@@ -36,30 +36,30 @@
<methodparam choice="opt"><type>int</type><parameter>timeoutms</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Метод <function>Memcache::addServer</function> добавляет сервер в пул соединений.
</para>
</simpara>
<para>
<simpara>
В отличие от методов <function>Memcache::connect</function>
и <function>Memcache::pconnect</function> при вызове этого метода сетевое соединение не устанавливается,
пока не потребуется. Поэтому
при добавлении большого количества серверов в пул производительность не снижается,
поскольку, возможно, соединения не потребуются.
</para>
</simpara>
<para>
<simpara>
Потребность в отказоустойчивости возникает на любом этапе в любом методе,
и если при этом хотя бы один сервер из пула окажется доступен, пользователь не получит
оповещения. Любой тип ошибки сокета или сервера Memcached, за исключением ошибки переполнения
памяти, может включить протокол обеспечения отказоустойчивости. Стандартные клиентские ошибки
наподобие добавления существующего ключа не вызовут такого поведения.
</para>
</simpara>
<note>
<para>
<simpara>
Метод добавили в модуль Memcache версии 2.0.0.
</para>
</simpara>
</note>
</refsect1>
@@ -70,60 +70,60 @@
<varlistentry>
<term><parameter>host</parameter></term>
<listitem>
<para>
<simpara>
Параметр указывает на хост с запущенным сервисом memcached. Для параметра возможно установить
значение наподобие <literal>unix:///path/to/memcached.sock</literal> для соединения с Unix-сокетом,
но тогда для параметра <parameter>port</parameter> потребуется установить
значение <literal>0</literal>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>port</parameter></term>
<listitem>
<para>
<simpara>
Параметр указывает порт, по которому доступен сервис memcached. Для соединения с Unix-сокетом
потребуется установить для параметра значение <literal>0</literal>.
</para>
<para>
</simpara>
<simpara>
Обратите внимание: значение параметра <parameter>port</parameter> по умолчанию равно значению директивы
<link linkend="ini.memcache.default-port">memcache.default_port</link>.
Поэтому при вызове метода рекомендуют указывать номер порта.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>persistent</parameter></term>
<listitem>
<para>
<simpara>
Устанавливать ли постоянное соединение. Значение по умолчанию равно &true;.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>weight</parameter></term>
<listitem>
<para>
<simpara>
Необходимое количество созданных пакетов данных для этого сервера, что,
в свою очередь, определяет вероятность выбора сервера. Вероятность
рассчитывается относительно общего веса всех серверов.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem>
<para>
<simpara>
Время ожидания в секундах для подключения к демону.
Изменение значения по умолчанию в 1 секунду
часто нивелирует преимущества кеширования на медленных соединениях.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>retry_interval</parameter></term>
<listitem>
<para>
<simpara>
Параметр управляет частотой проверки доступности отказавшего сервера, значение по умолчанию
равно 15 секундам.
Со значением "-1" попытки проверить доступность сервера
@@ -132,8 +132,8 @@
не оказывают никакого влияния,
если модуль загружен динамически через функцию
<function>dl</function>.
</para>
<para>
</simpara>
<simpara>
Каждая провалившаяся структура соединения содержит своё значение
времени ожидания, и, пока оно не превышено, структура пропускается, после чего
попробует выбрать другой сервер для обслуживания запроса. После
@@ -143,13 +143,13 @@
Обычно эффект заключается в том, что каждый процесс веб-сервера
ожидает секунд при обслуживании
запроса, сколько указали в параметре <parameter>retry_interval</parameter>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>status</parameter></term>
<listitem>
<para>
<simpara>
Параметр определяет, помечать ли сервер флагом "онлайн". Одновременная установка
значения &false; для этого параметра и значения -1 для параметра <parameter>retry_interval</parameter>
оставит отказавший сервер в пуле, чтобы не влиять на алгоритм распределения
@@ -159,26 +159,26 @@
сразу же прервётся с ошибкой, в зависимости от настройки
директивы <parameter>memcache.allow_failover</parameter>. Значение по умолчанию равно &true; —
сервер активен и готов принимать запросы.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>failure_callback</parameter></term>
<listitem>
<para>
<simpara>
Пользовательская callback-функция, которая запустится
при ошибке. Эта функция вызывается
до запуска механизма отказоустойчивости. Функция принимает два
параметра — имя хоста и порт отказавшего сервера.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeoutms</parameter></term>
<listitem>
<para>
<simpara>
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -186,9 +186,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -217,11 +217,11 @@ memcache_add_server($memcache_obj, 'memcache_host2', 11211);
<refsect1 role="notes">
&reftitle.notes;
<warning>
<para>
<simpara>
При пропуске параметра <parameter>port</parameter> метод извлекает значение ini-директивы PHP
<link linkend="ini.memcache.default-port">memcache.default_port</link>.
При изменении значения директивы в коде приложения поведение метода становится непредсказуемым. Поэтому лучше явно указывать порт при вызове метода.
</para>
</simpara>
</warning>
</refsect1>

10
reference/memcache/memcache/close.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f77acbec03e0937e560e9f901a26bb5f6f6992fb Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: f4098e2bac4bcc136b95b85badcf4476fa683477 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="memcache.close">
<refnamediv>
@@ -19,11 +19,11 @@
<methodparam><type>Memcache</type><parameter>memcache</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Метод <function>Memcache::close</function> закрывает соединение с сервером memcached.
Метод не закрывает постоянное соединение, которое закрывается только
при завершении работы или перезапуске веб-сервера.
</para>
</simpara>
</refsect1>
@@ -34,9 +34,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

30
reference/memcache/memcache/connect.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f77acbec03e0937e560e9f901a26bb5f6f6992fb Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: f4098e2bac4bcc136b95b85badcf4476fa683477 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="memcache.connect">
<refnamediv>
@@ -23,12 +23,12 @@
<methodparam choice="opt"><type>int</type><parameter>timeout</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Метод <function>Memcache::connect</function> устанавливает соединение с сервером memcached.
Соединение, которое открыли методом <function>Memcache::connect</function>, автоматически
закрывается при завершении работы скрипта.
Соединение закрывают методом <function>Memcache::close</function>.
</para>
</simpara>
</refsect1>
@@ -38,38 +38,38 @@
<varlistentry>
<term><parameter>host</parameter></term>
<listitem>
<para>
<simpara>
В параметре указывается хост, на котором сервер memcached прослушивает соединения,
или другие транспортные протоколы наподобие
<literal>unix:///path/to/memcached.sock</literal> для соединения с сокетом Unix-домена;
при соединении с сокетом для параметра <parameter>port</parameter> потребуется установить значение
<literal>0</literal>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>port</parameter></term>
<listitem>
<para>
<simpara>
В параметре указывается порт, на котором сервер memcached прослушивает соединения. При соединении с сокетом Unix-домена
для параметра устанавливают значение <literal>0</literal>.
</para>
<para>
</simpara>
<simpara>
Обратите внимание: при пропуске аргумента значение параметра <parameter>port</parameter>
становится равным значению директивы
<link linkend="ini.memcache.default-port">memcache.default_port</link>.
Поэтому при вызове метода лучше явно указывать порт.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem>
<para>
<simpara>
Время ожидания в секундах для подключения к демону.
Изменение значения по умолчанию в 1 секунду
часто нивелирует преимущества кеширования на медленных соединениях.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -77,9 +77,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -108,12 +108,12 @@ $memcache->connect('memcache_host', 11211);
<refsect1 role="notes">
&reftitle.notes;
<warning>
<para>
<simpara>
При пропуске параметра <parameter>port</parameter> метод извлекает значение ini-директивы PHP
<link linkend="ini.memcache.default-port">memcache.default_port</link>.
При изменении значения директивы в коде приложения поведение метода становится непредсказуемым.
Поэтому при вызове метода лучше явно указывать порт.
</para>
</simpara>
</warning>
</refsect1>

22
reference/memcache/memcache/decrement.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f77acbec03e0937e560e9f901a26bb5f6f6992fb Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: f4098e2bac4bcc136b95b85badcf4476fa683477 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="memcache.decrement">
<refnamediv>
@@ -27,16 +27,16 @@
Аналогично методу <function>Memcache::increment</function> текущее значение элемента
приводится к числовому, а затем из числа вычитается значение <parameter>value</parameter>.
<note>
<para>
<simpara>
Новое значение элемента не опускается ниже нуля.
</para>
</simpara>
</note>
<note>
<para>
<simpara>
Лучше не вызывать метод <function>Memcache::decrement</function> с элементом,
который сохранили в сжатом виде, поскольку очередной вызов
метода <function>Memcache::get</function> завершится ошибкой.
</para>
</simpara>
</note>
Метод <function>Memcache::decrement</function> <emphasis>не</emphasis> создаёт
элемент, который ещё не содержится в кеше.
@@ -50,17 +50,17 @@
<varlistentry>
<term><parameter>key</parameter></term>
<listitem>
<para>
<simpara>
Ключ элемента, который требуется декрементировать.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>value</parameter></term>
<listitem>
<para>
<simpara>
Параметр <parameter>value</parameter> определяет шаг уменьшения элемента.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -68,9 +68,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Метод возвращает новое значение элемента, если выполнился успешно,&return.falseforfailure;.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

18
reference/memcache/memcache/delete.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f77acbec03e0937e560e9f901a26bb5f6f6992fb Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: f4098e2bac4bcc136b95b85badcf4476fa683477 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="memcache.delete">
<refnamediv>
@@ -22,9 +22,9 @@
<methodparam choice="opt"><type>int</type><parameter>exptime</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Функция <function>Memcache::delete</function> удаляет элемент по ключу <parameter>key</parameter>.
</para>
</simpara>
</refsect1>
@@ -34,19 +34,19 @@
<varlistentry>
<term><parameter>key</parameter></term>
<listitem>
<para>
<simpara>
Ключ удаляемого элемента.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>exptime</parameter></term>
<listitem>
<para>
<simpara>
Параметр устарел и больше не поддерживается. Значение
по умолчанию равно <literal>0</literal> секунд.
Этот параметр не устанавливают.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -54,9 +54,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="changelog">

10
reference/memcache/memcache/flush.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f77acbec03e0937e560e9f901a26bb5f6f6992fb Maintainer: lex Status: ready -->
<!-- EN-Revision: f4098e2bac4bcc136b95b85badcf4476fa683477 Maintainer: lex Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="memcache.flush">
<refnamediv>
@@ -19,12 +19,12 @@
<methodparam><type>Memcache</type><parameter>memcache</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Метод <function>Memcache::flush</function> мгновенно очищает
кеш. Метод <function>Memcache::flush</function>
не удаляет данные, а только помечает элементы кеша устаревшими.
Память перезаписывается по мере добавления новых элементов.
</para>
</simpara>
</refsect1>
@@ -35,9 +35,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

22
reference/memcache/memcache/get.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f77acbec03e0937e560e9f901a26bb5f6f6992fb Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: f4098e2bac4bcc136b95b85badcf4476fa683477 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="memcache.get">
<refnamediv>
@@ -33,16 +33,16 @@
<methodparam choice="opt"><type>array</type><parameter role="reference">flags</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Метод <function>Memcache::get</function> возвращает данные элемента с ключом <parameter>key</parameter>,
если сервер содержит такой ключ.
</para>
</simpara>
<para>
<simpara>
При передаче в метод <function>Memcache::get</function> массива ключей
возвращается массив значений.
В массив с результатами добавляются только те пары «ключ — значение», которые содержит кеш сервера, остальные игнорируются.
</para>
</simpara>
</refsect1>
@@ -52,21 +52,21 @@
<varlistentry>
<term><parameter>key</parameter></term>
<listitem>
<para>
<simpara>
Ключ или массив ключей для извлечения элементов.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>flags</parameter></term>
<listitem>
<para>
<simpara>
При вызове метода с этим аргументом параметр заполняется флагами, которые метод извлёк вместе со значениями.
Это в точности те флаги, которые указывают, например, при вызове метода <function>Memcache::set</function>.
Младший байт каждого целочисленного значения резервируется для внутренних целей модуля
pecl/memcache,
например, чтобы указать статус сжатия или сериализации.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -74,14 +74,14 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Метод возвращает значение, которое связали с ключом <parameter>key</parameter>,
или массив найденных пар «ключ — значение», если в параметр <parameter>key</parameter> передали
массив.
Метод возвращает значение &false;, если возникла ошибка, сервер не нашёл
ключ <parameter>key</parameter>
или с ключом <parameter>key</parameter> связали пустой массив.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

26
reference/memcache/memcache/getextendedstats.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f77acbec03e0937e560e9f901a26bb5f6f6992fb Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: f4098e2bac4bcc136b95b85badcf4476fa683477 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="memcache.getextendedstats">
<refnamediv>
@@ -24,17 +24,17 @@
<methodparam choice="opt"><type>int</type><parameter>limit</parameter><initializer>100</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Метод <function>Memcache::getExtendedStats</function> возвращает двумерный ассоциативный массив, который содержит
статистику серверов. Ключи массива соответствуют формату host:port сервера, а значения содержат статистику
отдельного сервера. Для неисправных серверов возвращается запись
со значением &false;.
</para>
</simpara>
<note>
<para>
<simpara>
Функцию добавили в модуль Memcache версии 2.0.0.
</para>
</simpara>
</note>
</refsect1>
@@ -46,32 +46,32 @@
<varlistentry>
<term><parameter>type</parameter></term>
<listitem>
<para>
<simpara>
Тип статистики для извлечения. Допустимые значения: reset,
malloc, maps, cachedump, slabs, items, sizes. Спецификация протокола
Memcached предупреждает о возможном изменении или удалении этих дополнительных аргументов в новых версиях сервера,
по усмотрению разработчиков, даже если изменения нарушат обратную совместимость.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>slabid</parameter></term>
<listitem>
<para>
<simpara>
Параметр устанавливают одновременно с передачей в параметр <parameter>type</parameter> значения cachedump,
чтобы указать, из какого slab-класса выгружать дамп кеша. Команда cachedump
блокирует работу сервера и выполняется
только в целях отладки.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>limit</parameter></term>
<listitem>
<para>
<simpara>
Параметр устанавливают одновременно с передачей в параметр <parameter>type</parameter> значения cachedump,
чтобы ограничить количество записей в дампе.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -86,10 +86,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Метод возвращает двумерный ассоциативный массив, который содержит статистику по серверам, или значение &false;,
если возникла ошибка.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

22
reference/memcache/memcache/getserverstatus.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f77acbec03e0937e560e9f901a26bb5f6f6992fb Maintainer: lex Status: ready -->
<!-- EN-Revision: f4098e2bac4bcc136b95b85badcf4476fa683477 Maintainer: lex Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="memcache.getserverstatus">
<refnamediv>
@@ -22,14 +22,14 @@
<methodparam choice="opt"><type>int</type><parameter>port</parameter><initializer>11211</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Метод <function>Memcache::getServerStatus</function> возвращает статус сервера: онлайн или офлайн.
</para>
</simpara>
<note>
<para>
<simpara>
Функцию добавили в модуль Memcache версии 2.1.0.
</para>
</simpara>
</note>
</refsect1>
@@ -40,17 +40,17 @@
<varlistentry>
<term><parameter>host</parameter></term>
<listitem>
<para>
<simpara>
В параметре указывается хост, на котором сервер memcached прослушивает соединения.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>port</parameter></term>
<listitem>
<para>
<simpara>
В параметре указывается порт, на котором сервер memcached прослушивает соединения.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -58,9 +58,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Метод возвращает статус сервера: 0 при сбое сервера, иначе ненулевое значение.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

22
reference/memcache/memcache/getstats.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f77acbec03e0937e560e9f901a26bb5f6f6992fb Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: f4098e2bac4bcc136b95b85badcf4476fa683477 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="memcache.getstats">
<refnamediv>
@@ -24,10 +24,10 @@
<methodparam choice="opt"><type>int</type><parameter>limit</parameter><initializer>100</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Метод <function>Memcache::getStats</function> возвращает ассоциативный массив, который содержит статистику сервера.
Ключи массива соответствуют параметрам статистики, а значения — значениям параметров.
</para>
</simpara>
</refsect1>
@@ -37,32 +37,32 @@
<varlistentry>
<term><parameter>type</parameter></term>
<listitem>
<para>
<simpara>
Тип статистики для извлечения. Допустимые значения: reset,
malloc, maps, cachedump, slabs, items, sizes. Спецификация протокола
Memcached предупреждает о возможном изменении или удалении этих дополнительных аргументов в новых версиях сервера,
по усмотрению разработчиков, даже если изменения нарушат обратную совместимость.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>slabid</parameter></term>
<listitem>
<para>
<simpara>
Параметр устанавливают одновременно с передачей в параметр <parameter>type</parameter> значения cachedump,
чтобы указать, из какого slab-класса выгружать дамп кеша. Команда cachedump
блокирует работу сервера и выполняется
только в целях отладки.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>limit</parameter></term>
<listitem>
<para>
<simpara>
Параметр устанавливают одновременно с передачей в параметр <parameter>type</parameter> значения cachedump,
чтобы ограничить количество записей в дампе.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -70,9 +70,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Метод возвращает ассоциативный массив со статистикой сервера&return.falseforfailure;.
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

10
reference/memcache/memcache/getversion.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f77acbec03e0937e560e9f901a26bb5f6f6992fb Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: f4098e2bac4bcc136b95b85badcf4476fa683477 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="memcache.getversion">
<refnamediv>
@@ -19,9 +19,9 @@
<methodparam><type>Memcache</type><parameter>memcache</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Метод <function>Memcache::getVersion</function> возвращает строку с номером версии сервера.
</para>
</simpara>
</refsect1>
@@ -32,9 +32,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Метод возвращает строку с номером версии сервера&return.falseforfailure;.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

18
reference/memcache/memcache/increment.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f77acbec03e0937e560e9f901a26bb5f6f6992fb Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: f4098e2bac4bcc136b95b85badcf4476fa683477 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="memcache.increment">
<refnamediv>
@@ -30,11 +30,11 @@
Метод <function>Memcache::increment</function> <emphasis>не</emphasis> создаёт
элемент, который ещё не содержится в кеше.
<note>
<para>
<simpara>
Лучше не вызывать метод <function>Memcache::increment</function> с элементом,
который сохранили в сжатом виде, поскольку очередной вызов
метода <function>Memcache::get</function> завершится ошибкой.
</para>
</simpara>
</note>
</para>
@@ -46,17 +46,17 @@
<varlistentry>
<term><parameter>key</parameter></term>
<listitem>
<para>
<simpara>
Ключ элемента, который требуется инкрементировать.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>value</parameter></term>
<listitem>
<para>
<simpara>
Параметр <parameter>value</parameter> определяет шаг увеличения элемента.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -64,9 +64,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Метод возвращает новое значение элемента, если выполнился успешно,&return.falseforfailure;.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

22
reference/memcache/memcache/pconnect.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f77acbec03e0937e560e9f901a26bb5f6f6992fb Maintainer: lex Status: ready -->
<!-- EN-Revision: f4098e2bac4bcc136b95b85badcf4476fa683477 Maintainer: lex Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="memcache.pconnect">
<refnamediv>
@@ -23,13 +23,13 @@
<methodparam choice="opt"><type>int</type><parameter>timeout</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Метод <function>Memcache::pconnect</function> аналогичен методу
<function>Memcache::connect</function>, но устанавливает
постоянное соединение.
Соединение не закрывается ни после завершения выполнения скрипта,
ни вызовом метода <function>Memcache::close</function>.
</para>
</simpara>
</refsect1>
@@ -39,32 +39,32 @@
<varlistentry>
<term><parameter>host</parameter></term>
<listitem>
<para>
<simpara>
В параметре указывается хост, на котором сервер memcached прослушивает соединения,
или другие транспортные протоколы наподобие
<literal>unix:///path/to/memcached.sock</literal> для соединения с сокетом Unix-домена;
при соединении с сокетом для параметра <parameter>port</parameter> потребуется установить значение
<literal>0</literal>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>port</parameter></term>
<listitem>
<para>
<simpara>
В параметре указывается порт, на котором сервер memcached прослушивает соединения. При соединении с сокетом Unix-домена
для параметра устанавливают значение <literal>0</literal>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem>
<para>
<simpara>
Время ожидания в секундах для подключения к демону.
Изменение значения по умолчанию в 1 секунду
часто нивелирует преимущества кеширования на медленных соединениях.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -72,9 +72,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Метод возвращает объект Memcache&return.falseforfailure;.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

26
reference/memcache/memcache/replace.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f77acbec03e0937e560e9f901a26bb5f6f6992fb Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: f4098e2bac4bcc136b95b85badcf4476fa683477 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="memcache.replace">
<refnamediv>
@@ -26,12 +26,12 @@
<methodparam choice="opt"><type>int</type><parameter>expire</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Метод <function>Memcache::replace</function> заменяет значение
элемента кеша с ключом <parameter>key</parameter>. Метод <function>Memcache::replace</function> возвращает
значение &false;, если сервер не содержит элемент с таким ключом, иначе метод <function>Memcache::replace</function> работает аналогично
методу <function>Memcache::set</function>.
</para>
</simpara>
</refsect1>
@@ -41,37 +41,37 @@
<varlistentry>
<term><parameter>key</parameter></term>
<listitem>
<para>
<simpara>
Ключ, который свяжется с элементом.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>var</parameter></term>
<listitem>
<para>
<simpara>
Переменная, которую требуется сохранить. Строки и числа сохраняются как есть, остальные типы
сериализуются.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>flag</parameter></term>
<listitem>
<para>
<simpara>
При передаче флага <constant>MEMCACHE_COMPRESSED</constant> элемент
сохраняется в сжатом виде. Модуль сжимает элемент средствами библиотеки zlib.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>expire</parameter></term>
<listitem>
<para>
<simpara>
Время жизни элемента. При передаче значения 0 элемент никогда не устаревает. Параметр также принимает
метку времени Unix или число секунд, начиная с текущего момента, но тогда числу секунд
нельзя превышать значение 2592000, что эквивалентно 30 дням.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -79,9 +79,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

26
reference/memcache/memcache/set.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f77acbec03e0937e560e9f901a26bb5f6f6992fb Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: f4098e2bac4bcc136b95b85badcf4476fa683477 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="memcache.set">
<refnamediv>
@@ -37,10 +37,10 @@
флага <constant>MEMCACHE_COMPRESSED</constant>
элемент сжимается "на лету" средствами библиотеки zlib.
<note>
<para>
<simpara>
Обратите внимание: ресурсы наподобие дескрипторов файлов или подключений
нельзя сохранять в кеше, поскольку ресурсы невозможно адекватно представить в сериализованном виде.
</para>
</simpara>
</note>
</para>
@@ -52,37 +52,37 @@
<varlistentry>
<term><parameter>key</parameter></term>
<listitem>
<para>
<simpara>
Ключ, с которым свяжется элемент.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>var</parameter></term>
<listitem>
<para>
<simpara>
Переменная, которую требуется сохранить. Строковые и числовые значения сохраняются как есть,
а остальные типы сериализуются.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>flag</parameter></term>
<listitem>
<para>
<simpara>
При передаче флага <constant>MEMCACHE_COMPRESSED</constant> элемент
сохраняется в сжатом виде. Модуль сжимает элемент средствами библиотеки zlib.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>expire</parameter></term>
<listitem>
<para>
<simpara>
Время жизни элемента. При передаче значения 0 элемент никогда не устаревает. Параметр также принимает
метку времени Unix или число секунд, начиная с текущего момента, но тогда числу секунд
нельзя превышать значение 2592000, что эквивалентно 30 дням.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -90,9 +90,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

22
reference/memcache/memcache/setcompressthreshold.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f77acbec03e0937e560e9f901a26bb5f6f6992fb Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: f4098e2bac4bcc136b95b85badcf4476fa683477 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="memcache.setcompressthreshold">
<refnamediv>
@@ -22,15 +22,15 @@
<methodparam choice="opt"><type>float</type><parameter>min_savings</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Метод <function>Memcache::setCompressThreshold</function> включает автоматическое сжатие
больших значений.
</para>
</simpara>
<note>
<para>
<simpara>
Функцию добавили в модуль Memcache версии 2.0.0.
</para>
</simpara>
</note>
</refsect1>
@@ -41,20 +41,20 @@
<varlistentry>
<term><parameter>threshold</parameter></term>
<listitem>
<para>
<simpara>
Параметр определяет пороговый размер значения, при котором данные автоматически сжимаются.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>min_saving</parameter></term>
<listitem>
<para>
<simpara>
Параметр определяет пороговый коэффициент экономии места, при котором значение сохраняется в сжатом виде;
метод отправит несжатые данные, если доля сэкономленного после сжатия места не достигнет заданной величины.
Параметр принимает значения в диапазоне от 0 до 1. Значение по умолчанию равно 0.2,
что соответствует 20 % экономии.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -62,9 +62,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

38
reference/memcache/memcache/setserverparams.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f77acbec03e0937e560e9f901a26bb5f6f6992fb Maintainer: lex Status: ready -->
<!-- EN-Revision: f4098e2bac4bcc136b95b85badcf4476fa683477 Maintainer: lex Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="memcache.setserverparams">
<refnamediv>
@@ -30,14 +30,14 @@
<methodparam choice="opt"><type>callable</type><parameter>failure_callback</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Метод <function>Memcache::setServerParams</function> изменяет параметры сервера на лету.
</para>
</simpara>
<note>
<para>
<simpara>
Функцию добавили в модуль Memcache версии 2.1.0.
</para>
</simpara>
</note>
</refsect1>
@@ -48,33 +48,33 @@
<varlistentry>
<term><parameter>host</parameter></term>
<listitem>
<para>
<simpara>
В параметре указывается хост, на котором сервер memcached прослушивает соединения.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>port</parameter></term>
<listitem>
<para>
<simpara>
В параметре указывается порт, на котором сервер memcached прослушивает соединения.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem>
<para>
<simpara>
Время ожидания в секундах для подключения к демону.
Изменение значения по умолчанию в 1 секунду
часто нивелирует преимущества кеширования на медленных соединениях.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>retry_interval</parameter></term>
<listitem>
<para>
<simpara>
Параметр управляет частотой проверки доступности отказавшего сервера. Значение по умолчанию
равно 15 секундам.
Значение "-1" отключает автоматические повторные
@@ -83,13 +83,13 @@
не влияют на работу метода,
если модуль загружается динамически функцией
<function>dl</function>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>status</parameter></term>
<listitem>
<para>
<simpara>
Параметр определяет, помечать ли сервер флагом "онлайн". Одновременная установка
значения &false; для этого параметра и значения -1 для параметра <parameter>retry_interval</parameter>
оставит отказавший сервер в пуле, чтобы не влиять на алгоритм распределения
@@ -99,18 +99,18 @@
сразу же прервётся с ошибкой, в зависимости от настройки
директивы <parameter>memcache.allow_failover</parameter>. Значение по умолчанию равно &true; —
сервер активен и готов принимать запросы.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>failure_callback</parameter></term>
<listitem>
<para>
<simpara>
Пользовательская callback-функция, которая запустится
при ошибке. Эта функция вызывается
до запуска механизма отказоустойчивости. Функция принимает два
параметра — имя хоста и порт отказавшего сервера.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -118,9 +118,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

13
reference/memcache/setup.xml
View File

@@ -1,18 +1,17 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 95bdd6883b5dde9504701777ba81b3c5f15df52b Maintainer: mch Status: ready -->
<!-- EN-Revision: f4098e2bac4bcc136b95b85badcf4476fa683477 Maintainer: mch Status: ready -->
<!-- Reviewed: no -->
<chapter xml:id="memcache.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="memcache.setup">
&reftitle.setup;
<!-- {{{ Requirements -->
<section xml:id="memcache.requirements">
&reftitle.required;
<para>
<simpara>
Этот модуль использует функции <link xlink:href="&url.zlib;">zlib</link>
для поддержки сжатия "на лету". В связи с этим Zlib необходим для установки
данного модуля.
</para>
</simpara>
</section>
<!-- }}} -->
@@ -27,10 +26,10 @@
<!-- {{{ Resources -->
<section xml:id="memcache.resources">
&reftitle.resources;
<para>
<simpara>
Существует всего один тип ресурсов, используемых в модуле memcache -
это идентификатор ссылки для подключения к кеш-серверу.
</para>
</simpara>
</section>
<!-- }}} -->