phpcms ソースコード分析 - テンプレート エンジン

phpcms ソース コード分析-----テンプレート エンジン
PHPCMS サイト全体コード解析解説 (6) テンプレートエンジン
発行者：Shuishui

5 月 19 日

/**
関数 テンプレート関数はglobal.func.phpで定義されています。 phpcms のホームページのindex.phpで確認できます。使用法: include template() 使用法は非常によく知られていますが、実際には dz テンプレート エンジンと同じです。 ただし、DZ のテンプレート エンジンはテンプレート タグ テクノロジを使用しないため、PHPCMS よりもはるかにシンプルです。 時間があれば、DZ のテンプレート エンジンを勉強してください。ここでは言及されていません。上記のテンプレートの主な機能を分析してみましょう。その機能は、コンパイルされたテンプレート ファイルのパスを返すことです。つまり、テンプレート X.html (テンプレート ファイル) を正規表現で x.php (コンパイルされた PHP ファイル) に置き換えてから、include 関数を使用します。わかった！ PHP のテンプレート エンジンはすべて同じです。 あとは通常のものです。後で話しましょう。
*/
function template($module = 'phpcms', $template = 'index')
{
global $CONFIG;
$compiledtplfile = $CONFIG['templatescachedir'].$module.'_'。 template.'.tpl.php';
/**
phpcms はテンプレート ファイルをモジュールに保存するためです。したがって、テンプレート関数には 2 つのパラメータがあります。1 つ目はモジュールのディレクトリ名、2 つ目はこのモジュール内のテンプレート ファイル名です。
$CONFIG['templatescachedir'] これは、コンパイルされた PHP ファイルが保存されるディレクトリです。 config.inc.php サイト構成ファイルで何が定義されているかを確認してください。 これにより、テンプレートコンパイル後のPHPファイルパスが取得されます。
*/
if($CONFIG['templaterefresh']) //$CONFIG['templaterefresh'] in config.inc.php 設定されました。デフォルトは 1 です。テンプレート更新スイッチです。 0 に設定すると、テンプレートが更新されます。プログラムは更新されません。
{
$tplfile = PHPCMS_ROOT.'/templates/'.$CONFIG['defaulttemplate'].'/'.$module.'/'.$template.'.html';
/* *
上の文と同様の意味です。 $CONFIG['defaulttemplate'] はデフォルトのテンプレート ディレクトリです。この文は、必要なモジュールへのパスとその中のテンプレート ファイルを取得します (@@コンパイル前にテンプレート ファイルを取得します)
*/
if(!file_exists($compiledtplfile) || @filemtime($tplfile) > @filemtime($compiledtplfile))
{
/**
ファイルを php ファイルにコンパイルしました。その後、テンプレが変わりました。 php ファイルも変更する必要があります。または、テンプレートを変更した後。駅が以前と同じままなら、何の意味があるのでしょうか？
まず、テンプレートのコンパイル ファイルが存在するかどうかを確認します。存在しない場合は、後者の条件を判断する必要はありません。 コンパイルされたファイルが存在しないためです。プログラムは間違いなく実行されません。 (実際には、主にコンパイルされた php ファイルを実行し、テンプレート ファイルは html であるためです。)
または @filemtime($tplfile) > @filemtime($compiledtplfile) 理解するのは簡単です: 関数 filetime() が決定しますファイルの最終変更時刻を返し、Unix タイムスタンプを返します。 テンプレート ファイルの変更時間がコンパイルされたファイルよりも長い場合。 これにより、コンパイルされたファイルが生成された後にテンプレート ファイルが変更されたことが証明されます。では、更新時にファイルをコンパイルする必要があるのは確かです。 さあ、やってみよう。
*/
require_once PHPCMS_ROOT.'/include/template.func.php'; // コンパイル関数をロードします。
template_refresh($tplfile, $compiledtplfile) // これは、一連のテンプレートを駆動するテンプレート コンパイルの起動関数です。コンパイル関数 最終的にテンプレートのコンパイル ファイルを生成します。
}
}
return $compiledtplfile; // テンプレートのコンパイル後に PHP ファイルのパスを返します。
}

define('IN_PHPCMS') or exit('Access Denied');
function template_compile($module,$template) //以下と同様、コンパイルテンプレートですスタートアップ機能。ただし、2 つの関数のパラメータはコンテキストに応じて異なります。この関数は、テンプレートのバッチ コンパイルと連携するように作成されています。 1つ目はモジュールのディレクトリ名、2つ目はテンプレートファイル名です。説明は以下と同様です。以下をご覧ください。
{
global $CONFIG;
$content = file_get_contents(PHPCMS_ROOT.'/templates/'.$CONFIG['defaulttemplate'].'/'.$module.'/ '. $template.'.html');
$content = template_parse($content);
$compiledtplfile = $CONFIG['templatescachedir'].$module.'_'.$template.'.tpl .php ';
$strlen = file_put_contents($compiledtplfile, $content);
@chmod($compiledtplfile, 0777);
return $strlen;
}
function template_refresh($tplfile) ,$ dedicatedtplfile) //テンプレートコンパイル起動関数。 最初のパラメータはテンプレート ファイル名で、2 番目はコンパイルされた PHP ファイル名です。
{
$str = file_get_contents($tplfile) //php5 の最もクールな関数 file_get_contents() を使用してファイルのコンテンツを取得します。 。
$str = template_parse($str); /*次に、template_parse() 関数を使用してファイルの内容を置き換えます。たとえば、独自に定義したステートメントの一部を次のように置き換えます: {if xx > xx} を xx){?> 詳細については以下を参照してください*/
$strlen = file_put_contents($compiledtplfile) , $str);//コンパイル完了後。いわゆるコンパイルされた PHP ファイルにコンテンツを書き込みます。
@chmod($compiledtplfile, 0777); // 権限の設定を忘れないでください。
return $strlen; //template_parse() 関数を見てみましょう。
}
function template_module($module)//これは非常に便利です。役に立つ。モジュール ディレクトリ内のテンプレート ファイルをバッチ コンパイルします
{
global $CONFIG;
$files = glob(PHPCMS_ROOT.'/templates/'.$CONFIG['defaulttemplate'].'/'.$module . '/*.html');
/*
glob 関数 このパスにある html 拡張子を持つすべての *.html ファイルのリストを取得します。 詳細についてはマニュアルを参照してください。
**/
if(is_array($files))
{
foreach($files as $tpl)
{ //バッチを開始
$template = str_replace('. html', '',basename($tpl));
// テンプレートのファイル名を取得します。これを使用して、コンパイルされた PHP ファイル名を作成します。
template_compile($module, $template); //この関数は上で説明しました。上記を参照してください。
}
}
return TRUE;
}
function template_cache() //これは、上記のものよりも大きなバッチ生成です。 $MODULE 内のすべてのモジュールはキャッシュされたファイル テンプレートに存在するためです。すでに前にも言いました。自分の目で確認してください
{
global $MODULE;
foreach($MODULE as $module=>$m)
{
template_module($module);
}
return TRUE;
}
/**
まあ、怖がらないでください。実際、それらはすべて簡単なルールです。彼らが何をするのかを知っていれば、それは簡単です。 テンプレートではいくつかの自己定義タグを使用します。声明。これらは PHP の標準構文ではありません。そのため、走行することは全く不可能です。
それではどうすればいいでしょうか？正規表現を通じて独自に定義した文法。標準の PHP 構文に変換します。次に、それを PHP ファイルに書き込みます。したがって、以下の正規表現は独自に定義した文法をまとめたものです。
以下は通常のルールについて説明します。自分のレベルに合わせて解説します。ざっくりと説明しました。ただし、ルールがわからない場合は、Baidu から学んでください。何かが間違っています。誰もがそれについて議論することができます。 @@ preg_replace() 関数をまだ理解していないクラスメート、兄弟姉妹の皆さん。説明書はご自身でお読みください。
*/
function template_parse($str)
{
$str = preg_replace("/([nr]+)t+/s ","\1",$str);
// タブ文字を除外するには nr を使用します。\1 は、最初の括弧内の n 行送りと改ページで一致するテキストへの逆参照です (@@ で説明します)または、Baidu に関する定期的な知識を自分で確認するのが最善です)
$str = preg_replace("//s", " {\1 }",$str);
// {xx} を {xx} に置き換えます。以下に 2 番目の通常の置換が必ずあります。そうでない場合は、PHP で実行できません。 。 .+? と .+ 1 つは怠惰で、もう 1 つは貪欲です。名前を見ただけでわかります。知らない人のために説明すると、Baidu Bar: 通常の貪欲さ。

$str = preg_replace("/{templates+(.+)}/","nn",$str);
/*テンプレート内の {template 'xx','jj'} を PHP 標準の記述にコンパイルします: 一目で理解できると思います: include template()そこにこれ。右。これはPHPでも実行できます。 template() 関数が定義されていないためです。 */
$str = preg_replace("/{includes+(.+)}/","nn",$str);
/* { テンプレート内include xx.php} は、PHP では **/
$str = preg_replace("/{phps+(.+)}/","nn",$str);
/* テンプレート内の {php xxxx} は にコンパイルされます。誰もが理解できるはずです。 xxxx は間違いなく PHP の標準構文です。 したがって、phpcms テンプレート ステートメント: {php} は、テンプレート内で実行される PHP ステートメントを記述するために使用されます。この関数は、smarty **/
$str = preg_replace("/{ifs+(.+?)}/","",$str) でも利用できます。 ;
/* これはさらに単純です。 テンプレート内の {if xxxx} を にコンパイルします。いくつかの自己定義ステートメントを PHP 標準構文にコンパイルする方法を段階的に説明します。これをテンプレートエンジンと呼びます。 **/
$str = preg_replace("/{else}/","",$str);
/* {else } to**/
$str = preg_replace("/{elseifs+(.+?)}/","",$str); 🎜>/* {elseif }turn**/
$str = preg_replace("/{/if}/","", $str );
/* {/if} から phpcms テンプレートの構文は {/if} です。忘れないでください。そうしないと、php は間違いなく実行されません**/
$str = preg_replace("/{loops+(S+)s+(S+)}/","",$str) ;
/* 以下はループです。テンプレートで {loop xx jj} を使用すると、実際には PHP の foreach(xx AS jj) にコンパイルされるため、誰でも使用できるようになります**/
$str = preg_replace("/{loops+(S+)s+(S+)s+( S+)}/","n \3) { ?>",$str);
/* この文は同上 同上。ただし、配列 {loop xx jj yy} を foreach(xx as jj=> yy)**/
$str = preg_replace("/{/loop}/","n<) に取り出すための追加のラベルがあります。 ; ?php } ?>n",$str);
/* ループ終了時には {/loop} を忘れないでください。PHP の**/
$str に相当します。 = preg_replace(" /{tag_([^}]+)}/e", "get_tag('\1')", $str);
/* {tag_xx} は get_tag('xx') に置き換えられますget_tag()関数はphpcmsのテンプレートエンジンがタグ機能を応用しているため、独自定義関数となります。この関数はタグを呼び出すためだけのものです。 **/
$str = preg_replace("/{([a-zA-Z_x7f-xff][a-zA-Z0-9_x7f-xff]*(([^{}]*)))}/" ,"",$str);
/* {xxx(jj)} なんとも不思議なことです。不思議だったのでPHPCMSのテンプレートファイルを探してみました。いくつかのファイルを検索しましたが、このモンスターは見つかりませんでした。誰か見つけたら、教えてください。ルールを誤解していたようです。よろしくお願いします**/
$str = preg_replace("/{\$([a-zA-Z_x7f-xff][a-zA-Z0-9_x7f-xff]*(([^{}]*) ))}/","",$str);
/* {$xxx(wwsd)} は $str = preg_replace("/{([a-zA-Z0-9_x7f-xff]*)}/]\$[a-zA -Z_x7f-xff][a-zA-Z0-9_x7f-xff]*)}/","",$str);
/* {$xxjj} を入れる に変換します もちろん、変数 **/
$str = preg_replace("/{(]\$[a-zA-Z0-9_[]'"$x7f) を出力します-xff]+)}/es", "addquote('')",$str);
/* 主に {$xxx['jj']} に変換します 以下に addquote() 関数を定義し、世代検証が行われますが、黄色の単語を長時間見ているとめまいがします。 **/.
$str = preg_replace("/{([A-Z_x7f-xff][A-Z0-9_x7f-xff]*)}/s", "/* {XXJJ} XXJJ は定義した定数です**/
$str = "".$str;
/* 最後に、これを各コンパイル済みファイルに追加することを忘れないでください。前に述べたように、理解できない場合は、前の例の場合**/
return $str; //最後にフィルタリングされたコンテンツを返します
}
function get_tag($tagname) //実際、この関数は上記のコンパイル済み関数で見られます。対応するタグの内容を取得することです。少しめまいがします。
{
global $tags,$html,$CONFIG;
if(!$tags) ) require PHPCMS_ROOT.'/templates/'.$CONFIG['defaulttemplate'].' /tags.php';
if(!$html) require PHPCMS_ROOT.'/templates/'.$CONFIG['defaulttemplate'] .'/html.php';
if(!isset($tags[ $tagname])) return '{tag_'.$tagname.'}';
$code = isset($html[$tagname]) ]) ? 'tag_read('.$html[$tagname].')' : $tags[$tagname];
return "";
}
function addquote($var)
{
return str_replace("[ url=]\[/url]"", """, preg_replace("/[([a-zA-Z0-9_-. x7f-xff]+)]/s", "['\1']" , $var));
}
?>
[size=xx-small][/size]