mb_send_mail
(PHP 4 >= 4.0.6, PHP 5, PHP 7)
mb_send_mail — エンコード変換を行ってメールを送信する
説明
bool mb_send_mail
( string $to
, string $subject
, string $message
[, string $additional_headers
= NULL
[, string $additional_parameter
= NULL
]] )
パラメータ
-
to
-
送信先のメールアドレス。
各アドレスをカンマで区切ると、複数の宛先を
to
に指定できます。
このパラメータは、自動的にはエンコードされません。
-
subject
-
メールの件名。
-
message
-
メールの本文。
-
additional_headers
(オプション)
-
メールヘッダの最後に挿入される文字列。
通常、これは追加のヘッダ(From、Cc、Bcc)のために用いられます。
複数のヘッダを追加する場合は CRLF(\r\n)で区切ります。
Validate parameter not to be injected unwanted headers by attackers.
注意:
メールを送信する際には、必ず
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_parameter
-
additional_parameter
は、MTA へ渡す
コマンドライン引数です。sendmail を利用する際に正しい Return-Path
を設定するためなどに利用すると便利です。
このパラメータはコマンドの実行を防止するために内部的に escapeshellcmd()
によってエスケープされます。 escapeshellcmd() はコマンドの実行を防止しますが、
別のパラメータを追加することは許してしまいます。セキュリティ上の理由から、
このパラメータは検証されるべきです。
escapeshellcmd() が自動的に適用されるため、
インターネット RFC でメールアドレスとして許可さているいくつかの文字を使用することができません。
これらの文字を使用することが必須であるプログラムでは mail()
を使うことはできません。
この方法でエンベロープの sender ヘッダ(-f)を設定する際は、
'X-Warning' ヘッダが付加されないように Web サーバーの実行ユーザーを
sendmail 設定に追加しておく必要があるかもしれません。
sendmail を利用している場合、これは /etc/mail/trusted-users
で設定します。
返り値
成功した場合に TRUE
を、失敗した場合に FALSE
を返します。