Smartyをはじめよう！

プラグインはとても便利

Tue, 16 May 2006 11:49:25 +0900

カンマ編集のみならず、プラグインはとてもｌ便利です。値はこうだけど、画面上はこう出したい！って時は、プラグインがおすすめです。例えば、データとして、１は男、２は女だった場合、次のようなプラグインを作っておけばいいわけです。

function smarty_modifier_sex($sex)
{
	if ($sex == 1) return "男";
	if ($sex == 2) return "女";
	return "";
}

カンマ編集プラグインの作り方

Tue, 16 May 2006 11:39:42 +0900

では、実際に作ってみましょう。テンプレートの中では

{$price|kanma}

と使うことにしましょう。作る修正子の名前は「kannma」です。まず、ファイル名ですが、

modifier.修正子の名前.php

になります。なので、今回の場合は、modifier.kanma.php です。次に関数名ですが、

smarty_modifier_修正子名

になります。なので、今回は、smarty_modifier_kanma です。この関数の中で、値をもらって、カンマ編集して返してあげればいいわけで

カンマ編集って面倒じゃない？（プラグインのススメ）

Tue, 16 May 2006 11:23:46 +0900

すっかり更新が止まってました。はよ書け！と、突っ込みまで頂きました（汗）。金額などはよく、カンマ編集して表示します。カンマ編集自体は、PHPの number_format 関数を使えばなんてことないんですが、カンマ編集した値は計算には使えないので、表示用に、カンマ編集した値も別途必要になります。１つの値に２つの変数が要るわけで、変数名をどうするか？例えば、$price と $price_str にしようかとか。。。これを考えるだけでも、メンドイ。プログラムの関数の中で、引数で２つ渡すべきか、それぞれの関数の中で編集するかとか。。。。あぁ～、メンドイ。と、Smartyの修正子を見ても、あってもよさそうなカンマ編集がない。こんなときは、

修正子を連結して使う

Thu, 23 Mar 2006 12:46:06 +0900

修正子はそれ単体でも使えます（当然です）が、通常は複数の修正子を使います。例えば、input タグで入力された内容を、確認画面でそのまま表示する場合、エスケープしないといけない文字（<、> など）が入力されることもあります。この場合、入力された文字をそのまま表示するには、escape が必要です。しかも、未入力の場合は「＊未入力」と表示したい場合には、default も使います。このような場合は、次のように書きます。

{$str|escape|default:"＊未入力"}

nl2br：改行文字を
に変換

Wed, 08 Mar 2006 18:28:50 +0900

textareaで複数行入力すると、必ずと言っていいほど「改行」されます。これをこのまま表示しても改行されません。HTMLの改行は
なので、HTML上で改行させるには、これに変換しないといけません。 PHPには便利な関数があって、nl2br() を使って、改行文字を
に変換できます。通常はこれを使って表示すればいいのですが、まったく同じ機能がSmartyにもあります。それが、 nl2br です。

{$str|nl2br}

で、勝手に改行してくれます。

escape：<や>をそのまま表示

Fri, 03 Mar 2006 09:47:46 +0900

< や > を表示しようとする時は、< や > とわざわざ変換してやらないといけないんですが、escapeを使うと、その変換をしてくれます。

$str = "太字";
$smarty = new Smarty;
$smarty->assign("str",$str);
$smarty->display('index.html')

とPHPでは、値をそのまま渡して、テンプレートのほうで

{$str|escape}

と書けば、出力結果は

太字

となります。この種の変換はいちいち面倒なので、かなり重宝します。 escapeしなければ、　はそのままタグとして、太字と表示されます。

default：空文字の場合の表示の指定

Wed, 22 Feb 2006 11:10:09 +0900
表示する内容が空文字の場合はよくあります。任意登録の項目は往々にして何も入力しない場合が多いです。その場合、それをそのまま出すと、表示的によろしくない場合があります。また、未登録の場合は「未登録」と明示的に表示したい場合もあります。今までは、これらの処理はPHPでやってました。

if ($mail == "") $dispmail = "<メールアドレスは登録されていません>"; else $dispmail = $mail;

今までの話だと、Smartyで表示する場合も同じようなものです。ここで使うのが default です。

表示に関する部分は出来るだけテンプレートで

Tue, 21 Feb 2006 09:54:32 +0900
テンプレートでPHPからの値を表示するには {$name} と書きます。また、連想配列で値を渡す場合は {$member.name} のように書きます。テンプレートの便利なところは、この変数に、修正子と呼ばれる、修飾語みたいなものが書けます。つまり、この修正子を使えば、今まで、PHPプログラムのほうで、出力のための編集を、テンプレート側で行うことが出来ます。

表示の仕方もテンプレートで

Mon, 13 Feb 2006 12:04:54 +0900
繰り返しの行を表示する。表示項目が多くても意外と簡単に表示できる。この２とおりが出来れば、検索して結果を一覧で表示して、タイトルなりをクリックすると詳細な画面を表示するといった、基本的なWebプログラムは出来上がります。もう１つテンプレートの素晴らしい機能として、表示の仕方もいろいろ設定ができます。どういうことかと言うと、例えば、改行の扱い。textareaで改行付きの文章を入力し、それを表示する場合など、今まではPHPプログラムのほうで、改行コードを
に置き換えていました。しかし、この処理もテンプレートで出来ます。また、< や > のような文字もエスケープする必要があります。これもテンプレートで可能です。その他にもいろいろあります。 Smartyのマニュアルでいうところの変数の修正子と呼ばれる機能です。（前回書いた制御構造は、Smartyのマニュアルだと組み込み関数と呼ばれています）こうやって、表示に関係する部分を出来るだけテンプレートに書くことで、PHPプログラムのほうは、なおいっそう、すっきりとしたコードになります。

表（行）を表示するには？

Sat, 11 Feb 2006 17:47:18 +0900
しばらく、脱線ネタで日を稼いでましたが、続きです。表示する項目が多い場合、連想配列を使うと便利です。というのは、前回の話で、今回は、表の行のような、繰り返し表示する方法です。このような場合は、出力が何行になるか？は分かりません。データベースを読んで初めてわかるものです。なので、最初からテンプレートに
{$member.name1} {$member.name2} {$member.name3}
とは書けません。テンプレートには、PHPプログラムからの値を表示するだけでなく、いわゆる制御構造をいうモノを持っています。なんですか？それ？

Smarty日本語

Fri, 10 Feb 2006 09:42:40 +0900
日本語のサイトです。日本語のマニュアルはここです。 http://sunset.freespace.jp/smarty/ マニュアルはWebでも見れますし、Windows用のヘルプファイルの形式でダウンロードも出来ます。

Smarty本家

Thu, 09 Feb 2006 23:47:19 +0900
いわずと知れた Smartyの本家です。 http://smarty.php.net/

Smarty入門 PHP5＋テンプレート・エンジンでつくるMVCアプリケーション

Tue, 07 Feb 2006 02:02:39 +0900
smarty関連の書籍は知らなかったのですが、amazonで１冊だけありました。 Smarty入門 PHP5＋テンプレート・エンジンでつくるMVCアプリケーション実物は見たことないのですが、入門書には最適みたいです。 PHPはver.5みたいですね。

表示するアイテムが多い場合

Mon, 06 Feb 2006 10:23:31 +0900
なるほど、表示したい値（変数）に対して　$smarty->assign("…",$…); を繰り返せば表示できますが、普通、１つのページに山ほど表示する値はあります。手前味噌で恐縮ですが、福井の不動産サイト（http://fukui.fudo-3.info/）の物件の詳細画面ともなると、所在地、沿線、賃料、敷金、礼金、うんぬんかんぬんと。これ全部について、$smarty->assign("…",$…);　をしないといけないのかと思うと、プログラマーはゾッとします。正直、そんなたくさん書くのは面倒。。。でも、これを言っちゃうとダメなので、プログラムの管理上どーのこーのとか、共通化出来んのか？とか言い始めます。バグ対策もあるので、ひとえに否定も出来ませんが、その半分以上はこんなに書くの面倒じゃ！！が率直な意見だと思います。現に私はそうです。どうも、プログラマーという人種は、楽をしたがります。そこで、

基本的な流れ

Sat, 04 Feb 2006 20:27:17 +0900
プログラムからの値を表示出来たので、流れを簡単に説明します。マニュアルを熟読すれば、もっと効率良い使い方があるかも知れませんが、私は普段使っている内容しか書けないので、その範囲内ということで。まず、PHPプログラムのほうですが、 index.php
（１） $name = "矢口真里";　（２） $smarty = new Smarty;　（３） $smarty->clear_cache('index.html');　（４） $smarty->assign("namae",$name);　（５） $smarty->display('index.html');　（６） ?>

Smartyをはじめよう！

プラグインはとても便利

カンマ編集プラグインの作り方

カンマ編集って面倒じゃない？（プラグインのススメ）

修正子を連結して使う

nl2br：改行文字を に変換

escape：<や>をそのまま表示

default：空文字の場合の表示の指定

表示に関する部分は出来るだけテンプレートで

表示の仕方もテンプレートで

表（行）を表示するには？

Smarty日本語

Smarty本家

Smarty入門 PHP5＋テンプレート・エンジンでつくるMVCアプリケーション

表示するアイテムが多い場合

基本的な流れ

nl2br：改行文字を
に変換