com doc/ja: Fix #74284: Update runtime configuration page for memcached: reference/memcached/ini.xml

[email protected] (Yoshinari Takaoka) Sun, 10 Jan 2021 04:30:58 +0000
Newsgroups php.doc.ja
Message-ID <[email protected]>
Commit:    3a21f5eda36c0cd2e720d27730199343c33a72a2
Author:    Yoshinari Takaoka <[email protected]>         Sun, 10 Jan 2021 13:30:58 +0900
Parents:   309b7650b12463f83147c4a3a7db73964de40167
Branches:  master

Link:       http://git.php.net/?p=doc/ja.git;a=commitdiff;h=3a21f5eda36c0cd2e720d27730199343c33a72a2

Log:
Fix #74284: Update runtime configuration page for memcached

Co-authored-by: Christoph M. Becker <[email protected]>

Closes GH-53.

Bugs:
https://bugs.php.net/74284

Changed paths:
  M  reference/memcached/ini.xml
diff_3a21f5eda36c0cd2e720d27730199343c33a72a2.txt (text/plain, 26.8 KB)
diff --git a/reference/memcached/ini.xml b/reference/memcached/ini.xml
index ab036182b5..06c2e48e9e 100644
--- a/reference/memcached/ini.xml
+++ b/reference/memcached/ini.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: c2db1519bfc31c28a2ed60bb0ecb49e60d6871a1 Maintainer: mumumu Status: ready -->
 
 <section xml:id="memcached.configuration" xmlns="http://docbook.org/ns/docbook">
  &reftitle.runtime;
@@ -20,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 以降で利用可能です。memcached 3.0.0 以降は、デフォルト値はOnです。</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 3.0.0 以降は、memcached.sess_binary_protocol に置き換えられました。</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 3.0.0 以降は、memcached.sess_remove_failed_servers に置き換えられました。</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>Off</entry>
+      <entry>PHP_INI_ALL</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_SYSTEM</entry>
-      <entry><!-- leave empty, this will be filled by an automatic script --></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 以降で利用可能です。デフォルト値は memcached 3.1.0 以降は 150 です (それより前のバージョンでは 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 以降で利用可能です。デフォルト値は memcached 3.1.0 以降は 150 です (それより前のバージョンでは 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>
@@ -105,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>
@@ -121,14 +216,13 @@
     <varlistentry xml:id="ini.memcached.sess-consistent-hash">
      <term>
       <parameter>memcached.sess_consistent_hash</parameter>
-      <type>int</type>
+      <type>bool</type>
      </term>
      <listitem>
       <para>
-       セッション管理の コンシステント・ハッシュ モードです。
-       On にすると、セッション管理にコンシステント・ハッシュ法を使います。
+       On にすると、セッション管理に コンシステント・ハッシュ法 (libketama) を使います。
        コンシステント・ハッシュ法を使うと、既存のキーに煩わされることなく
-       ノードを追加したり削除したりできます。デフォルトは Off です。
+       ノードを追加したり削除したりできます。デフォルトは On です。
       </para>
      </listitem>
     </varlistentry>
@@ -136,7 +230,7 @@
     <varlistentry xml:id="ini.memcached.sess-binary">
      <term>
       <parameter>memcached.sess_binary</parameter>
-      <type>int</type>
+      <type>bool</type>
      </term>
      <listitem>
       <para>
@@ -146,7 +240,6 @@
       </para>
      </listitem>
     </varlistentry>
-
     <varlistentry xml:id="ini.memcached.sess-lock-wait">
      <term>
       <parameter>memcached.sess_lock_wait</parameter>
@@ -161,7 +254,6 @@
       </para>
      </listitem>
     </varlistentry>
-
     <varlistentry xml:id="ini.memcached.sess-prefix">
      <term>
       <parameter>memcached.sess_prefix</parameter>
@@ -174,7 +266,6 @@
       </para>
      </listitem>
     </varlistentry>
-
     <varlistentry xml:id="ini.memcached.sess-number-of-replicas">
      <term>
       <parameter>memcached.sess_number_of_replicas</parameter>
@@ -183,6 +274,13 @@
      <listitem>
       <para>
        セッションデータのレプリカの数です。
+       データを書き込む、 追加の memcached サーバの数を指定します。
+       これは、libmemcached が "poor man's HA" と呼んでいるものです。
+       この値が0より大きく、sess_remove_failed_servers が On の場合、
+       memcached サーバがダウンした時にセッションはレプリカを使って継続されます。
+       しかし、ダウンした memcached サーバが再び復帰した場合は、
+       セッションは古いデータを持つセッションを読みとる場合もありますし、
+       データを全く読み取れない場合もあります。デフォルト値は 0 です。
       </para>
      </listitem>
     </varlistentry>
@@ -190,7 +288,7 @@
     <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>
@@ -198,7 +296,6 @@
       </para>
      </listitem>
     </varlistentry>
-
     <varlistentry xml:id="ini.memcached.sess-remove-failed">
      <term>
       <parameter>memcached.sess_remove_failed</parameter>
@@ -210,7 +307,6 @@
       </para>
      </listitem>
     </varlistentry>
-
     <varlistentry xml:id="ini.memcached.compression-type">
      <term>
       <parameter>memcached.compression_type</parameter>
@@ -222,7 +318,6 @@
       </para>
      </listitem>
     </varlistentry>
-
     <varlistentry xml:id="ini.memcached.compression-factor">
      <term>
       <parameter>memcached.compression_factor</parameter>
@@ -236,7 +331,6 @@
       </para>
      </listitem>
     </varlistentry>
-
     <varlistentry xml:id="ini.memcached.compression-threshold">
      <term>
       <parameter>memcached.compression_threshold</parameter>
@@ -249,7 +343,6 @@
       </para>
      </listitem>
     </varlistentry>
-
     <varlistentry xml:id="ini.memcached.serializer">
      <term>
       <parameter>memcached.serializer</parameter>
@@ -257,7 +350,7 @@
      </term>
      <listitem>
       <para>
-       新しい memcached オブジェクトのデフォルトのシリアライザを設定します。設定値として php, igbinary, json, json_array が使えます。
+       新しい memcached オブジェクトのデフォルトのシリアライザを設定します。設定値として php, igbinary, json, json_array, msgpack が使えます。
       </para>
       <variablelist>
        <varlistentry>
@@ -265,6 +358,7 @@
         <listitem>
          <para>
           標準的な JSON を使います。このシリアライザは高速でコンパクトですが、UTF-8 でエンコードされたデータでしか動作しませんし、完全なシリアライズを実装していません。詳細は JSONエクステンション を参照して下さい。
+          memcached 0.2.0 以降で利用可能です。
          </para>
         </listitem>
        </varlistentry>
@@ -273,6 +367,7 @@
         <listitem>
          <para>
           json と同じですが、シリアライズしたデータを配列に入れます。
+          memcached 2.0.0 以降で利用可能です。
          </para>
         </listitem>
        </varlistentry>
@@ -289,13 +384,24 @@
         <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 が利用できない場合は msgpack が(利用可能な場合のみ) デフォルトになります。
+       いずれも利用できない場合は、php がデフォルトになります。
       </para>
      </listitem>
     </varlistentry>
@@ -303,7 +409,7 @@
     <varlistentry xml:id="ini.memcached.use-sasl">
      <term>
       <parameter>memcached.use_sasl</parameter>
-      <type>int</type>
+      <type>bool</type>
      </term>
      <listitem>
       <para>
@@ -311,7 +417,244 @@
       </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) を使います。
+       コンシステント・ハッシュ法を使うと、既存のキーに煩わされることなく
+       キャッシュノードを追加したり削除したりできます。デフォルトは Off です。
+      </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 text プロトコルではなく) memcached バイナリプロトコル を使うように指定します。
+       これは、libmemcached レプリカのバイナリモードが有効になっている場合にのみ有効です。
+       バイナリプロトコルが無効な場合にのみ動作するプロキシ(たとえば、twemproxy) もあります。
+       php-memcached の古いバージョンでは、この設定は memcached.sess_binary と呼ばれていました。
+       デフォルト値は libmemcached 1.0.18 以降は On です。
+       それより前のバージョンでは Off になっています。
+      </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' を指定すると、セッション管理にコンシステント・ハッシュ(libketama) を使います。
+       これは php-memcached 3.x のデフォルトです。
+       'ketama_weighted' を指定すると、重み付きのコンシステント・ハッシュ(libketama)
+       をセッション管理に使います。
+       これは php-memcached 2.x のデフォルトです。
+       デフォルトは "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_min 待ってリトライします。
+       その後リトライを行うたびに、memcached.sess_lock_wait_max に達するまで、
+       現在のリトライ時間を2倍して待ちます。
+       その後は、sess_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>
+       スクリプトの実行が終了した後、session.save_path に対応する
+       memcached 接続を再利用するかどうかを指定します。
+       特定の設定 (たとえば 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>
+       ダウンした memcahced サーバを自動的に削除する機能を有効にします。
+       デフォルト値は 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>
+       store コマンドが失敗した場合に、行うリトライの回数を指定します。
+       この仕組みを使うと、
+       複数サーバ構成で set/increment/decrement/setMulti 操作が失敗した場合に、
+       セカンダリサーバへ透過的なフェイルオーバーを行うことが出来ます。
+       デフォルト値は 2 です。
+      </para>
+     </listitem>
+    </varlistentry>
   </variablelist>
  </para>
 </section>