Smartyはじめました!

Smarty を使った開発でデバッグを行う方法

2008-02-16T01:43:00.001+09:00

【modifier】テンプレート上のSmarty変数をPHP関数で扱う

2008-01-17T14:23:00.000+09:00

ITpro
【PHP TIPS】 68. Smartyのmodifierを使いこなそう

Smartyでは、assignされた変数に処理を与えるmodifier という機能がある。
PHP関数をパイプ「|」でつなげて記述して使用します。

$smarty->assign('name', 'atsushi');

上記のコードをPHPファイル内に記述して変数をアサインする。テンプレート内で文字を大文字にするstrtoupper()関数で処理するにはに

{$name|strtoupper}
//結果:ATSUSHI

modifierに配列を渡す場合は、関数名の前に「@」をつける。

$name_list = array(
    '0' => 'atsushi',
    '1' => 'yoshiki',
    '2' => 'miwa',
    '3' => 'hiroshi',
    '4' => 'saito'
);
$smarty->assign('name_list', $name_list);

{$name_list|@count}
//結果:5

modifierには「:」をつけることで引数を渡すこともできる。

{$name|substr:'1':'3'}
 //結果:tsu

modifierでは、パイプの前の変数とコロンの後に指定した値が、並べた順番にそのまま関数に渡される。
例えば、{$name|str_replace:'shi':'ko'}だとstr_replace($name, 'shi', 'ko')渡していることになる。
str_replace('shi', 'ko', $name); のように渡したい場合は次のようになる。

{'shi'|str_replace:'ko':$name}
//結果:atsuko
{'/a|i|s/'|preg_replace:'!':$name}
//結果:!t!u!h!

参考

ITpro 総合トップ: http://itpro.nikkeibp.co.jp/index.html

2007-12-28T14:35:00.000+09:00

php+smartyで動いているPC用のサイトをテンプレートだけ変えて携帯サイトに変換する方法をご紹介。

php+smartyで手抜きケータイサイトをつくる。

１．ユーザーエージェントやIPなどで携帯からのアクセスか、パソコンからのアクセスかを判別する。
２．携帯からのアクセスだった場合はsmartyのテンプレート関連ディレクトリを携帯用のテンプレートを入れたディレクトリに切り替え。
>※携帯用のテンプレートはPC版と同じ文字コードにしておいてください。
３．$smarty->displayしてるとこでPCからのアクセスだった場合はそのままdisplayで表示させる。
携帯からのアクセスだった場合は$smarty->fetchで表示結果を変数に取得し、mb_convert_encodingを使って文字コードをSJISに変換して変数の内容をecho()で書き出し。
みるくぜりー| php+smartyで手抜きケータイサイトをつくる。

詳しいところはリンク先を参照。
PEARを使った携帯・PCのアクセス判別や、テンプレート・ディレクトリの切り替えに関するソースを省いた必要な部分が以下。
それらがあったほうが便利で楽だが、PEAR使えないサーバもあるので。


class Smarty_Ex extends Smarty{
    function display($template, $cache_id = null, $compile_id = null)
    {
          //携帯なので結果をいったん変数に
          $output=parent::fetch($template);
          //半角カナにしてパケ代をとりあえず節約。
          $output=mb_convert_kana($output,"k","UTF-8");
          //SJISに変換しましょう。
          $output=mb_convert_encoding($output,"SJIS","UTF-8");
          echo $output;
    }
}

上のクラスはsmartyオブジェクトを継承してるので、使うときは変わらず。以下の通り。
上のクラスでは、キャリアの判別とディレクトリ切り替えをしてないので、実際使うときはPCと携帯のそれぞれで別のテンプレート・ファイルを呼び出すようにする必要がある。


$smarty=new Smarty_Ex();//smartyオブジェクト作成
$smarty->assign('var',$var);
$smarty->display("index.tpl");

【assign】テンプレートでの変数の定義

2007-11-08T16:23:00.000+09:00

テンプレートファイル内で変数を定義するには{assign}関数をつかう。


{assign var="var" value="`$val1 + $val2`"}

使うときは他の変数と同様に{$var} varが変数名でvalueが値。
"`"で囲むと文字列ではなく計算式として扱う。

【foreach】テンプレート内での繰り返し・ループ

2007-11-08T15:34:00.000+09:00

配列のSmarty変数をループさせるにはforeachがある。

{foreach from=$data item="value" key="key"  name="loop"}
  {if $smarty.foreach.loop.first}
     最初:{$key}:{$value}
  {elseif $smarty.foreach.loop.last}
     最後:{$key}:{$value}
  {else}
    {$smarty.foreach.loop.iteration}:{$key}:{$value}
  {/if}
{foreachelse}
   データがありません
{/foreach}

itemとfromの指定は必須。
配列のキーを使うにはkeyの指定が必要。以下のSmarty予約変数を使うにはnameの指定が必要。

$smarty.foreach.loop.first　… 最初の要素かどうか
$smarty.foreach.loop.last　… 最後の要素かどうか
$smarty.foreach.loop.iteration … 現在のインデクス(何回目のループかカウント)

foreachとsectionの比較

2007-10-09T16:03:00.000+09:00

Smartyforeachとsectionではどちらを使った方が良いか

プログラミングにおいて、同じような処理をする関数ではどちらが処理速度が速いのか、というのは議論になるところと思います。
PHPではecho()とprint()だったり、ループではdo()とwhile()とfor()だったり。
当たり前ですが、処理が単純で引数などがない方が速い様に思います。確か条件分岐があるだけでもプログラムの処理は一気に遅くなるというのをC言語で計測した覚えが有ります。

Smartyでのループ処理のforeachとsectionでは、属性が多く細かな設定が可能なsectionよりforeachの方が好ましいようです。

がるの健忘録 - 2006-09-22

リンク先では、Smartyテンプレートエンジンがテンプレートファイルを解析して作られるキャッシュファイルを比較してます。実際に表示されるのはキャッシュのPHPファイルでしょうから、ソースが増えれば遅くなるでしょう。

{foreach from=$custid item=curr_id}
        id: {$curr_id}

{/foreach}

は


<?php $_from = $this->_tpl_vars['custid']; if (!is_array($_from) && !is_object($_from)) { settype($_from, 'array'); }if (count($_from)):
    foreach ($_from as $this->_tpl_vars['curr_id']):
?>
        id: <?php echo $this->_tpl_vars['curr_id']; ?>
<br>
<?php endforeach; endif; unset($_from); ?>

に。このあたりから微妙なニュアンスが漂います。
おっかないのがsection。どっちもループだよねぇ、程度に思ってたのですが………甘いも甘いも大甘。

{section name=customer loop=$custid}
        id: {$custid[customer]}<br>
{/section}

が、なんと…

<?php unset($this->_sections['customer']);
$this->_sections['customer']['name'] = 'customer';
$this->_sections['customer']['loop'] = is_array($_loop=$this->_tpl_vars['custid']) ? count($_loop) : max(0, (int)$_loop); unset($_loop);
$this->_sections['customer']['show'] = true;
$this->_sections['customer']['max'] = $this->_sections['customer']['loop'];
$this->_sections['customer']['step'] = 1;
$this->_sections['customer']['start'] = $this->_sections['customer']['step'] > 0 ? 0 : $this->_sections['customer']['loop']-1;
if ($this->_sections['customer']['show']) {
    $this->_sections['customer']['total'] = $this->_sections['customer']['loop'];
    if ($this->_sections['customer']['total'] == 0)
        $this->_sections['customer']['show'] = false;
} else
    $this->_sections['customer']['total'] = 0;
if ($this->_sections['customer']['show']):

            for ($this->_sections['customer']['index'] = $this->_sections['customer']['start'], $this->_sections['customer']['iteration'] = 1;
                 $this->_sections['customer']['iteration'] <= $this->_sections['customer']['total'];
                 $this->_sections['customer']['index'] += $this->_sections['customer']['step'], $this->_sections['customer']['iteration']++):
$this->_sections['customer']['rownum'] = $this->_sections['customer']['iteration'];
$this->_sections['customer']['index_prev'] = $this->_sections['customer']['index'] - $this->_sections['customer']['step'];
$this->_sections['customer']['index_next'] = $this->_sections['customer']['index'] + $this->_sections['customer']['step'];
$this->_sections['customer']['first']      = ($this->_sections['customer']['iteration'] == 1);
$this->_sections['customer']['last']       = ($this->_sections['customer']['iteration'] == $this->_sections['customer']['total']);
?>
        id: <?php echo $this->_tpl_vars['custid'][$this->_sections['customer']['index'; ?>
<br>
<?php endfor; endif; ?>

がるの健忘録

細かい設定などが必要ないときはforeachを使った方が良さそうです。

参考

がるの健忘録: http://d.hatena.ne.jp/gallu/

時刻のselect要素が作成できる - {html_select_time}関数

2007-08-03T13:07:00.000+09:00


{html_select_time prefix="" field_array="time" time=$smarty.now  display_seconds=false minute_interval="30"}

実行例：

prefixは各要素名の接頭辞。デフォルトがTime_なので(各セレクト名はTime_Hour、Time_Minute、Time_Second)付けない様にNULL。
field_arrayを指定する事で、時間要素が連想配列で$_POSTに渡される(例だと$_POST["time"]=Array(["Hour"],["Minute"],["Second"]))。
"秒"と"分"の選択メニューは1~30(秒/分)刻み。
true/falseは"(クウォート)で括ったり大文字で記述する(TRUE/FALSE)とうまくいかない様です。

属性(<html_select_date>との共通)

prefix: name属性に負荷する接頭辞[デフォルト：Date_、Tme_]
time: デフォルトセットの日付(YYYY-MM-DD形式かUNIXタイムスタンプで指定)[デフォルト：現在の日付・時刻]
field_array: 入力値を連想配列としてPHPに渡す
all_extra: 全ての<select>タグの属性指定

属性(<html_select_time>の固有)

display_hours: 時のプルダウン表示[true/false](デフォルト：true)
display_minutes: 分のプルダウン表示[true/false](デフォルト：true)
display_seconds: 秒のプルダウン表示[true/false](デフォルト：true)
display_meridian: AM/PMの表示[true/false](デフォルト：true)
use_24_hours: 24時間表示[true/false](デフォルト：true)
minute_interval: 分のプルダウンメニューの間隔[1～30](デフォルト：1分)
second_interval: 秒のプルダウンメニューの間隔[1～30](デフォルト：1秒)
hour_extra: 時の<select>タグの属性
minute_extra: 分の<select>タグの属性
second_extra: 秒の<select>タグの属性
meridian_extra: AM/PMの<select>タグの属性

テンプレートファイル内にPHPスクリプトを記述する - {php}/{include_php}

2007-08-01T17:03:00.000+09:00


{php}
  function MyFunc(){
           …(略)…
  }
{/php}
<html>
  ～(略)～

以上のように、{php}~{/php}内に記述する事でテンプレートファイル内にPHPスクリプトが記述できます。
ただ、Smartyはデザインとプログラムとを分けるためのテンプレート・エンジンなので、テンプレートファイル内にPHPスクリプトを記述する事は好ましく有りません。他の方法で実現出来ないか検討しましょう。
やむを得ずテンプレートファイル内にPHPスクリプトを記述する必要が有るときは{include_php}関数を使って別のPHPファイルを用意する方が、Smarty本来の目的であるデザインとプログラムとを切り離す事を考えると望ましいでしょう。


{include_php file="file.php" [once="true" php assign="var"]}

属性：file="インクルードするスクリプト・ファイルのパス"
        (以下省略可能)
         once="インクルード・ワンス(include_once)の設定"(デフォルトはTRUE)
         assign="スクリプトの結果を格納する変数"

修正子による日付フォーマット表示

2007-07-04T17:23:00.000+09:00

修正子を使ってフォーマットされた日時を表示する。

現在の日時については以下で表現。

{$smarty.now|date_format:"%Y-%m-%d %H:%M:%S"}

出力例:

2007-07-04 18:00:00

{$smarty.now|date_format}

日付フォーマットの指定がないデフォルトでは、%b %e, %Y 形式で例えば以下の出力。

Jul 4, 2007

短縮形の月名,1～31の日付(一桁の日にちはスペースがつく),4桁の西暦年

日付をUNIXタイムスタンプなどで指定する場合

PHPファイル
$smarty->assign('date', strtotime('-1 day'));

テンプレートファイル
{$date|date_format:"%Y年%m月%d日 (%a)}

2007年07月 4日(Wed)

参考

date_format - Smarty マニュアル: http://sunset.freespace.jp/smarty/SmartyManual_2-6-5J_html/language.modifier.date.format.html
Smartyを使った日付表示(予約変数) - bnote: http://www.bnote.net/php/php/19_smarty_var.shtml

基本的なこと

2007-06-21T14:57:00.000+09:00

文字コードはUTF-8で!!
※Shif-JISには対応していないようでテンプレートの読み込み時などでエラー
※携帯サイトには使えない
テンプレートに記述されたJavaScriptやCSSは{literal}{/literal}関数で囲む!
※{literal}関数は囲んだブロックをそのままテキストとして出力するので、JavaScriptやCSSで記述される{}(中括弧)がエラーになりません
テンプレートで記述される相対パスは読み込むPHPファイルが基準!

Smarty ダウンロード

Smarty エンジンのインストール・ファイルのダウンロード先
http://smarty.php.net/download.php

参照サイト

Smarty: http://smarty.php.net/manual/ja/
smarty @Wiki: http://www2.atwiki.jp/smarty/
Smarty - コンパイリング PHP テンプレートエンジン: http://sky.freespace.jp/smarty/SmartyManual_2-6-7J_html/index.html