デフォルトのファイルベースのキャッシュメカニズムの代替として、
キャッシュファイルの読み書きや破棄を直接行うキャッシュハンドラ関数を指定できます。
これは、キャッシュファイルの
read、write および
clear で使われます。
まず、アプリケーション内にSmartyがキャッシュハンドラとして使用するための関数を定義します。
そしてその関数名を
$cache_handler_func
クラス変数に指定します。Smarty は、これを使用してキャッシュされたデータを処理します。
第１パラメータはキャッシュの動作を表す文字列で、これは
read、writeおよびclearのいずれかとなります。第２パラメータは Smarty オブジェクトです。
第３パラメータはキャッシュの内容です。
writeの場合はキャッシュされたコンテンツが渡され、readの場合は参照を受け取ってそこにキャッシュされたコンテンツを書き込み、clearの場合はこのパラメータの値を使用しないのでダミーの変数が渡されます。第４パラメータはテンプレートファイル名です('read'又は'write'の場合に必要)。
任意の第５パラメータは
$cache_idです。任意の第６パラメータは
$compile_idです。最後の第７パラメータ
$exp_timeは Smarty-2.6.0 で追加されました。
Example 15.16. キャッシュソースとしてMySQLを使用する例
<?php
/**************************************************
example usage:
include('Smarty.class.php');
include('mysql_cache_handler.php');
$smarty = new Smarty;
$smarty->cache_handler_func = 'mysql_cache_handler';
$smarty->display('index.tpl');
MySQLデータベースのスキーマ定義
create database SMARTY_CACHE;
create table CACHE_PAGES(
CacheID char(32) PRIMARY KEY,
CacheContents MEDIUMTEXT NOT NULL
);
**************************************************/
function mysql_cache_handler($action, $smarty_obj, &$cache_content, $tpl_file=null, $cache_id=null, $compile_id=null, $exp_time=null)
{
// ここでDBのホスト名・ユーザ名・パスワードを指定します
$db_host = 'localhost';
$db_user = 'myuser';
$db_pass = 'mypass';
$db_name = 'SMARTY_CACHE';
$use_gzip = false;
// ユニークなキャッシュIDを作成します
$CacheID = md5($tpl_file.$cache_id.$compile_id);
if(! $link = mysql_pconnect($db_host, $db_user, $db_pass)) {
trigger_error('cache_handler: could not connect to database');
return false;
}
mysql_select_db($db_name);
switch ($action) {
case 'read':
// キャッシュをデータベースから読み込みます
$results = mysql_query("select CacheContents from CACHE_PAGES where CacheID='$CacheID'");
if(!$results) {
trigger_error('cache_handler: query failed.');
}
$row = mysql_fetch_array($results,MYSQL_ASSOC);
if($use_gzip && function_exists('gzuncompress')) {
$cache_content = gzuncompress($row['CacheContents']);
} else {
$cache_content = $row['CacheContents'];
}
$return = $results;
break;
case 'write':
// キャッシュをデータベースに保存します
if($use_gzip && function_exists("gzcompress")) {
// 記憶効率のために内容を圧縮します
$contents = gzcompress($cache_content);
} else {
$contents = $cache_content;
}
$results = mysql_query("replace into CACHE_PAGES values(
'$CacheID',
'".addslashes($contents)."')
");
if(!$results) {
trigger_error('cache_handler: query failed.');
}
$return = $results;
break;
case 'clear':
// キャッシュ情報を破棄します
if(empty($cache_id) && empty($compile_id) && empty($tpl_file)) {
// 全てのキャッシュを破棄します
$results = mysql_query('delete from CACHE_PAGES');
} else {
$results = mysql_query("delete from CACHE_PAGES where CacheID='$CacheID'");
}
if(!$results) {
trigger_error('cache_handler: query failed.');
}
$return = $results;
break;
default:
// エラー・未知の動作
trigger_error("cache_handler: unknown action \"$action\"");
$return = false;
break;
}
mysql_close($link);
return $return;
}
?>