addBlockfile()

addBlockfile() -- ファイルに含まれるブロックをテンプレートに追加する

概要

require_once 'HTML/Template/Sigma.php';

mixed HTML_Template_Sigma::addBlockfile (string $placeholder, string $block, string $filename)

説明

ファイルから取得したブロックをテンプレートに追加し、 変数プレースホルダをブロックプレースホルダに変更します。

パラメータ

string $placeholder

変数プレースホルダの名前。

string $block

追加するブロックの名前。

string $filename

ブロックを含むテンプレートファイル名。

返り値

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

参照

HTML_Template_Sigma::addBlock() も参照ください。

例外・エラー

表 47-1PEAR_Error の値

エラーコードエラーメッセージ原因対応
SIGMA_BLOCK_EXISTSBlock '$block' already existsテンプレート内にすでに存在する名前でブロックを追加しようとしました新しいブロックの名前に別のものを使用してください
SIGMA_PLACEHOLDER_NOT_FOUNDVariable placeholder '$placeholder' not foundテンプレート内に、新しいブロックをいれるプレースホルダがありませんプレースホルダ名を調べます
SIGMA_PLACEHOLDER_DUPLICATEPlaceholder '$placeholder' should be unique, found in multiple blocks新しいブロックをいれるプレースホルダは、一箇所だけでなければなりませんプレースホルダ名を調べ、異なるプレースホルダを使用します
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) テンプレート関数のパラメータが間違っています テンプレート関数の定義を修正します。 クォートのしかた に注意してください

注意

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