Smarty3: カスタム変数メディエーター プラグイン

Smarty3: カスタム変数メディエーター プラグイン

テンプレートに特別な処理が必要な変数があり、システムのデフォルトの変数レギュレーターがそのような機能を提供していない場合は、変数レギュレーターをカスタマイズできます。 Smarty は、プラグインを拡張するための 2 つのメカニズムを提供します:

PHPで書いた関数をSmartyオブジェクトの registerPlugin() メソッドでSmartyオブジェクトに登録し、テンプレートで利用します

システムのデフォルトの可変レギュレータと同様に、Smarty ライブラリ ファイルが配置されているディレクトリの下の Plugins ディレクトリに特定のファイル拡張子プラグインを作成します。

1. registerPlugin() メソッドを使用して変数メディエーター プラグインを展開します

registerPlugin() には 3 つのパラメータがあります:

文字列「modifier」を使用して、プラグインのタイプを修飾子として指定します

プラグインの関数名

定義された PHP コールバック関数

例: 以下に示すように、PHP スクリプトで関数を test() として宣言し、Smarty メディエーター「mystyle」として登録します。

<?php
//加载smarty初始化文件
include "init.inc.php";
//向模版中分配一个字符串变量var
$smarty -> assign("var","这是一个字符串的数据，看看样式变量");

//使用registerPlugin()方法，将函数test()动态注册为模版中可以使用的修改器mystyle函数
$smarty->registerPlugin("modifier","mystyle","test");
//声明一个函数，为Smarty扩充修改器
function test ($var, $color, $size){
    return '<font color="'.$color.'" size="'.$size.'">'.$var.'</font>';
}

$smarty->display("test.tpl");
/*模版中通过使用
{$var|mystyle:"red":7}{*自定义的变量调解器mysql,将变量$var的字体改为红色和7号字*}
*/

カスタム関数を変数メディエーター関数として登録するだけでなく、registerPlugin() メソッドを使用してシステム関数をプラグインとして PHP に直接登録することもできます。ただし、 関数の最初のパラメーターが正しく設定されていることを確認してください。 PHP システムでは、 は処理される変数です。それ以外の場合は、関数をカスタマイズしてパラメータの位置を調整する必要があります。

<?php
//加载smarty初始化文件
include "init.inc.php";
//向模版中分配一个字符串变量var
$smarty -> assign("var","这是一个字符串的数据，看看样式变量");

//直接将PHP系统函数substr(),注册成变量调解器函数substr
$smarty->registerPlugin('modifier','substr','substr');

//因为PHP系统函数preg_match()函数的第一个参数不是要处理的变量，所以自定义demo()函数重新注册
function demo($var, $reg,$text){
    return preg_match($reg,$text,$var);
}
$smarty->registerPlugin('modifier','regrep','demo');

$smarty->display('test.tpl');

2. 特定のファイルで変数メディエーター プラグインを展開します

registerPlugin() メソッドを使用しているため、この関数は PHP プログラム内で宣言されていますが、PHP プログラム内では使用されておらず、PHP スクリプトの他の関数と混在しているため、PHP プログラム内で混乱が生じます。論理。可読性が低いため、プラグインを特定のファイル形式で拡張することをお勧めします。

smarty が定義したルールに従う必要があります。プラグインの宣言場所、ファイル名、関数名、パラメータ規則などの制約が含まれます。

プラグイン宣言の場所

これに付属するデフォルトのプラグインはすべて、smarty クラス ライブラリの下の plugins ディレクトリにあるためです。したがって、addPluginsDir() メソッドを使用してカスタム プラグインの場所を指定するのが最善です。

    $smarty->addPluginsDir(ROOT."plugins");//自定义插件目录

ファイルの命名方法

modifier.修改器名称.php      //以modifier为前缀，中间使要声明的修改器名称，以php结束

関数の命名規則

smarty_modifier_修改器名称()     //函数名称要以smarty_modifier_为前缀，再加上修改器名称

パラメータの説明

パラメータの最初のパラメータは、変更される変数に自動的に渡されます。モディファイア内の他のパラメータは 2 番目のパラメータから始まります。

上記のモディファイアを変更します。モディファイア ファイルの名前は modifier.mystyle.php で、addPluginsDir() メソッドによって追加されたプラグイン ディレクトリに配置されます。

<?php
//自定义修改器mystyle，以后就可以直接在任意模版中使用了.例如:{$var|mystyle:"red":7}
function smarty_modifier_mystyle($var,$color,$size){
     return '<font color="'.$color.'" size="'.$size.'">'.$var.'</font>';
     }