オブジェクト

Smarty は、テンプレートから PHP の オブジェクト へのアクセスを許可しています。オブジェクトにアクセスするには２つの方法があります。

• １つはテンプレートに オブジェクトを登録 し、カスタム関数 と似た構文を用いてアクセスする方法です。

• もう１つの方法は assign() を用いてテンプレートにオブジェクトを割り当て、 他の割り当てられた変数のようにオブジェクトにアクセスする方法です。

１つめのメソッドは素晴らしいテンプレート構文を持っています。 それはとてもセキュアで、 登録されたオブジェクトはいくつかのメソッドやプロパティを制限する事が出来ます。 しかし繰り返しの処理やオブジェクトの配列への割り当て等の事が出来ません。 あなたのニーズによって選択するメソッドは決まりますが、 テンプレート構文を最小限守るには必ず１つめのメソッドを使用して下さい。

$security が有効の時、('_' から始まる) プライベートメソッドや関数にはアクセス出来ません。 もしメソッドとプロパティで同じ名前が存在する場合、メソッドが優先されます。

第３パラメータにメソッドやパラメータをリストした配列を与える事でアクセスを制限できます。

デフォルトではテンプレートからオブジェクトに渡されたパラメータは カスタム関数 によって同じ方法で渡されます。 連想配列は第１パラメータとして渡され、 smarty オブジェクトは第２パラメータとして渡されます。 もし古いオブジェクトパラメータの渡し方のように各引数を一度に渡したいなら、第４パラメータに FALSE を指定します。

任意の第５パラメータは format が TRUE の時だけ影響し、 ブロックとして扱われるべきオブジェクトのメソッドのリストを格納します。 これはこれらのメソッドがテンプレート内に終了タグ ({foobar->meth2}...{/foobar->meth2}) を持つことを意味し、メソッドへのパラメータは block-function-plugins へのパラメータと同じ構文となります。つまり、４つのパラメータ $params、 $content、 &$smarty および &$repeat を持ち、ブロック関数プラグインのように振る舞います。

{* 登録されたオブジェクトにアクセスします *}
{foobar->meth1 p1='foo' p2=$bar}

{* outputに割り当てる事が可能 *}
{foobar->meth1 p1='foo' p2=$bar assign='output'}
the output was {$output}

{* 割り当てたオブジェクトにアクセスします *}
{$myobj->meth1('foo',$bar)}

register_object() および assign() も参照してください。