ZFResource^beta

使用可能な Zend_Cache フロントエンドのインスタンスを作成する方法を、 以下の例で示します。

<?php
# Zend_Cache ファクトリを読み込みます
require 'Zend/Cache.php';

# バックエンドを選びます (例えば 'File' や 'Sqlite'...)
$backendName = '[...]';

# フロントエンドを選びます (例えば 'Core'、'Output'、'Page'...)
$frontendName = '[...]';

# 選択したフロントエンド用のオプションを配列に設定します
$frontendOptions = array([...]);

# 選択したバックエンド用のオプションを配列に設定します
$backendOptions = array([...]);

# インスタンスを作成します
# (もちろん、最後の 2 つの引数は必須ではありません)
$cache = Zend_Cache::factory($frontendName, $backendName, $frontendOptions, $backendOptions);
        

これ以降のドキュメントでは、$cache の中身が有効なフロントエンドになっているものとします。また、 選択したバックエンドにパラメータを渡す方法は理解できているものとします。

	注意
	常に Zend_Cache::factory() を使用してフロントエンドの インスタンスを作成するようにしてください。フロントエンドやバックエンドを 自前で作成しようとしても、期待通りには動作しないでしょう。

タグは、キャッシュレコードを分類するための仕組みです。 save() メソッドでキャッシュを保存する際に、 適用するタグを配列で指定することができます。これを使用すると、 指定したタグが設定されているキャッシュレコードのみを削除するといったことが可能となります。

<?php
$cache->save($huge_data, 'myUniqueID', array('tagA', 'tagB', 'tagC'));
        

	注意
	save() メソッドには、オプションの第四引数 $specificLifetime を指定できることに注意しましょう (false 以外を指定することで、このキャッシュレコードの有効期限を特定の値に設定できます)。

特定のキャッシュ ID を削除/無効化するには、remove() メソッドを使用します。

<?php
$cache->remove('削除するID');
        

一回の操作で複数のキャッシュ ID を削除/無効化するには、clean() メソッドを使用します。例えば、すべてのキャッシュレコードを削除するには次のようにします。

<?php
// すべてのレコードを削除します
$cache->clean(Zend_Cache::CLEANING_MODE_ALL);

// 有効期限切れのレコードのみ削除します
$cache->clean(Zend_Cache::CLEANING_MODE_OLD);
        

タグ 'tagA' および 'tagC' に該当するキャッシュエントリを削除するには、このようにします。

<?php
$cache->clean(Zend_Cache::CLEANING_MODE_MATCHING_TAG, array('tagA', 'tagC'));
        

削除モードとして指定可能な値は CLEANING_MODE_ALL、CLEANING_MODE_OLD、 CLEANING_MODE_MATCHING_TAG および CLEANING_MODE_NOT_MATCHING_TAG です。後者は値は、その名が示すとおり、タグの配列と組み合わせて使用します。