メールを送信する

説明

bool mail ( string $to , string $subject , string $message [, string $additional_headers [, string $additional_parameters ]] )

メールを送信します。

パラメータ

to

メールの受信者。

» RFC 2822 を満たす書式でなければなりません。例えば以下のようなものです。

[email protected]
[email protected], [email protected]
User <[email protected]>
User <[email protected]>, Another User <[email protected]>

subject

送信するメールの表題。

警告

表題は » RFC 2047 を満たすものでなければなりません。

message

送信するメッセージ。

改行コードは CRLF (\r\n) となります。各行の長さは 70 文字を超えてはいけません。

警告

（Windows のみ）PHP が SMTP サーバーと直接通信をする際、ピリオドから始まる行は無視されます。これを防ぐには、行頭のピリオドをピリオド 2 つに置き換えてください。


<?php
$text = str_replace("\n.", "\n..", $text);
?>

additional_headers（オプション）

メールヘッダの最後に挿入される文字列。

通常、これは追加のヘッダ（From、Cc、Bcc）のために用いられます。複数のヘッダを追加する場合は CRLF（\r\n）で区切ります。 If outside data are used to compose this header, the data should be sanitized so that no unwanted headers could be injected.

注意:
メールを送信する際には、必ず From ヘッダが含まれていなければなりません。 additional_headers パラメータで指定するか、あるいは php.ini にデフォルト値を指定します。

指定しなかった場合は、以下のようなエラーメッセージが返ります Warning: mail(): "sendmail_from" not set in php.ini or custom "From:" header missing 。 Windows では、From ヘッダを設定すると Return-Path も設定されます。

注意:
メッセージが受信されなかった場合には、LF（\n）のみを使ってみてください。 Unix の MTA の中には、自動的に LF を CRLF に変換してしまうもの (有名なところでは、» qmail など) があります（もし CRLF を利用していた場合、CR が重複してしまいます）。ただし、これは最後の手段です。というのも、これは » RFC 2822 に違反しているからです。

additional_parameters（オプション）

パラメータ additional_parameters は、追加のフラグをコマンドラインオプションとしてメール送信プログラムに渡す際に使用可能です。メール送信プログラムは、設定オプション sendmail_path により設定されます。例えば、 sendmail を使用する際に -f オプションを使ってエンベロープの sender アドレスを設定する際に使用できます。

This parameter is escaped by escapeshellcmd() internally to prevent command execution. escapeshellcmd() prevents command execution, but allows to add addtional parameters. For security reasons, it is recommended for the user to sanitize this parameter to avoid adding unwanted parameters to the shell command.

Since escapeshellcmd() is applied automatically, some characters that are allowed as email addresses by internet RFCs cannot be used. mail() can not allow such characters, so in programs where the use of such characters is required, alternative means of sending emails (such as using a framework or a library) is recommended.

この方法でエンベロープの sender ヘッダ（-f）を設定する際は、 'X-Warning' ヘッダが付加されないように Web サーバーの実行ユーザーを sendmail 設定に追加しておく必要があるかもしれません。 sendmail を利用している場合、これは /etc/mail/trusted-users で設定します。

返り値

メール送信が受け入れられた場合に TRUE 、それ以外の場合に FALSE を返します。

メールの配送が受け入れられたかどうかが基準であることに注意しましょう。メールが実際にあて先に届いたかどうかでは「ありません」。

変更履歴

バージョン	説明
4.3.0（Windows のみ）	すべてのカスタムヘッダ（From、Cc、Bcc や Date など）がサポートされるようになり、大文字・小文字を区別しないようになりました（カスタムヘッダは MTA でパースされるのではなく PHP でパースされます。 PHP < 4.3 では Cc ヘッダのみがサポートされており、大文字・小文字が区別されていました）。
4.2.3	safe_mode 時には `additional_parameters` パラメータを無効にしました。もし用いられた場合には mail() 関数は警告メッセージを出して `FALSE` を返します。
4.0.5	`additional_parameters` パラメータが追加されました。

例

例1 メールを送信する

mail() を用いて単純なメールを送信する。


<?php
// 本文
$message = "Line 1\r\nLine 2\r\nLine 3";

// 1 行が 70 文字を超える場合のため、wordwrap() を用いる
$message = wordwrap($message, 70, "\r\n");

// 送信する
mail('[email protected]', 'My Subject', $message);
?>

例2 追加ヘッダを付加してメールを送信する

基本ヘッダに加え、MUA に From および Reply-To アドレスを通知する。


<?php
$to      = '[email protected]';
$subject = 'the subject';
$message = 'hello';
$headers = 'From: [email protected]' . "\r\n" .
    'Reply-To: [email protected]' . "\r\n" .
    'X-Mailer: PHP/' . phpversion();

mail($to, $subject, $message, $headers);
?>

例3 追加ヘッダ及び追加コマンドラインパラメータを指定してメールを送信する

sendmail_path を用いてメールを送信する際に利用する追加パラメータとして、additional_parameters が用いられます。


<?php
mail('[email protected]', 'the subject', 'the message', null,
   '[email protected]');
?>

例4 HTML メールを送信する

mail() を用いて HTML メールを送信することも可能です。


<?php
// 複数の受信者を指定
$to  = '[email protected]' . ', '; // カンマに注意
$to .= '[email protected]';

// 表題
$subject = 'Birthday Reminders for August';

// 本文
$message = '
<html>
<head>
  <title>Birthday Reminders for August</title>
</head>
<body>
  <p>Here are the birthdays upcoming in August!</p>
  <table>
    <tr>
      <th>Person</th><th>Day</th><th>Month</th><th>Year</th>
    </tr>
    <tr>
      <td>Joe</td><td>3rd</td><td>August</td><td>1970</td>
    </tr>
    <tr>
      <td>Sally</td><td>17th</td><td>August</td><td>1973</td>
    </tr>
  </table>
</body>
</html>
';

// HTML メールを送信するには Content-type ヘッダが必須
$headers  = 'MIME-Version: 1.0' . "\r\n";
$headers .= 'Content-type: text/html; charset=iso-8859-1' . "\r\n";

// 追加のヘッダ
$headers .= 'To: Mary <[email protected]>, Kelly <[email protected]>' . "\r\n";
$headers .= 'From: Birthday Reminder <[email protected]>' . "\r\n";
$headers .= 'Cc: [email protected]' . "\r\n";
$headers .= 'Bcc: [email protected]' . "\r\n";

// 送信する
mail($to, $subject, $message, $headers);
?>

注意:
HTML などの複雑な形式のメールを送信する場合は、PEAR パッケージ » PEAR::Mail_Mime を利用することを推奨します。

注意

注意:
mail() の Windows 版実装は、Unix 版実装とは多くの点で違います。第一に、メッセージの生成にローカルのバイナリは使用せず、ソケットを通じて直接操作するだけです。これは MTA がネットワークソケットを listen している必要があるということを意味します（ローカルホスト、リモートマシンどちらでもかまいません）。

第二に、 From: や Cc:・ Bcc:・ Date: のようなカスタムヘッダは MTA ではなく PHP によってパースされます。

そのため、to 引数には "Something <[email protected]>" 形式のメールアドレスを与えることはできません。 MTA と通信する際に mail コマンドはこれを適切にパースできません。

注意:
mail() 関数は、大量のメールをループ内で送信するには向いていないことに注意しましょう。この関数は 1 通のメールを送信するたびに SMTP ソケットをいったん閉じて開きなおします。これは非効率的です。

大量のメールを送信する場合は、 » PEAR::Mail および » PEAR::Mail_Queue パッケージを参照ください。

注意:
以下の RFC も有用です。 » RFC 1896、 » RFC 2045、 » RFC 2046、 » RFC 2047、 » RFC 2048、 » RFC 2049 および » RFC 2822

参考

imap_mail() - e-mail メッセージを送信する
» PEAR::Mail
» PEAR::Mail_Mime