読み込み中...

5ステップでマスター！PHPメール送信のためのSMTP設定ガイド

PHPを用いたSMTPメール送信設定のガイドイメージ PHP
2023.05.24
この記事は約6分で読めます。

【サイト内のコードはご自由に個人利用・商用利用いただけます】

この記事では、プログラムの基礎知識を前提に話を進めています。

説明のためのコードや、サンプルコードもありますので、もちろん初心者でも理解できるように表現してあります。

本記事のサンプルコードを活用して機能追加、目的を達成できるように作ってありますので、是非ご活用ください。

※この記事は、一般的にプロフェッショナルの指標とされる『実務経験10,000時間以上』を満たす現役のプログラマチームによって監修されています。

※Japanシーモアは、常に解説内容のわかりやすさや記事の品質に注力しております。不具合、分かりにくい説明や不適切な表現、動かないコードなど気になることがございましたら、記事の品質向上の為にお問い合わせフォームにてご共有いただけますと幸いです。
(送信された情報は、プライバシーポリシーのもと、厳正に取扱い、処分させていただきます。)

はじめに

この記事を読めば、PHPでメール送信をするためのSMTP設定についての基本的な知識と手順を理解できるようになります。

メール送信のサンプルコードやカスタマイズ方法も紹介しますので、初心者でも簡単に始められます。

●PHPによるメール送信とは

PHPはウェブサイト制作に広く使われるサーバーサイドのプログラミング言語です。

PHPを使用してメールを送信するためには、SMTP(Simple Mail Transfer Protocol)というメール送信のためのプロトコルの設定が必要になります。

●SMTP設定方法の基本

SMTPの設定は少々複雑に感じるかもしれませんが、必要なステップを一つずつ踏むことで、初心者でも簡単に設定できます。

SMTP設定を行うための基本的なステップを見ていきましょう。

○サンプルコード1：PHPによるSMTP設定

SMTP設定を行うためには、まずメールサーバーへの接続情報が必要です。

これにはメールサーバーのホスト名、ポート番号、ユーザー名、パスワードが含まれます。

<?php
// PHPMailerを読み込む
require 'PHPMailerAutoload.php';

$mail = new PHPMailer;

// SMTP設定
$mail->isSMTP();                                     
$mail->Host = 'smtp.example.com';                    
$mail->SMTPAuth = true;                             
$mail->Username = 'user@example.com';                
$mail->Password = 'secret';                           
$mail->SMTPSecure = 'tls';                           
$mail->Port = 587;                                    

?>

このコードでは、PHPMailerというライブラリを使用してSMTPを設定しています。

PHPMailerを読み込んだ後、SMTP設定を行っています。

ここでは、SMTPサーバーのホスト名、SMTP認証、ユーザー名、パスワード、SMTPSecure（通信の暗号化方法）、ポート番号を設定しています。

○サンプルコード2：メール送信のサンプルコード

SMTPの設定が完了したら、次にメールを送信するためのコードを見ていきましょう。

<?php
// メール設定
$mail->setFrom('from@example.com', 'Mailer');
$mail->addAddress('joe@example.net', 'Joe User');    
$mail->addReplyTo('info@example.com', 'Information');
$mail->isHTML(true);                                 

// メール内容
$mail->Subject = 'Here is the subject';
$mail->Body    = 'This is the HTML message body';
$mail->AltBody = 'This is the body in plain text for non-HTML mail clients';

// メール送信
if(!$mail->send()) {
    echo 'Message could not be sent.';
    echo 'Mailer Error: ' . $mail->ErrorInfo;
} else {
    echo 'Message has been sent';
}
?>

このコードでは、メールの送信元、宛先、返信先、HTML形式の使用、メールの件名、本文、プレーンテキスト形式の本文を設定しています。

そして、最後にメールを送信するコードを実行しています。メールの送信に成功した場合と失敗した場合の処理も記述しています。

●注意点と対処法

PHPによるメール送信では、特に注意が必要な点がいくつかあります。

その一つがエラーハンドリングです。

SMTPサーバーへの接続が失敗した場合や、メールの送信が失敗した場合など、エラーが発生した際の処理をきちんと行うことが重要です。

○サンプルコード3：エラーハンドリングの例

このコードでは、まずSMTPDebugを2に設定しています。

これは、デバッグ出力のレベルを指定するもので、2はメッセージとエラーを表示します。

その後、メール送信処理をtry-catchブロックで囲み、エラーが発生した際の処理を記述しています。

<?php
// PHPMailerの例外をキャッチ
$mail->SMTPDebug = 2;   
try {
    if(!$mail->send()) {
        echo 'Mailer Error: ' . $mail->ErrorInfo;
    } else {
        echo 'Message has been sent';
    }
} catch (phpmailerException $e) {
    echo $e->errorMessage(); // PHPMailerのエラーメッセージを表示
} catch (Exception $e) {
    echo $e->getMessage(); // その他のエラーメッセージを表示
}
?>

●カスタマイズ方法

基本的なメール送信ができるようになったら、次はそれをカスタマイズしていきましょう。

例えば、メールのヘッダー情報をカスタマイズしたり、HTML形式のメールを送信したりすることができます。

○サンプルコード4：ヘッダー情報のカスタマイズ

このコードでは、CC（カーボンコピー）、BCC（ブラインドカーボンコピー）、添付ファイルを追加する方法を示しています。

これにより、メールの送信先を追加したり、ファイルを添付したりすることが可能になります。

<?php
$mail->addCC('cc@example.com');
$mail->addBCC('bcc@example.com');
$mail->addAttachment('/var/tmp/file.tar.gz');        
$mail->addAttachment('/tmp/image.jpg', 'new.jpg');   
?>

○サンプルコード5：HTML形式のメール送信

このコードでは、HTML形式でメールを送信する方法を示しています。

HTMLを使うことで、テキストだけでなく、リンクや画像、テーブルなどもメール本文に含めることができます。

<?php
$mail->isHTML(true);                              
$mail->Subject = 'Here is the subject';
$mail->Body    = '<b>This is the HTML message body</b>';
$mail->AltBody = 'This is the body in plain text for non-HTML mail clients';
?>

まとめ

PHPでメール送信を行うには、まずSMTP設定を行い、その上でメール送信のコードを書く必要があります。

そして、エラーハンドリングをきちんと行うことで、エラーが発生した際に適切な対応ができます。

最後に、カスタマイズを行うことで、自分のニーズに合わせたメールを送信することが可能になります。