Qdmail - PHP::Mail Library , Quick and Detailed for Multibyte

PHPメール送信には主に3通り

1. PHPのmail関数
2. PHP設置サーバーのsendmailを直接操作
3. 他のSMTPサーバーから送信

QdmailをSMTP通信で利用するには

サンプルコード

SMTP認証の場合

require_once('qdmail.php');

$mail = & new Qdmail();

$mail -> smtp(true);

$param = array(
    'host'=>'smtp.example.com',//メールサーバー
    'port'=> 587 , //これはSMTPAuthの例。認証が必要ないなら　25　でＯＫ。
    'from'=>'from@example.com',　//　Return-path: になります。
    'protocol'=>'SMTP_AUTH',// 認証が必要ないなら、'SMTP'
    'user'=>'user_id@example.com', //SMTPサーバーのユーザーID
    'pass' => 'sasuga99', //SMTPサーバーの認証パスワード
);
$mail -> smtpServer($param);

$message="メールの中身をここに書きます。";

$mail ->to('toaddress@example.com','スポック宛');
$mail ->subject('メールのテスト');
$mail ->from('from@example.com');
$mail ->text($message);
$return_flag = $mail ->send();

注

2008-10-01追記
下記、サイトにてスマートなCakePHPでのQdmailの使い方を紹介していただいております。ぜひご参照下さい。
cakePHP メール送信はもうこれでいいでしょ -LoveIT - 安江ブログ

使い方（初期設定）

app/controllers/components/

var $components=array( "Qdmail" );

具体的なメール送信の方法

$this->Qdmail->to( 'address@example.com' , '日本語名' );
$this->Qdmail->subject('Qdmail on CakePHP メールのテスト');
$this->Qdmail->from('from@example.com' , '配信元日本語名' );
$this->Qdmail -> text( '本文をここにかきます' );
$this->Qdmail -> send();

CakePHPのビューを使用する方法

$this->Qdmail -> cakeText( '本文（テキスト）' );
or
$this->Qdmail -> cakeHtml( '本文（HTML）' );

ビューの指定の方法

$this->Qdmail -> cakeText( '本文' ,'エレメント名','レイアウト名');

cakeText( $content , $template  , $layout  , $org_charset , $target_charset, $enc , $wordwrap_length )

第1引数から、本文、テンプレート名、レイアウト名、テンプレートの文字コード（省略可、またはnull),送信時の文字コード（省略可、またはnull)、本文のエンコード形式(7bit,base64等）、ワードラップの文字数（マルチバイト換算）

エレメントとレイアウトのディレクトリ

エレメントの既定のディレクトリ

app/views/elements/email/text/
app/views/elements/email/html/

レイアウトの既定のディレクトリ

app/views/layouts/email/text/
app/views/layouts/email/html/

概要

特徴

• CakePHP1.1 , 1.2 の両方に対応
• 同じファイルで、通常の使い方もOK,CakePHPもＯＫ（自動判別）
• CakePHPの強力なrender機能を使用可能

ライセンス

個別アドレス分離機能（一斉送信時）

例

$mail = & new Qdmail() ;　*1

$to = array( 'address1@example.com' , 'address2@example.com' , 'address3@example.com' , 'address4@example.com' );

$mail -> to( $to );

$mail -> subject( '個別アドレス分離機能テスト' );
$mail -> from('from@example.com','配信元表記');

$mail ->text( 'このメールは1通ずつ配信されています' );

$mail -> toSeparate( true );

$mail ->send();

注意

個別アドレス分離機能をＯＮにした場合、cc,bccにセットしたメールアドレスは無視されます。

インテリジェント・ワードラップとは？

• 特定行の折り返し禁止設定
  （http等の特定の文字列を含む列を自動判別し、その行は折り返さない機能）
• 禁則処理（行頭、行末）
  句読点や括弧など、行頭や行末にふさわしくない文字の例外処理。
• 「文字列の幅」での折り返し
  文字数でなく、全角１、半角0.5と計算して、幅を同じにする機能。

Qdmailが改行しなくても、送信サーバーが強制的に改行することがある。

特定行の折り返し禁止設定

http://example.com/hogehoge/user/hoge/?id=12345678&hash=ek53k8eHhi5kQxJ53LO(改行)
pejDrQC85KdeqpldgghjkRtyrwuy

http://example.com/hogehoge/user/hoge/?id=12345678&hash=ek53k8eHhi5kQxJ53LOpejDrQC85KdeqpldgghjkRtyrwuy

  $mail -> wrapExcept( array(
     '除外ワード'  => 行頭フラグ,
　 　　・・・・・
  ) );

array(  'http://'  =>  false  ,  'code'  =>  true )

$mail -> wrapExcept( array() );

禁則処理

$mail -> wrapProhibitTop('禁則文字');

行頭
,.;:–?!‼、。．)）]}｝〕〉》」』】〙〗〟’”»ヽヾーァィゥェォッャュョヮヵヶぁぃぅぇぉっゃゅょゎ‐～？！

行末
（([{｛〔〈《「『【〘〖‘“« 

$mail -> wrapProhibitAllow( false );

文字列の幅でのワードラップ（折り返し）

1. インターネットメールでの文字数制限（半角75文字以内推奨、1,000文字以内絶対）
2. 読みやすさの向上

$mail -> wrapWidth( false );　*2

折り返し幅の変更

$mail -> wordwrapLength( 30 );　*3

ワードラップの無効化

$mail -> wordwrapAllow( false );

$mail -> mbStrwidthMagni( n );