ThinkPHP テンプレート使用ガイド
- WBOYオリジナル
- 2016-06-13 13:04:21820ブラウズ
ThinkPHP テンプレート使用ガイド
使用例:
{$webTitle|md5|strtoupper|substr=0,3}
コンパイルされた PHP コードは次のとおりです:
関数の定義と使用順序の対応に注意してください。一般に、関数の最初のパラメータは前の変数、または変数が最初のパラメータでない場合は前の関数の結果です。この関数では、位置決め記号を使用する必要があります。例:
{$create_time|date="y-m-d",###}
コンパイルされた PHP は次のとおりです:
使用する関数の数に制限はありませんが、TMPL_DENY_FUNC_LIST を設定して無効な関数のリストを定義することで、テンプレート出力への損傷を防ぐために、システムはデフォルトで exit 関数と echo 関数を無効にすることができます。例:
TMPL_DENY_FUNC_LIST=>"エコー、終了、停止"
複数の関数を区切るには半角カンマを使用します。
?
また、テンプレート変数を渡さずにテンプレート ファイル内で関数を直接呼び出すためのショートカット メソッドも提供します。これには、次の 2 つのメソッドが含まれます。
1. メソッドを実行し、戻り値を出力します:
形式: {:function(…)}
例: U メソッドの戻り値を出力します:
{:U('ユーザー/挿入')}
コンパイルされた PHP コードは
です?
2. 出力なしでメソッドを実行します:
形式: {~function(…)}
たとえば、say_hello 関数を呼び出します。
{~say_hello('ThinkPHP')}
コンパイルされた PHP コードは次のとおりです:
システム変数
テンプレート エンジンは、通常の変数の出力に加えて、システム変数、システム定数、およびシステムの出力もサポートしています。特殊な変数。出力を事前にテンプレート変数に割り当てる必要はありません。システム変数の出力は $Think で始まり、関数の使用をサポートする必要があります。
1. システム変数: サーバー、セッション、ポスト、取得、リクエスト、クッキーを含む
{$Think.server.script_name } // $_SERVER 変数を出力
{$Think.session.session_id|md5 } // $_SESSION 変数を出力します
{$Think.get.pageNumber} // $_GET 変数を出力します
{$Think.cookie.name } // $_COOKIE 変数を出力
$_SERVER、$_ENV、$_POST、$_GET、$_REQUEST、$_SESSION、$_COOKIE 変数の出力をサポートします。次のサーバー、Cookie、および構成では大文字と小文字が区別されませんが、変数では大文字と小文字が区別されます。例:
{$Think.server.script_name} と {$Think.SERVER.script_name} は同等です
SESSION と COOKIE は、次のような 2 次元配列の出力もサポートしています。
{$Think.CONFIG.user.user_name}
{$Think.session.user.user_name}
システムでは3次元を超える配列出力をサポートしていませんので、以下の方法で出力してください。
?
上記のメソッドは次のように書くこともできます:
{$_SERVER.script_name } // $_SERVER 変数を出力します
{$_SESSION.session_id|md5 } // $_SESSION 変数を出力します
{$_GET.pageNumber} // $_GET 変数を出力します
{$_COOKIE.name } // $_COOKIE 変数を出力します
?
2. システム定数: $Think.const を使用して
を出力します。{$Think.const.__SELF__ }
{$Think.const.MODULE_NAME }
または直接使用します
{$Think.__SELF__ }
{$Think.MODULE_NAME }
?
3. 特殊変数: ThinkPHP システムによって内部的に定義された定数
{$Think.version } //バージョン
{$Think.now } //さあ、時間です
{$Think.template|basename} //テンプレート ページ
{$Think.LDELIM } //テンプレートラベルの開始記号
{$Think.RDELIM } //テンプレートタグの終了記号
?
4. 設定パラメータ: プロジェクトの設定パラメータ値を出力します
{$Think.config.db_charset}
出力値は C('db_charset') の戻り結果と同じです。
次のような 2 次元構成パラメータを出力することもできます。
{$Think.config.user.user_name}
?
5. 言語変数: プロジェクトの現在の言語定義値を出力します
{$Think.lang.page_error}
出力値はL('page_error')の戻り結果と同じです。
クイック出力
テンプレート定義をより簡潔にするために、システムは、次のような一般的に使用されるいくつかの変数出力ショートカット タグもサポートしています。
と同等です
{#var} //出力 Cookie 変数は {$Think.cookie.var}と同等です
{&var} //出力構成パラメータは {$Think.config.var}と同等です
{%var} //出力言語変数は {$Think.lang.var}と同等です
{.var} //出力 GET 変数は {$Think.get.var}と同等です
{^var} //出力 POST 変数は {$Think.post.var}と同等です
{*var} //出力定数は {$Think.const.var}
と同等です$_SESSION[‘var1’][‘var2’] の値を出力するなど、2 次元配列を出力する必要がある場合は、次のクイック出力を使用できます。
}方法同様に
{#var1.var2}
$_COOKIE[‘var1’][‘var2’]の値を出力できます。
クイック出力変数は関数の使用をサポートしていないことに注意してください。
したがって、次の使用法は正しくありません:
{#var|strlen}
デフォルト値出力
出力テンプレート変数に値がないが、表示時にデフォルト値を割り当てる必要がある場合は、デフォルト構文の形式を使用できます:
ここでのデフォルトは関数ではなく、システムの文法規則です。例:
{$user.nickname|default="この男は怠け者で何も残さない"}
システム変数の出力では、次のようなデフォルト値もサポートできます。
{$Think.post.name|default="名前が空です"}
クイック出力は関数の使用をサポートしていないため、デフォルト値は HTML 構文をサポートしません。
インクルードファイル
Includeタグを使用して外部テンプレートファイルをインクルードできます。使用方法は次のとおりです:
を含む完全なファイル名を使用します。
形式:例:
この場合、テンプレート ファイル名にはサフィックスが含まれている必要があります。完全なファイル名の包含を使用する場合は、ファイルの包含が URL アドレスを含むのではなく、サーバー側の包含を参照すること、つまり、ファイル パラメーターが相対パスとして書き込まれることに特に注意してください。パスが使用される場合、それはプロジェクトのエントリの場所に基づきます。
?
2. 現在のモジュールを含むその他の操作テンプレート ファイル
形式:
たとえば、現在のモジュールの下に読み取り操作テンプレートをインポートします:
操作テンプレートにはサフィックスは必要ありません。
?
3. 他のモジュールの操作テンプレートが含まれています
形式:
たとえば、Public モジュールを含むヘッダー操作テンプレート:
?
4. 他のテンプレート テーマを含むモジュール操作テンプレート
形式:
たとえば、青色のテーマを含むユーザー モジュールの読み取り操作テンプレート:
?
5. 変数を使用してインポートするテンプレートを制御します
形式:
たとえば
$tplName に異なる値を割り当てると、異なるテンプレート ファイルを含めることができます。変数値の使用方法は上記と同じです。
?
6. ショートカットを使用してファイルを含めます
形式: {include: テンプレート ファイル ルール}
テンプレート ファイル ルールでは、上記の 5 つの方法を使用できます。
注: テンプレート解析の特性により、解析はエントリ テンプレートから開始され、外部テンプレートが変更された場合、キャッシュの有効期限が切れない限り、テンプレート エンジンはテンプレートを再コンパイルしません。付属の外部テンプレート ファイルを変更する場合は、モジュールのキャッシュ ディレクトリをクリアする必要があります。クリアしないと変更が反映されません。
ファイルのインポート
外部 JS および CSS ファイルをインポートする従来の方法は、それらをテンプレート ファイル内で直接使用することです: