symfonyの携帯絵文字プラグインを作りました。
こんにちは、亀本です。
最近はあつまろ☆ねっとで携帯のことをあれこれやっているのもあって、携帯回りの事に妙に詳しくなってきました。
あつまろ☆ねっとは携帯向けの掲示板とメーリスを備 たサイトとして考案していたので、必然的に絵文字周りは
・HTMLコーディング時の容易な入力
・最低3キャリアの絵文字相互変換
・auからのメール絵文字の解析
等が必要とされることになり、やっぱしっかり作らないとだめだなぁ、と思ってあつまろ☆ねっと開発の傍らで絵文字ライブラリの作成を行っていました。
で。。。最初は普通のライブラリとして作成していたんですが
( ﾟдﾟ) > 他にも似たようなのあるだろうから、symfonyプラグインにすりゃいんじゃね？
という何処からともなく湧き出た声に従って、symfonyのプラグインとして実装してみました。
前からずーーーと作りかけのものが放置プレイ状態になっていたんですが、きっかけもあって一通りプラグインとして用をなすところまで作りました。
ファイルはこちら:
sfPictogramMobilePlugin-0.0.1.tgz
バージョンがやたらと低いですが、エラー処理とかテストがないとか、そういうもろもろがあるので0.0.1で行きました。
動作自体は、それなりにちゃんと動きます。
インストールは、symfonyのプロジェクトルートで
symfony plugin-install http://blog.asial.co.jp/data/sfPictogramMobilePlugin-0.0.1.tgz
としてください。
あとは、使用したい任意の場所でfactoryメソッドを使って
$picObject = sfPictogrmMobile::factory($carrier, $type);
としてやれば、$carrierで指定した携帯キャリアの絵文字オブジェクトが得られます。
$typeというのは、この絵文字オブジェクトで利用する携帯絵文字の'sjis'などの文字コードの種類です。これらはそれぞれ、
- $carrier
--- $type
- 'docomo'
--- 'sjis'
--- 'utf-8'
- 'ezweb'
--- 'sjis'
--- 'utf-8'
--- 'jis-email'
- 'softbank'
--- 'sjis'
--- 'utf-8'
という値をとることができます。それぞれの値の意味は・・・わかってください（＾＾；
一応、使用する際の想定としてはNet_UserAgentMobileなどでキャリア判定を行うことを前提に考えているので、今のところ自前での判定機能は持っていません。
で、機能の説明をしておくと、このsfPictogramMobileには大別して２つの機能があって
・絵文字バイナリを丸ごと取得(テンプレート作成用)
・絵文字データ変換(ユーザ投稿データ解析用)
の２つがあります。
まず前者ですが、これは上述のように取得した絵文字オブジェクトを
$emoji = $picObject->getFormattedPictogramsArray();
とすると、DoCoMoの絵文字番号をキーにした各キャリアの絵文字データが取得できます。
どんな対照表になるかは、DoCoMoの絵文字変換対照表を参照してください。これの左はじの番号がキーになります。
====
追記：リンク切れしていました。
新しいDoCoMoの絵文字変換対照表はこちら
あとは、これをtemplate側に引き渡して
<?= $data->emoji[1] ?>
みたいに指定してやれば、picObject生成時に指定した各キャリアの絵文字が表示されます。
自分がテンプレートを作成するときに、うーん各キャリア毎にいちいち一覧表見たり、絵文字選んだり、&#XXXXXX;なんて入力する値調べたりするのめんどくせええええええ＞＜、と思ったので、こういう実装になりました。
こうすると、３枚のテンプレートを作成することになるのは避けられないにせよ、絵文字を統一的に(しかも直感的にわかりやすい番号で)扱えるので、煩雑な入力作業が減らせます。
ちなみに、getFormatttedPictogramsArrayメソッド(我ながら長いネーミング(＾＾；)の引数にキャリア名を与えてやれば、キーにするキャリアを変更することができます。
// たとえば。。。こうするとezwebの表に従った絵文字データが返ってくる。
$emoji = $picObject->getFormattedPictogramsArray('ezweb');
そのため、この引数もキャリア判定に従って切り替えてあげれば、それぞれのキャリアを別々に扱うことができるので、好きな方を選んでもらえればよいかと思います。
===============
次に、絵文字のデータ変換ですが、現在のところ各キャリアのShift_JIS、UTF-8と、auメールのISO-2022-JPに対応しています。
使い方なんですが、Shift_JIS・ISO-2022-JPとUTF-8でちょっとだけ違います。
一応、これには理由があるです が、それは後ほど。
Shift_JISおよびISO-2022-JP(auのemail受信のみ)を扱う場合には、
データ入力時にconvertメソッドを、データを引き出して表示するときにrestoreメソッドを使います。
$convert_data = $picObject->convert($input_data);
$view_data = $picObject->restore($convert_data);
これはそれぞれ、convertメソッドでShift_JISおよびISO-2022の絵文字を内部用の識別コードに置き換え、restoreメソッドで各キャリアの絵文字に復元しています。
なお、内部コードに直しているという性質上、データベースなどに格納する場合には実際の文字数よりも多くの文字数が必要になってしまうので、注意してください。
次に、UTF-8の場合の使用方ですが、これはもっと容易でデータ入力時には特に何もせず、データを引き出して表示する際にreplaceメソッドを使います。
$view_data = $picObject->replace($input_data);
なぜデータ入力時には何もする必要がないかというと、各キャリアのUTF-8の定義領域に理由があります。
UTF-8の絵文字定義領域は、３キャリアともUnicodeの私的領域にそれぞれがかぶらないように定義されているため、UTF-8で保存をする場合には特別な工夫を凝らす必要はありません。
正確には、auとSoftBankは公式発表ではかぶりがあるのですが、ありがたい事にauが内部的に使っている絵文字コードがこの重複を回避する領域に存在しています。
そのため、絵文字の文字コードを解析するだけでどのキャリアの何の絵文字なのかを判別できるので、表示の際に１度だけ切り換えてやれば話が済みます。
UTF-8とShift_JISの使い方が違うのは、この使い勝手を優先したことと、技術ブログを各時間がもうそろそろタイムリミットになったこと。。。orz
なので、そのうちUTF-8でもShift_JISのような内部コードへ直す形式のサポートや、入力側をヘルパーとして整備する、などなど追加していきたいと思います。
==========
実際のところ、このライブラリはあつまろ☆ねっとの作成から派生したので、動作サンプルはあつまろ☆ねっとを見てもらう方が手っ取り早いです。メールとか。
ただ、あつまろ☆ねっとで使用しているものから内部仕様もかなり大きく書き換えたので、もしかすると逆に変な動作しちゃうところがあるかも。。バージョンダウン（汗
なお、symfonyのプラグインと銘打ってはいますが、今のところException以外はsymfonyに依存していませんので、Exception周りを書き換えてlibの中をひととおりrequireすれば、symfony以外でも特に問題なく使用できます。
まぁ、たぶん車輪の再発名だったりもすると思いますが、symfonyで使えるプラグインということで、ぜひご活用ください。
