CodeZine(コードジン)

特集ページ一覧

WEBシステムの様々な機能をSmartyを使って実装する

目的に応じて適材適所で使うPHPライブラリ(7)

  • LINEで送る
  • このエントリーをはてなブックマークに追加
2010/05/25 14:00
目次

Smartyの修飾子を作成する

 Smartyには、テンプレート上で関数を実行して値の加工を行う機能があります。この機能を修飾子といいます。使用する際にはテンプレート内に以下のようにSmarty変数の後ろに「|(パイプ)」をつけて記述します。

[リスト15]修飾子の使用例
{$value|修飾子}

 代表的な修飾子には次のようなものがあります。

Smartyの主な修飾子
修飾子名 概要
upper 値に含まれる英字をすべて大文字に置換する
lower 値に含まれる英字をすべて小文字に置換する
nl2br 文字列の改行を「<br />」に置換する
popoup javascriptのポップアップを出力する
escape 値に含まれるHTMLタグをエスケープする
date_format 日時、時刻の出力パターンを指定する

 修飾子で呼び出される関数のソースはlibs/pluginディレクトリに配置されており、ここに関数を作成することでSmartyのテンプレートで使用できる修飾子を任意で作成できます。サンプルではサイトの携帯対応の1つとしてPHPのmb_convert_kana関数を使用して全角英数字カナを半角英数字カナに変換する修飾子を作成します。

 mb_convert_kanaのオプションには次のようなものがあります。

mb_convert_kanaのオプション
オプション 意味
r 「全角」英字を「半角」に変換
R 「半角」英字を「全角」に変換
n 「全角」数字を「半角」に変換
N 「半角」数字を「全角」に変換
a 「全角」英数字を「半角」に変換
A 「半角」英数字を「全角」に変換
s 「全角」スペースを「半角」に変換
S 「半角」スペースを「全角」に変換
k 「全角片仮名」を「半角片仮名」に変換
K 「半角片仮名」を「全角片仮名」に変換
h 「全角ひら仮名」を「半角片仮名」に変換
H 「半角片仮名」を「全角ひら仮名」に変換
c 「全角かた仮名」を「全角ひら仮名」に変換
C 「全角ひら仮名」を「全角かた仮名」に変換

 今回は全角英数字カナを半角英数字カナに変換するので使用するオプションは「r」「n」「a」「k」になります。

 以上のことを踏まえて作成する修飾子のソースは次のようになります。

[リスト16]modifier.convert_z2h.php
function smarty_modifier_convert_z2h($string)
{
    if (function_exists("mb_convert_kana")) {
        $string = mb_convert_kana($string,"rnask", "UTF-8");
    }
    return $string;
}

 上記のコード内で「$string」で定義された変数が「|」の左側の値になります。作成した修飾子を利用するテンプレートは以下のようになります。

[リスト17]books_z2h.tpl(抜粋)
<tr><td>書籍名</td><td>発行日</td></tr>
{foreach from=$books key=k item=i}
    <tr><td>{$i.title|convert_z2h} </td><td>{$i.published}</td></tr>
{/foreach}

 作成した修飾子の確認のため、以下のSQLを実行して全角英数字カナのデータを作成しておきます。

[リスト18]books_z2h.php実行前のSQL
INSERT INTO `test`.`books` (`id` ,`title` ,`published_date`)
VALUES (NULL , 'abcde12345アイウエオ', '');
books_z2h.php実行結果
books_z2h.php実行結果

 books.php実行結果と比較、追加したデータを参照すると、全角英数字カナが半角英数字カナに変換されていることが分かります。


  • LINEで送る
  • このエントリーをはてなブックマークに追加

バックナンバー

連載:目的に応じて適材適所で使うPHPライブラリ

もっと読む

著者プロフィール

  • 山田 祥寛(ヤマダ ヨシヒロ)

    静岡県榛原町生まれ。一橋大学経済学部卒業後、NECにてシステム企画業務に携わるが、2003年4月に念願かなってフリーライターに転身。Microsoft MVP for ASP/ASP.NET。執筆コミュニティ「WINGSプロジェクト」代表。 主な著書に「入門シリーズ(サーバサイドAjax/XM...

  • WINGSプロジェクト 片渕 彼富(カタフチ カノトミ)

    <WINGSプロジェクトについて> 有限会社 WINGSプロジェクトが運営する、テクニカル執筆コミュニティ(代表 山田祥寛)。主にWeb開発分野の書籍/記事執筆、翻訳、講演等を幅広く手がける。2018年11月時点での登録メンバは55名で、現在も執筆メンバを募集中。興味のある方は、どしどし応募頂...

あなたにオススメ

All contents copyright © 2005-2021 Shoeisha Co., Ltd. All rights reserved. ver.1.5