repo_zf1/documentation/manual/ja/module_specs/Zend_Cache-Backends.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- Reviewed: no -->
<!-- EN-Revision: 24677 -->
<sect1 id="zend.cache.backends">
    <title><classname>Zend_Cache</classname> のバックエンド</title>
    <para>
        バックエンドには、標準と拡張の 2 種類があります。
        もちろん、拡張バックエンドのほうがより高機能となります。
    </para>
    <sect2 id="zend.cache.backends.file">
        <title>Zend_Cache_Backend_File</title>
        <para>
            この (拡張) バックエンドは、キャッシュレコードを
            (指定したディレクトリの) ファイルに保存します。
        </para>
        <para>
            使用可能なオプションは次のとおりです。
        </para>
        <table id="zend.cache.backends.file.table">
            <title>File バックエンドのオプション</title>
            <tgroup cols="4">
                 <thead>
                      <row>
                        <entry>オプション</entry>
                        <entry>データ型</entry>
                        <entry>デフォルト値</entry>
                        <entry>説明</entry>
                    </row>
                 </thead>
                 <tbody>
                      <row>
                          <entry><emphasis>cache_dir</emphasis></entry>
                          <entry><type>String</type></entry>
                          <entry>[system temp dir]</entry>
                          <entry>
                              キャッシュファイルを書き込むディレクトリ。
                          </entry>
                      </row>
                      <row>
                          <entry><emphasis>file_locking</emphasis></entry>
                          <entry><type>Boolean</type></entry>
                          <entry><constant>TRUE</constant></entry>
                          <entry>
                            ファイルロックを有効/無効にします。
                            不慮の事故でキャッシュが破壊されることを防げますが、
                            マルチスレッドなウェブサーバ環境や <acronym>NFS</acronym> ファイルシステム上では役に立ちません。
                          </entry>
                      </row>
                      <row>
                          <entry><emphasis>read_control</emphasis></entry>
                          <entry><type>Boolean</type></entry>
                          <entry><constant>TRUE</constant></entry>
                          <entry>
                            読み込み制御を有効/無効にします。有効にすると
                            キャッシュファイルに制御キーが埋め込まれます。
                            キャッシュの読み込み後、計算した結果とキャッシュのキーを比較します。
                          </entry>
                      </row>
                      <row>
                          <entry><emphasis>read_control_type</emphasis></entry>
                          <entry><type>String</type></entry>
                          <entry>'crc32'</entry>
                          <entry>
                            読み込み制御の方式 (読み込み制御が有効な場合にのみ使用します)。
                            使用可能な値は
                            'md5' (一番安全だが、最も遅い)、
                            'crc32' (安全性には劣るが、より高速。悪くない選択肢です)、
                            'adler32' (新たな選択肢。crc32 より高速です)、
                            'strlen' (最も高速。長さのみをチェックします)
                            のいずれかです。
                        </entry>
                      </row>
                      <row>
                          <entry><emphasis>hashed_directory_level</emphasis></entry>
                          <entry><type>Integer</type></entry>
                          <entry>0</entry>
                          <entry>
                            ディレクトリ構造のレベルを指定します。0 は "ディレクトリ階層を作らない"、
                            1 は "一段階のサブディレクトリを作る"、2 は "二段階の……" を意味します。
                            何千ものキャッシュファイルを使用する場合にのみ、
                            このオプションによる高速化を実感できるでしょう。
                            適切な設定値を決めるには、実際にベンチマークを取得するしかありません。
                            たいていの場合は 1 または 2 でよいでしょう。
                          </entry>
                      </row>
                      <row>
                          <entry><emphasis>hashed_directory_perm</emphasis></entry>
                          <entry><type>Integer</type></entry>
                          <entry>0700</entry>
                          <entry>
                              ディレクトリ構造に対する権限を指定します。
                        </entry>
                      </row>
                      <row>
                          <entry><emphasis>file_name_prefix</emphasis></entry>
                          <entry><type>String</type></entry>
                          <entry>'zend_cache'</entry>
                          <entry>
                              キャッシュファイルのプレフィックスを設定します。
                              このオプションを設定する際には十分注意しましょう。
                              あまりにもありふれた値をシステムのキャッシュディレクトリ
                              (<filename>/tmp</filename> など) で使用すると、
                              キャッシュの削除の際に余計なものまで削除されてしまうはめになります。
                        </entry>
                      </row>
                      <row>
                          <entry><emphasis>cache_file_umask</emphasis></entry>
                          <entry><type>Integer</type></entry>
                          <entry>0600</entry>
                          <entry>
                              キャッシュファイルの umask を設定します。
                          </entry>
                      </row>

                      <row>
                          <entry><emphasis>cache_file_perm</emphasis></entry>
                          <entry><type>Integer</type></entry>
                          <entry>0600</entry>
                          <entry>キャッシュファイルに対する権限を指定します。</entry>
                      </row>

                       <row>
                          <entry><emphasis>metatadatas_array_max_size</emphasis></entry>
                          <entry><type>Integer</type></entry>
                          <entry>100</entry>
                          <entry>
                              メタデータ配列の内部最大サイズを設定します
                              (よくわからない場合はこの値を変更してはいけません)。
                          </entry>
                      </row>
                  </tbody>
              </tgroup>
          </table>
    </sect2>
    <sect2 id="zend.cache.backends.sqlite">
        <title>Zend_Cache_Backend_Sqlite</title>
        <para>
            この (拡張) バックエンドは、キャッシュレコードを
            SQLite データベースに保存します。
        </para>
        <para>
            使用可能なオプションは次のとおりです。
        </para>
        <table id="zend.cache.backends.sqlite.table">
            <title>Sqlite バックエンドのオプション</title>
            <tgroup cols="4">
                 <thead>
                      <row>
                        <entry>オプション</entry>
                        <entry>データ型</entry>
                        <entry>デフォルト値</entry>
                        <entry>説明</entry>
                    </row>
                 </thead>
                 <tbody>
                      <row>
                          <entry><emphasis>cache_db_complete_path (必須)</emphasis></entry>
                          <entry><type>String</type></entry>
                          <entry><constant>NULL</constant></entry>
                          <entry>
                              SQLite データベースへの (ファイル名も含めた) フルパス。
                          </entry>
                      </row>
                      <row>
                          <entry><emphasis>automatic_vacuum_factor</emphasis></entry>
                          <entry><type>Integer</type></entry>
                          <entry>10</entry>
                          <entry>
                              自動バキューム処理の設定を行います。
                              自動バキューム処理とは、<methodname>clean()</methodname> や <methodname>delete()</methodname>
                              がコールされた際に自動的にデータベースの断片化解消を行う
                              (そしてサイズを縮小する) ことです。
                              0 を指定すると、自動バキュームを行いません。
                              1 を指定すると (<methodname>delete()</methodname> や <methodname>clean()</methodname>
                              がコールされると) そのたびにバキュームを行います。
                              x (1 より大きな整数) を指定すると、
                              <methodname>clean()</methodname> や <methodname>delete()</methodname> が x 回コールされるたびに
                              一回の頻度でランダムに自動バキュームを行います。
                          </entry>
                      </row>
                  </tbody>
              </tgroup>
          </table>
    </sect2>
    <sect2 id="zend.cache.backends.memcached">
        <title>Zend_Cache_Backend_Memcached</title>
        <para>
            この (拡張) バックエンドは、キャッシュレコードを memcached サーバに保存します。
            <ulink url="http://www.danga.com/memcached/">memcached</ulink> は、
            高性能な分散メモリオブジェクトキャッシュシステムです。このバックエンドを使用するには、
            memcached デーモンおよび
            <ulink url="http://pecl.php.net/package/memcache">memcache <acronym>PECL</acronym> 拡張モジュール</ulink>
            が必要です。
        </para>
        <para>
            注意: このバックエンドでは、今のところ "タグ" がサポートされていません。
            また、引数 "doNotTestCacheValidity=true" もサポートされていません。
        </para>
        <para>
            使用可能なオプションは次のとおりです。
        </para>
        <table id="zend.cache.backends.memcached.table">
            <title>Memcached バックエンドのオプション</title>
            <tgroup cols="4">
                 <thead>
                      <row>
                        <entry>オプション</entry>
                        <entry>データ型</entry>
                        <entry>デフォルト値</entry>
                        <entry>説明</entry>
                    </row>
                 </thead>
                 <tbody>
                      <row>
                          <entry><emphasis>servers</emphasis></entry>
                          <entry><type>Array</type></entry>
                          <entry>
                              <command>array(array('host' => 'localhost', 'port' => 11211,
                                  'persistent' => true, 'weight' => 1, 'timeout' => 5,
                                  'retry_interval' => 15, 'status' => true,
                                  'failure_callback' => '' ))</command>
                          </entry>
                          <entry>
                              memcached サーバの配列です。各 memcached サーバの情報は、
                              以下のような連想配列で指定します。
                              'host' => (string) : memcached サーバのサーバ名
                              'port' => (int) : memcached サーバのポート番号
                              'persistent' => (bool) : この memcached サーバに対して持続的な接続を使用するかどうか
                              'weight' => (int) : memcached サーバの重み付け
                              'timeout' => (int) : memcached サーバのタイムアウト
                              'retry_interval' => (int) : memcached サーバの再試行間隔
                              'status' => (bool) : memcached サーバのステータス
                              'failure_callback' => (callback) : memcached サーバのコールバック関数
                          </entry>
                      </row>
                      <row>
                          <entry><emphasis>compression</emphasis></entry>
                          <entry><type>Boolean</type></entry>
                          <entry><constant>FALSE</constant></entry>
                          <entry>
                             その場での圧縮処理を行いたい場合に <constant>TRUE</constant> を指定します。
                          </entry>
                      </row>
                      <row>
                          <entry><emphasis>compatibility</emphasis></entry>
                          <entry><type>Boolean</type></entry>
                          <entry><constant>FALSE</constant></entry>
                          <entry>
                             古い memcache サーバ/拡張モジュールとの互換性モードを使用したい場合に
                             <constant>TRUE</constant> を指定します。
                          </entry>
                      </row>
                  </tbody>
              </tgroup>
          </table>
    </sect2>

    <!-- TODO : to be translated -->
    <sect2 id="zend.cache.backends.libmemcached">
        <title>Zend_Cache_Backend_Libmemcached</title>

        <para>
            This (extended) backend stores cache records into a memcached server. <ulink
                url="http://www.danga.com/memcached/">memcached</ulink> is a high-performance,
            distributed memory object caching system. To use this backend, you need a memcached
            daemon and <ulink url="http://pecl.php.net/package/memcached">the memcached
                <acronym>PECL</acronym> extension</ulink>.
        </para>

        <para>
            Be careful : with this backend, "tags" are not supported for the moment as
            the "doNotTestCacheValidity=true" argument.
        </para>

        <para>
            Available options are :
        </para>

        <table id="zend.cache.backends.libmemcached.table">
            <title>Libmemcached Backend Options</title>

            <tgroup cols="4">
                <thead>
                    <row>
                        <entry>Option</entry>
                        <entry>Data Type</entry>
                        <entry>Default Value</entry>
                        <entry>Description</entry>
                    </row>
                </thead>

                <tbody>
                    <row>
                        <entry><emphasis>servers</emphasis></entry>
                        <entry><type>Array</type></entry>

                        <entry>
                            <command>array(array('host' => 'localhost', 'port' => 11211,
                            'weight' => 1))</command>
                        </entry>

                        <entry>
                            An array of memcached servers ; each memcached server is described by
                            an associative array:
                            'host' => (string) : the name of the memcached server,
                            'port' => (int) : the port of the memcached server,
                            'weight' => (int) :the weight of the memcached server
                        </entry>
                    </row>
                    <row>
                        <entry><emphasis>client</emphasis></entry>
                        <entry><type>Array</type></entry>

                        <entry>
                            <command>array(
                                Memcached::OPT_DISTRIBUTION => Memcached::DISTRIBUTION_CONSISTENT,
                                Memcached::OPT_HASH => Memcached::HASH_MD5,
                                Memcached::OPT_LIBKETAMA_COMPATIBLE => true
                            )</command>
                        </entry>

                        <entry>
                            An associative array of memcached client options ;
                            The array key can be the name of the memcached option constant
                            (without 'OPT_') or the integer value of it.
                            See <ulink url="http://php.net/manual/memcached.constants.php">
                                Memcached constants on <acronym>PHP</acronym> manual</ulink>
                        </entry>
                    </row>
                </tbody>
            </tgroup>
        </table>
    </sect2>

    <sect2 id="zend.cache.backends.apc">
        <title>Zend_Cache_Backend_Apc</title>
        <para>
            この (拡張) バックエンドは、キャッシュレコードを共有メモリに保存する際に
            <ulink url="http://pecl.php.net/package/APC">APC</ulink> (Alternative <acronym>PHP</acronym> Cache)
            拡張モジュールを使用します
            (当然、このバックエンドを使用するにはこの拡張モジュールが必要です)。
        </para>
        <para>
            注意: このバックエンドでは、今のところ "タグ" がサポートされていません。
            また、引数 "doNotTestCacheValidity=true" もサポートされていません。
        </para>
        <para>
            このバックエンドではオプションを使用しません。
        </para>
    </sect2>
    <sect2 id="zend.cache.backends.xcache">
        <title>Zend_Cache_Backend_Xcache</title>
        <para>
            このバックエンドは、キャッシュレコードを共有メモリに保存する際に
            <ulink url="http://xcache.lighttpd.net/">XCache</ulink>
            拡張モジュールを使用します
            (当然、このバックエンドを使うにはこの拡張モジュールが必要となります)。
        </para>
        <para>
            注意: このバックエンドでは、今のところ "タグ" がサポートされていません。
            また、引数 "doNotTestCacheValidity=true" もサポートされていません。
        </para>
        <para>
            使用可能なオプションは次のとおりです。
        </para>
        <table id="zend.cache.backends.xcache.table">
            <title>Xcache バックエンドのオプション</title>
            <tgroup cols="4">
                 <thead>
                      <row>
                        <entry>オプション</entry>
                        <entry>データ型</entry>
                        <entry>デフォルト値</entry>
                        <entry>説明</entry>
                    </row>
                 </thead>
                 <tbody>
                      <row>
                          <entry><emphasis>user</emphasis></entry>
                          <entry><type>String</type></entry>
                          <entry><constant>NULL</constant></entry>
                          <entry>
                              <filename>xcache.admin.user</filename> です。
                              <methodname>clean()</methodname> メソッドを使う際に必要です。
                          </entry>
                      </row>
                      <row>
                          <entry><emphasis>password</emphasis></entry>
                          <entry><type>String</type></entry>
                          <entry><constant>NULL</constant></entry>
                          <entry>
                              <filename>xcache.admin.pass</filename> (<acronym>MD5</acronym> ではない平文形式) です。
                              <methodname>clean()</methodname> メソッドを使う際に必要です。
                          </entry>
                      </row>
                  </tbody>
              </tgroup>
          </table>
    </sect2>
    <sect2 id="zend.cache.backends.platform">
        <title>Zend_Cache_Backend_ZendPlatform</title>
        <para>
            このバックエンドは、<ulink url="http://www.zend.co.jp/product/zendplatform.html">Zend Platform</ulink>
            製品のコンテンツキャッシング <acronym>API</acronym> を使用します。当然、このバックエンドを使用するには
            Zend Platform をインストールする必要があります。
        </para>
        <para>
            このバックエンドはタグをサポートしています。しかし、
            クリーニングモード <constant>CLEANING_MODE_NOT_MATCHING_TAG</constant> はサポートしていません。
        </para>
        <para>
            <methodname>Zend_Cache::factory()</methodname> メソッドでこのバックエンドを指定する場合は、
            'Zend' と 'Platform' の間に区切り文字を入れます。区切り文字としては
            '-'、'.'、' ' あるいは '_' が使用できます。
        </para>
        <programlisting language="php"><![CDATA[
$cache = Zend_Cache::factory('Core', 'Zend Platform');
]]></programlisting>
        <para>
            このバックエンドではオプションを使用しません。
        </para>
    </sect2>
    <sect2 id="zend.cache.backends.twolevels">
        <title>Zend_Cache_Backend_TwoLevels</title>
        <para>
            この (拡張) バックエンドは複合型です。
            キャッシュレコードを、
            高速 (だが制限付き) な Apc、Memcache…… および "低速"
            な File、Sqlite…… の 2 種類の別々のバックエンドに格納します。
        </para>
        <para>
            このバックエンドは priority パラメータを使用 (フロントエンドレベルで、記録開始時に指定)
            し、高速バックエンドの残りのスペースを用いてふたつのバックエンドの使用を最適化します。
        </para>
        <para>
            <methodname>Zend_Cache::factory()</methodname> メソッドでこのバックエンドを指定する場合は、
            'Two' と 'Levels' の間に区切り文字を入れます。区切り文字としては
            '-'、'.'、' ' あるいは '_' が使用できます。
        </para>
        <programlisting language="php"><![CDATA[
$cache = Zend_Cache::factory('Core', 'Two Levels');
]]></programlisting>
        <para>
            使用可能なオプションは次のとおりです。
        </para>
        <table id="zend.cache.backends.twolevels.table">
            <title>TwoLevels バックエンドのオプション</title>
            <tgroup cols="4">
                 <thead>
                      <row>
                        <entry>オプション</entry>
                        <entry>データ型</entry>
                        <entry>デフォルト値</entry>
                        <entry>説明</entry>
                    </row>
                 </thead>
                 <tbody>
                      <row>
                          <entry><emphasis>slow_backend</emphasis></entry>
                          <entry><type>String</type></entry>
                          <entry>File</entry>
                          <entry>
                              "低速" バックエンドの名前。
                          </entry>
                      </row>
                      <row>
                          <entry><emphasis>fast_backend</emphasis></entry>
                          <entry><type>String</type></entry>
                          <entry>Apc</entry>
                          <entry>
                              "高速" バックエンドの名前。
                          </entry>
                      </row>
                      <row>
                          <entry><emphasis>slow_backend_options</emphasis></entry>
                          <entry><type>Array</type></entry>
                          <entry><methodname>array()</methodname></entry>
                          <entry>
                              "低速" バックエンドのオプション。
                          </entry>
                      </row>
                      <row>
                          <entry><emphasis>fast_backend_options</emphasis></entry>
                          <entry><type>Array</type></entry>
                          <entry><methodname>array()</methodname></entry>
                          <entry>
                              "高速" バックエンドのオプション。
                          </entry>
                      </row>
                      <row>
                          <entry><emphasis>slow_backend_custom_naming</emphasis></entry>
                          <entry><type>Boolean</type></entry>
                          <entry><constant>FALSE</constant></entry>
                          <entry>
                              <constant>TRUE</constant> の場合は、引数 slow_backend を完全なクラス名として使用します。
                              <constant>FALSE</constant> の場合は、引数をクラス名 "<classname>Zend_Cache_Backend_</classname>[...]"
                              の最後の部分として使用します。
                          </entry>
                      </row>
                      <row>
                          <entry><emphasis>fast_backend_custom_naming</emphasis></entry>
                          <entry><type>Boolean</type></entry>
                          <entry><constant>FALSE</constant></entry>
                          <entry>
                              <constant>TRUE</constant> の場合は、引数 fast_backend を完全なクラス名として使用します。
                              <constant>FALSE</constant> の場合は、引数をクラス名 "<classname>Zend_Cache_Backend_</classname>[...]"
                              の最後の部分として使用します。
                          </entry>
                      </row>
                      <row>
                          <entry><emphasis>slow_backend_autoload</emphasis></entry>
                          <entry><type>Boolean</type></entry>
                          <entry><constant>FALSE</constant></entry>
                          <entry>
                              <constant>TRUE</constant> の場合は、低速バックエンドに対して require_once を行いません
                              (独自のバックエンドを使用する場合にのみ有用です)。
                          </entry>
                      </row>
                      <row>
                          <entry><emphasis>fast_backend_autoload</emphasis></entry>
                          <entry><type>Boolean</type></entry>
                          <entry><constant>FALSE</constant></entry>
                          <entry>
                              <constant>TRUE</constant> の場合は、高速バックエンドに対して require_once を行いません
                              (独自のバックエンドを使用する場合にのみ有用です)。
                          </entry>
                      </row>
                      <row>
                          <entry><emphasis>auto_refresh_fast_cache</emphasis></entry>
                          <entry><type>Boolean</type></entry>
                          <entry><constant>TRUE</constant></entry>
                          <entry>
                              <constant>TRUE</constant> の場合は、キャッシュレコードにヒットしたときに
                              高速キャッシュを自動的にリフレッシュします。
                          </entry>
                      </row>
                      <row>
                          <entry><emphasis>stats_update_factor</emphasis></entry>
                          <entry><type>Integer</type></entry>
                          <entry>10</entry>
                          <entry>
                              高速バックエンドを使用率の計算を無効化 / 効率化します
                              (レコードをキャッシュに書き込む際の
                              高速バックエンド使用率の計算は、
                              キャッシュ書き込み x 回につき 1 回の割合でランダムに行われます)。
                          </entry>
                      </row>
                  </tbody>
              </tgroup>
          </table>
    </sect2>
    <sect2 id="zend.cache.backends.zendserver">
        <title>Zend_Cache_Backend_ZendServer_Disk および Zend_Cache_Backend_ZendServer_ShMem</title>
        <para>
            これらのバックエンドは、キャッシュレコードの保存に
            <ulink url="http://www.zend.co.jp/product/zendserver.html">Zend Server</ulink>
            のキャッシュ機能を使用します。
        </para>
        <para>
             注意: このバックエンドでは、今のところ "タグ" がサポートされていません。
             また、引数 "doNotTestCacheValidity=true" もサポートされていません。
        </para>
        <para>
             これらのバックエンドが動作するのは、Zend Server 環境で
             <acronym>HTTP</acronym> あるいは <acronym>HTTPS</acronym>
             越しにページをリクエストした場合のみです。
             コマンドラインでスクリプトを実行した場合は動作しません。
        </para>
        <para>
            <methodname>Zend_Cache::factory()</methodname> メソッドでこのバックエンドを指定する場合は、
            パラメータ <emphasis>customBackendNaming</emphasis> を <constant>TRUE</constant> とします。
        </para>
        <programlisting language="php"><![CDATA[
$cache = Zend_Cache::factory('Core', 'Zend_Cache_Backend_ZendServer_Disk',
                             $frontendOptions, $backendOptions, false, true);
]]></programlisting>
        <para>
            このバックエンドにはオプションはありません。
        </para>
    </sect2>

    <!-- TODO : to be translated -->
    <sect2 id="zend.cache.backends.static">
        <title>Zend_Cache_Backend_Static</title>
        <para>
            This backend works in concert with <classname>
            Zend_Cache_Frontend_Capture</classname> (the two must be used
            together) to save the output from requests as static files. This
            means the static files are served directly on subsequent requests
            without any involvement of PHP or the Zend Framework at all.
        </para>

        <note>
            <para>
                <classname>Zend_Cache_Frontend_Capture</classname> operates
                by registering a callback function to be called
                when the output buffering it uses is cleaned. In order for this to operate
                correctly, it must be the final output buffer in the request. To guarantee
                this, the output buffering used by the Dispatcher <emphasis>must</emphasis> be
                disabled by calling <classname>Zend_Controller_Front</classname>'s
                <methodname>setParam()</methodname> method, for example,
                <command>$front->setParam('disableOutputBuffering', true);</command> or adding
                "resources.frontcontroller.params.disableOutputBuffering = true"
                to your bootstrap configuration file (assumed <acronym>INI</acronym>) if using
                <classname>Zend_Application</classname>.
            </para>
        </note>

        <para>
            The benefits of this cache include a large throughput increase since
            all subsequent requests return the static file and don't need any
            dynamic processing. Of course this also has some disadvantages. The
            only way to retry the dynamic request is to purge the cached file
            from elsewhere in the application (or via a cronjob if timed). It
            is also restricted to single-server applications where only one
            filesystem is used. Nevertheless, it can be a powerful means of
            getting more performance without incurring the cost of a proxy on
            single machines.
        </para>
        <para>
            Before describing its options, you should note this needs some
            changes to the default .htaccess file in order for requests to be
            directed to the static files if they exist. Here's an example of
            a simple application caching some content, including two specific
            feeds which need additional treatment to serve a correct
            Content-Type header:
        </para>
        <programlisting language="text"><![CDATA[
AddType application/rss+xml .xml
AddType application/atom+xml .xml

RewriteEngine On

RewriteCond %{REQUEST_URI} feed/rss$
RewriteCond %{DOCUMENT_ROOT}/cached/%{REQUEST_URI}.xml -f
RewriteRule .* cached/%{REQUEST_URI}.xml [L,T=application/rss+xml]

RewriteCond %{REQUEST_URI} feed/atom$
RewriteCond %{DOCUMENT_ROOT}/cached/%{REQUEST_URI}.xml -f
RewriteRule .* cached/%{REQUEST_URI}.xml [L,T=application/atom+xml]

RewriteCond %{DOCUMENT_ROOT}/cached/index.html -f
RewriteRule ^/*$ cached/index.html [L]
RewriteCond %{DOCUMENT_ROOT}/cached/%{REQUEST_URI}.(html|xml|json|opml|svg) -f
RewriteRule .* cached/%{REQUEST_URI}.%1 [L]

RewriteCond %{REQUEST_FILENAME} -s [OR]
RewriteCond %{REQUEST_FILENAME} -l [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^.*$ - [NC,L]

RewriteRule ^.*$ index.php [NC,L]
]]></programlisting>
        <para>
            The above assumes static files are cached to the directory ./public/cached.
            We'll cover the option setting this location, "public_dir", below.
        </para>
        <para>
            Due to the nature of static file caching, the backend class offers two
            additional methods: <methodname>remove()</methodname> and <methodname>
            removeRecursively()</methodname>. Both accept a request URI, which when
            mapped to the "public_dir" where static files are cached, and has a
            pre-stored extension appended, provides the name of either a static
            file to delete, or a directory path to delete recursively. Due to the
            restraints of <classname>Zend_Cache_Backend_Interface</classname>, all
            other methods such as <classname>save()</classname> accept an ID which
            is calculated by applying bin2hex() to a request URI.
        </para>
        <para>
            Given the level at which static caching operates, static file caching
            is addressed for simpler use with the <classname>
            Zend_Controller_Action_Helper_Cache</classname> action helper. This helper
            assists in setting which actions of a controller to cache, with what tags,
            and with which extension. It also offers methods for purging the cache by
            request URI or tag. Static file caching is also assisted by <classname>
            Zend_Cache_Manager</classname> which includes pre-configured configuration
            templates for a static cache (as Zend_Cache_Manager::PAGECACHE or "page").
            The defaults therein can be configured as needed to set up a "public_dir"
            location for caching, etc.
        </para>
        <note>
            <para>
                It should be noted that the static cache actually uses a secondary
                cache to store tags (obviously we can't store them elsewhere since
                a static cache does not invoke PHP if working correctly). This is
                just a standard Core cache, and should use a persistent backend such
                as File or TwoLevels (to take advantage of memory storage without
                sacrificing permanent persistance). The backend includes the option
                "tag_cache" to set this up (it is obligatory), or the <methodname>
                setInnerCache()</methodname> method.
            </para>
        </note>
        <table id="zend.cache.backends.static.table">
            <title>Static Backend Options</title>
            <tgroup cols="4">
                 <thead>
                      <row>
                        <entry>Option</entry>
                        <entry>Data Type</entry>
                        <entry>Default Value</entry>
                        <entry>Description</entry>
                    </row>
                 </thead>
                 <tbody>
                      <row>
                          <entry><emphasis>public_dir</emphasis></entry>
                          <entry><type>String</type></entry>
                          <entry>NULL</entry>
                          <entry>
                              Directory where to store static files. This must exist
                              in your public directory.
                          </entry>
                      </row>
                      <row>
                          <entry><emphasis>file_locking</emphasis></entry>
                          <entry><type>Boolean</type></entry>
                          <entry><constant>TRUE</constant></entry>
                          <entry>
                            Enable or disable file_locking : Can avoid cache corruption under
                            bad circumstances but it doesn't help on multithread webservers
                            or on <acronym>NFS</acronym> filesystems...
                          </entry>
                      </row>
                      <row>
                          <entry><emphasis>read_control</emphasis></entry>
                          <entry><type>Boolean</type></entry>
                          <entry><constant>TRUE</constant></entry>
                          <entry>
                            Enable / disable read control : if enabled, a control key is
                            embedded in the cache file and this key is compared with the
                            one calculated after the reading.
                          </entry>
                      </row>
                      <row>
                          <entry><emphasis>read_control_type</emphasis></entry>
                          <entry><type>String</type></entry>
                          <entry>'crc32'</entry>
                          <entry>
                            Type of read control (only if read control is enabled). Available values
                            are : 'md5' (best but slowest), 'crc32' (lightly less safe but faster,
                            better choice), 'adler32' (new choice, faster than crc32),
                            'strlen' for a length only test (fastest).
                        </entry>
                      </row>
                      <row>
                          <entry><emphasis>cache_file_umask</emphasis></entry>
                          <entry><type>Integer</type></entry>
                          <entry>0600</entry>
                          <entry>
                              umask for cached files.
                          </entry>
                      </row>
                      <row>
                          <entry><emphasis>cache_directory_umask</emphasis></entry>
                          <entry><type>Integer</type></entry>
                          <entry>0700</entry>
                          <entry>
                              Umask for directories created within public_dir.
                        </entry>
                      </row>

                      <row>
                          <entry><emphasis>file_extension</emphasis></entry>
                          <entry><type>String</type></entry>
                          <entry>'.html'</entry>
                          <entry>
                              Default file extension for static files created. This
                              can be configured on the fly, see <methodname>
                              Zend_Cache_Backend_Static::save()</methodname> though
                              generally it's recommended to rely on <classname>
                              Zend_Controller_Action_Helper_Cache</classname> when
                              doing so since it's simpler that way than messing with
                              arrays/serialization manually.
                          </entry>
                      </row>
                      <row>
                          <entry><emphasis>index_filename</emphasis></entry>
                          <entry><type>String</type></entry>
                          <entry>'index'</entry>
                          <entry>
                              If a request URI does not contain sufficient information
                              to construct a static file (usually this means an index
                              call, e.g. URI of '/'), the index_filename is used instead.
                              So '' or '/' would map to 'index.html' (assuming the default
                              file_extension is '.html').
                          </entry>
                      </row>
                      <row>
                          <entry><emphasis>tag_cache</emphasis></entry>
                          <entry><type>Object</type></entry>
                          <entry>NULL</entry>
                          <entry>
                              Used to set an 'inner' cache utilised to store tags
                              and file extensions associated with static files. This
                              MUST be set or the static cache cannot be tracked and
                              managed.
                          </entry>
                      </row>
                      <row>
                          <entry><emphasis>disable_caching</emphasis></entry>
                          <entry><type>Boolean</type></entry>
                          <entry>FALSE</entry>
                          <entry>
                              If set to TRUE, static files will not be cached. This
                              will force all requests to be dynamic even if marked
                              to be cached in Controllers. Useful for debugging.
                          </entry>
                      </row>
                  </tbody>
              </tgroup>
          </table>
    </sect2>
</sect1>
<!--
vim:se ts=4 sw=4 et:
-->