🏇🏽 👩🏽‍🍳 🛃 ネイティブテンプレートエンジン 👨‍👦 🏂🏽 🚻

私はかなり長い間、ネイティブテンプレートを使用していますが、何らかの理由で、多くの人々にとって、ネイティブテンプレートは次のような構造に関連付けられています。

$title = 'My title' ; include( 'templates/index.html' ); * This source code was highlighted with Source Code Highlighter .
$title = 'My title' ; include( 'templates/index.html' ); * This source code was highlighted with Source Code Highlighter .
$title = 'My title' ; include( 'templates/index.html' ); * This source code was highlighted with Source Code Highlighter .
$title = 'My title' ; include( 'templates/index.html' ); * This source code was highlighted with Source Code Highlighter .

< html > < head > < title > <？ php echo $ title ？ > </ title > </ head >
<！-...->
*このソースコードは、ソースコードハイライターで強調表示されました。

つまり、変数が定義され、htmlファイルに含まれていました。これは根本的に間違ったアプローチだと思います。なんで？

まず、テンプレートに渡されるすべての変数は、1つの場所（テンプレートクラスのプロパティ）に保存する必要があります。
第二に、テンプレートエンジンは、渡されない変数、およびテンプレートエンジンで定義されていない関数にアクセスするべきではありません。
第三に、仕事に必要な一連の機能を定義する必要があります。

したがって、テンプレートエンジンが必要であるという結論に達しましたが、それはだまされたSmartyタイプのブレーキであってはなりません。
ブロックテンプレートエンジン（XTemplateなど）のイデオロギーは、そのようなブランチがなく、サイクルのみであるため、私には魅力的ではありません。

したがって、私は私のものを書きました。

まず、エラー処理に対処する必要があります。この目的で例外を使用するため、例外クラスを定義します。

クラス STempExceptionは例外{}を拡張します
*このソースコードは、ソースコードハイライターで強調表示されました。

ここでは、他に何も必要ありません。テンプレートエンジン自体に目を向けます（メソッドが行うことはコメントに簡単に記述されています。以下で詳細に説明します）。

クラス STemp
{
/ **
*テンプレートが配置されているディレクトリの名前。
*
* @var文字列。
* @access private。
* /
プライベート $パス。
/ **
*テンプレートの名前。
*
* @var文字列。
* @access private。
* /
プライベート $テンプレート。
/ **
*割り当てられたテンプレート変数が保持される場所。
*
* @var配列。
* @access private。
* /
private $ variables = array（）;
/ **
*テンプレートエンジンのパラメーター。
*
* @var配列。
* @access private
* /
private $ params = array（
'xss_protection' => true 、
'exit_after_display' => true 、
'endofline_to_br' => false
）;
/ **
*テンプレートに含まれるファイル。
*
* @var文字列。
* @access private。
* /
private $ include_file;
/ **
*クラスコンストラクター。テンプレートが配置されているディレクトリの名前を設定します。
*
* @param string $テンプレートが配置されているディレクトリのパス名。デフォルトは「templates /」。
* @access public。
* /
パブリック関数__construct（$ path = 'templates /' ）
{
$ this-> path = $ path;
}
/ **
*テンプレートエンジンのパラメーターを設定します。
*
* @param string $パラメーターのパラメーター名。
* @param bool $パラメータの値。
* @return boolパラメータが設定されている場合はTRUE、設定されていない場合はFALSE。
* @access public。
* /
パブリック関数setParam（$ param、$ value ）
{
if （isset（$ this-> params [$ param]））{
$ this- > params [$ param] = $ value ;
trueを返します。
}
falseを返します。
}
/ **
*
* @param string $ include_fileインクルードファイルへのパス。
* @access public。
* /
パブリック関数setIncludeFile（$ include_file）
{
$ this-> include_file = $ this->パス。
if （！file_exists（$ this-> path。$ include_file））
throw new STempException（ 'Include file' 。$ this- > include_file。 'not exitst' ）;
}
/ **
*値をテンプレート変数に割り当てます。
*
* @param string $ nameテンプレート変数名。
* @param mixed $ value割り当てる値。
* @access public。
* /
パブリック関数assign（$ name、$ value ）
{
$ this-> variables [$ name] = $ value ;
}
/ **
*テンプレートの結果を実行して表示します。
*
* @param string $ templateテンプレート名。
* @access public。
* /
パブリック関数表示（$テンプレート）
{
$ this-> template = $ this-> path。$ template;
if （！file_exists（$ this-> template））
throw new STempException（ 'Template file' 。$ template。 'not exitst' ）;
require_once（$ this->テンプレート）;
if （$ this- > params [ 'exit_after_display' ]）
出る
}
/ **
*テンプレート変数の値を取得します。
*
* @param string $ nameテンプレート変数名。
* @returnは、この名前を持つテンプレート変数の混合値です。変数が設定されていない場合はFALSE。
* @access private。
* /
プライベート関数__get（$ name）
{
if （isset（$ this-> variables [$ name]））{
$ variable = $ this-> variables [$ name];
if （$ this- > params [ 'xss_protection' ]）
$変数= $ this-> xssProtection（$変数）;
if （$ this- > params [ 'endofline_to_br' ]）
$変数= $ this-> endoflineToBr（$変数）;
$変数を返します。
}
NULLを返します。
}
/ **
*ファイルを含める
*
* @access private
* /
プライベート関数includeFile（）
{
if （！file_exists（$ this-> include_file））
throw new STempException（ 'Include file' 。$ this-> include_file。 'not found' ）;
require_once（$ this-> include_file）;
}
/ **
*語尾の形成のため。
*
* @param int $値番号。
* @param string $ word0単数形の単語。
* @param string $ word1単語の複数形（2、3）。
* @param string $ word2複数形の単語。
* @param string $ separator separator、デフォルト ''。
* @return文字列形式の単語
* @access private。
* /
プライベート関数モーフ（$ 値、$ワード0、$ワード1、$ワード2、$区切り= '' ）
{
if （preg_match（ '/ 1 \ d $ /' 、$ value ））
return $ value 。$ separator。$ word2;
elseif（preg_match（ '/ 1 $ /' 、$ value ））
return $ value 。$ separator。$ word0;
elseif（preg_match（ '/（2 | 3 | 4）$ /' 、$ value ））
return $ value 。$ separator。$ word1;
他に
return $ value 。$ separator。$ word2;
}
/ **
* XSSからの保護用。
*
*保護のための@param mixed $変数データ。
* @return混合保護データ。
* @access private。
* /
プライベート関数xssProtection（$変数）
{
if （is_array（$ variable））{
$ protected = array（）;
foreach （$ key => $ value としての $変数）
$ protected [$ key] = $ this-> xssProtection（$ value ）;
$ protectedを返します。
}
return htmlspecialchars（$変数）;
}
/ **
*文字列のすべての改行の前にHTML改行を挿入します。
*
*保護のための@param mixed $変数データ。
*すべての改行の前に<br />を含む文字列が挿入された@return混合データ。
* @access private。
* /
プライベート関数endoflineToBr（$変数）
{
if （is_array（$ variable））{
$ protected = array（）;
foreach （$ key => $ value としての $変数）
$ protected [$ key] = $ this-> endoflineToBr（$ value ）;
$ protectedを返します。
}
return nl2br（$変数）;
}
}
*このソースコードは、ソースコードハイライターで強調表示されました。

コンストラクターで、テンプレートディレクトリへのパスを指定できます（デフォルトはtemlates /）。

setParamメソッドを使用して、テンプレートエンジンのパラメーターを設定できます。それらは3つだけです（これで十分です。必要に応じて、パラメーターを追加できます）。最初のパラメーター-xss_protection-は、名前が示すとおり、xssの脆弱性から保護するために必要です。パラメータ値がtrueに設定されている場合、テンプレートで使用するすべての変数は、返される前にhtmlspecialchars関数（配列要素を含む）によって自動的に処理されます。 2番目のパラメーター-exit_after_display-は、必要に応じて、テンプレートの表示後にスクリプトの実行を停止できるようにするために必要です。 3番目のパラメーターendofline_to_brは、nl2br関数で（配列要素を含む）を返す前にすべての変数を処理します。

setIncludeFileメソッドを使用して、プラグインテンプレートを設定できます。共通テンプレートindex.tpl.phpがよく使用され、条件によっては、変数部分がそれに接続されます。このプロセスの自動化には、このメソッドも必要です。インクルードファイルが存在しない場合、例外がスローされます。

assignメソッドは、変数をテンプレートに転送するために使用されます。

displayメソッドはテンプレートを表示します。テンプレートファイルが存在しない場合、例外がスローされます。 exit_after_displayがtrueに設定されている場合、このメソッドはスクリプトも終了します（ほとんどの場合、テンプレートの表示は最後のアクションです）。

__get magicメソッドは、テンプレートに渡された変数の値を返します。変数が定義されていない場合、NULLを返します。パラメーターに応じて、変数は返される前に処理されます。

includeFileメソッドには、setIncludeFileメソッドで指定されたファイルが含まれ、このファイルが見つからない場合は例外がスローされます。

完全に「テンプレート」ではないモーフ方法は、数字に関連する単語の正しい終わりを形成するのに役立ちます。つまり、1つのコメント、2つのコメント、5つのコメントです。数値自体、3つの異なるバリアント、およびオプションで単語区切り文字をメソッドに渡す必要があります（デフォルトでは、切り離せないスペース）。

xssProtectionメソッドは、htmlspecialchars関数を使用してデータを処理します。入力が配列の場合、入力は再帰的に反復され、そのすべての要素が処理されます。

endoflineToBrメソッドは、nl2br関数を使用してデータを処理します。入力が配列の場合、前の方法と同様に、入力が再帰的に繰り返され、そのすべての要素が処理されます。

実際にはどのように見えますか？記事とそのコメントを印刷する必要があるとします。 $ article配列の記事のデータ、$ commentsのコメント。

コントローラー：

$ stemp = new STemp（）;
$ stemp-> assign（ "title" 、$ article [ 'title' ]）;
$ stemp-> assign（ "article" 、$ article）;
$ stemp-> assign（ "comments" 、$コメント）;
{
$ stemp-> setIncludeFile（ " article.tpl.php " ）;
$ stemp-> display（ "index.tpl.php" ）;
} catch （STempException $ e）{
die（ 'STemp error：' 。$ e-> getMessage（））;
}
*このソースコードは、ソースコードハイライターで強調表示されました。

テンプレートindex.tpl.php：

< html >
< 頭 >
< タイトル > <？ php echo $ this- > title？ > </ タイトル >
</ 頭 >
< 本体 >
<？ php $ this- > includeFile（）？ >
</ body >
</ html >
*このソースコードは、ソースコードハイライターで強調表示されました。

テンプレートarticle.tpl.php：

< h1 > <？ php echo $ this- >記事['title']？ > </ h1 >
<？ php $ this- > setParam（ 'xss_protection'、false）; $ this- > setParam（ 'endofline_to_br'、true）？ >
< div class = "content" >
<？ php echo $ this- > article ['content']？ >
</ div >
< p > <？ php echo $ this- > morph（count（$ this- > comments）、 'comment'、 'comment'、 'comment'）？ > ： </ p >
<？ php $ this- > setParam（ 'xss_protecttion'、true）？ >
<？ php foreach （$ this- > $ key = > $ valueとしてコメント）{？ >
< p class = "user" > <？ php echo $ value [ 'username' ]？ > ： </ p >
< p class = "comment" > <？ php echo $ value [ 'text' ]？ > </ p >
<？ php }？ >
*このソースコードは、ソースコードハイライターで強調表示されました。

クラスをダウンロードします。

個人のニーズに合わせたクラスの使用は、制限なしで許可されています。一部または一部を含む記事またはソースコードを転載する場合は、（私のサイトへの）リンクが必要です。

ネイティブテンプレートエンジン

More articles: