デコメールまとめ

2008/08/28 未分類 spok
Qdmailのデコメールに関する情報をまとめました。
Qdmailとは、PHPのマルチバイト環境（特に日本語）にて、「文字化けしない」「簡単に"デコメ（デコメール）"やHTMLメール等の電子メールを送信することができる」メールクラスライブラリです。文字化け完全制覇を目指しています。
CakePHPのコンポーネントとしても動作可能です。

Qdmailの特徴（デコメ関連）

Qdmail使用例

Qdmailを使ったデコメテンプレート変換サービス（作者のサイトです）
サンプルコード

予備知識

デコメは、大きく分けてドコモ系、au系、ソフトバンク系にわかれます。ディズニー携帯、イーモバイル、Willcomは、ソフトバンクとほぼ同じです。
Qdmailはこれらの違いを吸収し、どのキャリアに送るのでも、同じソースコードで送信することができます。

参考：デコメール携帯4社MIMEマルチパート比較
コメント（2件）

デコメテンプレートで送信する。端末シミュレート

2008/08/27 未分類 spok
Qdmail 1.0.7b以降ではQdmailReceiverと組み合わせることで、デコメテンプレート形式のデータをデコメとして送信することができます。つまり、携帯端末のシミュレートをすることができます。自分で作成したデコメテンプレートが正常にデコードされるかどうのテスト等に使えます。もしくは、ネットで拾ったデコメテンプレートがどんなものかを自分宛に送信してみるのもよいでしょう。

サンプルコード

qd_mail_receiver.phpは、インクルードパスの通った場所に配置しておいてください。Qdmailが自動で読み込みます。もし、自動読み込みがうまく行かない場合には、明示的に、qd_mail_receiver.phpファイルをインクルードしてください。
サンプル
$to ="address@exmaple.com";
$template_filename = 'docomo4_0.dmt';
$template = file_get_contents($template_filename);
qd_send_mail('DecoTemplate',$to,'テンプレートテスト',$template,'from@example.com');
これでドコモのデコメテンプレートの内容をいったんデコードした上で、address@exmaple.comにデコメールを送信します。
qd_send_mail('DecoTemplate',$to,'テンプレートテスト',$template,'from@example.com');
の代わりに
$mail -> easyDecoTemplate($to,'テンプレートテスト',$template,'from@example.com');
でも、構いません。
コメント（0件）

デコメテンプレート作成（変換）機能

2008/08/27 未分類 spok
QdmailReceiverとQdmail（1.07b以降）を組み合わせると、ドコモのテンプレートからauのテンプレート等、各キャリアに合わせたテンプレートに変換することができます。その上に、テンプレートではなく、デコメそのものからデコメテンプレートを抽出したり、MHTLメール（インラインHTML）から、各キャリアのデコメのテンプレートを作成することができます。

変換バリエーション

変換元
Docomo,au,Softbankのデコメテンプレート。インラインHTMLメール(MHTML)。通常のHTMLメール。テキストメール
　　　↓
変換先
Docomo,au,Softbankの各デコメテンプレート

解説

内部的には、QdmailReceiverを利用して、変換元のメールをデコードして、Qdmail形式の配列に変換します。
それでもって、Qdmailのメール作成機能を援用して、各キャリアに適合したデコメテンプレートを作成します。

サンプルコード

$mailには、Qdmailのインスタンスが入っているものとします。
qd_mail_receiver.phpをインクルードパスが通っているディレクトリに配置しておいてください。Qdmailが自動的に読み込みます。自動読み込みがうまくいかない場合は、
include('qd_mail_receiver.php');
として明示的に読み込んで下さい。
$file には、デコメテンプレートのパス＆ファイル名が入っているものとします。
サンプルコード(ドコモテンプレートからauテンプレートへの変換)
$file = 'templatefile.dmt';
$mail = & new Qdmail();
$content = file_get_contents($file);
$au_template = $mail -> makeDecoTemplate('TPL_AU',$content);
PHP5では、newの前の & は必要ありません。

第1引数は以下の選択肢があります。
'TPL_DC'ドコモ用テンプレート
'TPL_AU'au用テンプレート
'TPL_SB'SoftbankMobile用テンプレート
$contentの中身は、どんなキャリアのテンプレートでも大丈夫です。
テンプレートでなくても、メールそのものでも大丈夫です。その場合は、ヘッダーも含めたメール全データをぶち込んで下さい。

この機能を使ったサービス例

デコメ→3種テンプレート変換
コメント（3件）