NaifyMail

NaifyMailとは

メールの件名や宛先、本文の文字列結合がPHPコードの中に散らばると、文面の確認や修正のたびにプログラムを追うことになります。

NaifyMail（ナイフィメール）は、メールメッセージの組み立てと送信手段（Transfer）を切り分けて扱うパッケージです。<mail:subject>や<mail:body>などのタグを書いたテンプレート文字列をMessage::setTemplate()に渡すことで、件名・差出人・宛先・本文を1つのテンプレートファイル側でまとめて管理できます。

外部ライブラリに依存せず、SMTPソケット通信（STARTTLS・SSL・SMTP AUTH対応）、PHP標準のmail()関数、テスト用のコールバック送信を同じインターフェースで切り替えられます。

使い始めるには

起動処理でNaifyMail::boot()と送信手段（setTransfer()）を設定し、送信箇所でNaifyMail::createMessage()とNaifyMail::send()を呼び出します。コントローラやNaifyViewと組み合わせた実践的なコードはメール送信の実装例で確認できます。

use NaifyMail\NaifyMail;
use NaifyMail\Transfer\SmtpTransfer;

require __DIR__ . '/libs/NaifyMail/NaifyMail.php';
NaifyMail::boot();

// 1. 送信手段（Transfer）を設定する
NaifyMail::setTransfer(
    SmtpTransfer::create()
        ->server('smtp.example.com')
        ->port(587)
        ->tls()
        ->username('info@example.com')
        ->password('secret-password')
);

// 2. メッセージを組み立てて送信する
$message = NaifyMail::createMessage()
    ->setFrom('info@example.com', 'Naifyサポート')
    ->addTo('user@example.com', '山田 太郎 様')
    ->setSubject('お問い合わせを受け付けました')
    ->setBody("山田 太郎 様\n\nお問い合わせありがとうございます。");

NaifyMail::send($message);

メール本文の定義とTransfer設定

Message::setTemplate()を使うと、NaifyViewなどで描画したテンプレート文字列から件名・差出人・宛先・本文を一括で反映できます。

プレーンテキストメール（既定のtext/plain）では、テンプレートエンジン側で自動エスケープされたHTMLエンティティもsetTemplate()取り込み時にデコードされ、改行コードもRFC準拠のCRLFへ正規化されます。文字コードはUTF-8（既定）とISO-2022-JP（Mailer::ENCODING_JIS）に対応し、添付ファイル（addAttachment() / addAttachmentFromString()）がある場合は自動でマルチパート形式へ組み立てられます。

対応する範囲

主要クラス

普段の実装では、入口のNaifyMailと、メッセージを保持するMessage、送信方式を表す各Transferクラスを使います。