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

loadTemplateFile()

loadTemplateFile() -- Loads a template file.

概要

require_once 'HTML/Template/Sigma.php';

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

説明

Loads a template file. If caching is on, then it checks whether a "prepared" template exists. If it does, it gets loaded instead of the original, if it does not, then the original gets loaded and prepared and then the prepared version is saved. addBlockfile() and replaceBlockfile() implement quite the same logic.

パラメータ

string $filename: filename
boolean $removeUnknownVariables: remove unknown/unused variables?
boolean $removeEmptyBlocks: remove empty blocks?

返り値

return SIGMA_OK on success, error object on failure

例外・エラー

表 40-1PEAR_Error の値

Error code	Error message	Reason	Solution
`SIGMA_TPL_NOT_FOUND`	Cannot read the template file '`$filename`'	File is unreadable for some reason	Check if the file exists and has correct permissions set
`SIGMA_CACHE_ERROR`	Cannot save template file 'filename'	A prepared template file cannot be saved	Check if the directory for prepared templates cache exists and is writeable for your script
`SIGMA_BLOCK_DUPLICATE`	The name of a block must be unique within a template. Block 'blockname' found twice.	The loaded file contains two blocks sharing the same name	Check the file and rename one of the the blocks to something else
`SIGMA_CALLBACK_SYNTAX_ERROR`	Cannot parse template function: (error description)	Bogus syntax for template function parameters.	Fix the template function definition, pay special attention to quoting rules.

参照

see HTML_Template_Sigma::setTemplate(), HTML_Template_Sigma::$removeUnknownVariables, HTML_Template_Sigma::$removeEmptyBlocks

注意

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

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