PEAR マニュアル
前のページ次のページ

loadTemplateFile()

loadTemplateFile() -- テンプレートファイルを読み込む

概要

require_once 'HTML/Template/Sigma.php';

mixed HTML_Template_Sigma::loadTemplateFile (string $filename [, boolean $removeUnknownVariables = TRUE [, boolean $removeEmptyBlocks = TRUE]])

説明

テンプレートファイルを読み込みます。キャッシングを有効にしている場合は、 まず "準備された" テンプレートが存在するかどうかを調べます。 存在する場合は、もとのテンプレートの代わりにそれを読み込みます。 存在しない場合は、もとのテンプレートを読み込んで準備し、 その準備したバージョンを保存します。 addBlockfile() および replaceBlockfile() は、まったく同じロジックを実装しています。

パラメータ

string $filename

ファイル名。

boolean $removeUnknownVariables

未知の/使用していない変数を削除するかどうか?

boolean $removeEmptyBlocks

空のブロックを削除するかどうか?

返り値

成功した場合に SIGMA_OK、 失敗した場合にエラーオブジェクトを返します。

例外・エラー

表 47-1PEAR_Error の値

エラーコードエラーメッセージ原因対応
SIGMA_TPL_NOT_FOUNDCannot read the template file '$filename'何らかの理由でファイルが読み込めませんファイルが存在するかどうか、そして適切な権限が設定されているかどうかを調べます
SIGMA_CACHE_ERRORCannot save template file 'filename'準備したテンプレートファイルが保存できませんキャッシュ用のディレクトリが存在するかどうか、そしてスクリプトから書き込み可能かどうかを調べます
SIGMA_BLOCK_DUPLICATEThe name of a block must be unique within a template. Block 'blockname' found twice.読み込んだファイルにふたつのブロックが含まれており、それらの名前が重複していますファイルを調べ、いずれかのブロック名を別のものに変更します
SIGMA_CALLBACK_SYNTAX_ERROR Cannot parse template function: (error description) テンプレート関数のパラメータが間違っています テンプレート関数の定義を修正します。 クォートのしかた に注意してください

参照

HTML_Template_Sigma::setTemplate()、 HTML_Template_Sigma::$removeUnknownVariables、 HTML_Template_Sigma::$removeEmptyBlocks も参照ください。

注意

この関数は、スタティックにコールする ことはできません。

前のページホーム次のページ
hideBlock()上に戻るparse()