三方良しで勝つ江戸商人に学ぶ現代WEB戦略 - 今井政和

WEBディレクターが語る
ビジネス戦略　
今井政和 著
Amazonで販売中（¥500）
CodeQuest SEO - SEO診断ツール

あなたのサイトの
SEOを無料で即診断

PHPMailerの使い方｜Gmail・ConoHa・Xserver対応のメール送信をコピペで実装

カテゴリー: 上級 タグ: , ,

PHPMailerシリーズ一覧はこちら

「PHPMailerを使いたいけど、コードの書き方がよくわからない」 「Gmail経由で送信したいけど、エラーが出てしまう」

PHPMailerは、PHPで安全にメール送信するためのライブラリです。 PHP標準のmail()関数では対応しきれないSMTP認証・HTMLメール・添付ファイルなどを、シンプルなコードで実装できます。

この記事では、PHPMailerのインストールから実際のメール送信まで、コピペで使える完成コード付きで解説します。 Gmail・ConoHa WING・Xserverなど主要サーバーの設定例もすべて掲載しているので、自分の環境に合わせてすぐに使えます。

PHPMailerとは？mail()関数との違い

PHPMailer（ピーエイチピーメーラー）は、PHPでメールを送信するためのオープンソースライブラリです。 WordPress・Drupal・Joomla!など、世界中の主要CMSにも採用されています。

PHP標準のmail()関数でもメール送信は可能ですが、実務ではほぼ使われません。 その理由を比較表で確認してみましょう。

比較項目mail()関数PHPMailer
SMTP認証✕ 非対応◎ 対応
HTMLメール△ 手動でヘッダー設定が必要◎ isHTML(true)だけ
添付ファイル△ 複雑なMIME処理が必要◎ addAttachment()だけ
日本語対応△ 文字化けしやすい◎ UTF-8/base64で安定
SSL/TLS暗号化✕ 非対応◎ 対応
エラーハンドリング✕ true/falseのみ◎ 詳細なエラーメッセージ
Gmail送信✕ 不可◎ アプリパスワードで対応
迷惑メール対策△ スパム判定されやすい◎ SMTP認証で信頼性向上

特に重要なのがSMTP認証への対応です。 SMTP認証とは、メール送信時にサーバーに「自分は正規のユーザーですよ」と証明する仕組みのことです。 mail()関数ではこの認証ができないため、送信したメールが迷惑メールフォルダに振り分けられるリスクが高くなります。

PHPMailerのインストール方法

方法①：Composerを使う（推奨）

Composerは、PHPのライブラリ管理ツールです。 npmやpipのPHP版と考えるとわかりやすいでしょう。

ターミナルでプロジェクトのディレクトリに移動し、以下を実行します。

composer require phpmailer/phpmailer

インストール後、以下の1行でPHPMailerを使えるようになります。

require 'vendor/autoload.php';

方法②：手動で設置する（Composerが使えない場合）

レンタルサーバーなどComposerが使えない環境では、手動インストールも可能です。

手順：

  1. GitHubからダウンロード → PHPMailer公式リポジトリ
  2. src/フォルダから必要なファイルをプロジェクトに配置
  3. 以下の3行で読み込む
require_once 'path/to/PHPMailer/src/Exception.php';
require_once 'path/to/PHPMailer/src/PHPMailer.php';
require_once 'path/to/PHPMailer/src/SMTP.php';

注意： 手動インストールの場合、セキュリティアップデートは自分で管理する必要があります。 可能な限りComposerを使いましょう。

コピペで使える！基本のメール送信コード

以下は、PHPMailerでSMTPメール送信する最小構成のコードです。 // ← 変更の部分を自分の環境に書き換えるだけで動きます。

<?php
use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\Exception;

require 'vendor/autoload.php';

$mail = new PHPMailer(true);

try {
    // ===== SMTP設定 =====
    $mail->isSMTP();
    $mail->Host       = 'smtp.gmail.com';          // ← 変更：SMTPサーバー
    $mail->SMTPAuth   = true;
    $mail->Username   = 'your@gmail.com';           // ← 変更：メールアドレス
    $mail->Password   = 'xxxx xxxx xxxx xxxx';      // ← 変更：アプリパスワード
    $mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
    $mail->Port       = 587;

    // ===== 日本語対応 =====
    $mail->CharSet  = 'UTF-8';
    $mail->Encoding = 'base64';

    // ===== 送信元・送信先 =====
    $mail->setFrom('your@gmail.com', '送信者名');    // ← 変更
    $mail->addAddress('to@example.com', '受信者名'); // ← 変更

    // ===== メール内容 =====
    $mail->isHTML(false);                            // テキストメールの場合
    $mail->Subject = 'テストメール';
    $mail->Body    = 'PHPMailerからのテスト送信です。';

    $mail->send();
    echo 'メールが送信されました';

} catch (Exception $e) {
    echo "送信に失敗しました: {$mail->ErrorInfo}";
}

コードのポイント

new PHPMailer(true)のtrueとは？

例外処理（Exception）を有効にする設定です。 trueにしておくと、送信に失敗したときcatchブロックで詳細なエラーメッセージを取得できます。 デバッグ時に非常に便利なので、常にtrueにしておきましょう。

日本語の文字化け対策

以下の2行は日本語メールを送る場合に必須です。

$mail->CharSet  = 'UTF-8';
$mail->Encoding = 'base64';

CharSetで文字コードを、Encodingでエンコーディング方式を指定します。 この2行がないと、件名や本文の日本語が文字化けします。

サーバー別SMTP設定一覧

環境に合わせてHost・Port・SMTPSecure・認証情報を変更してください。

Gmail

$mail->Host       = 'smtp.gmail.com';
$mail->Username   = 'your@gmail.com';
$mail->Password   = 'アプリパスワード（16桁）';
$mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
$mail->Port       = 587;

Gmailで送信するための事前準備：

  1. Googleアカウントで2段階認証を有効化する
  2. Googleアカウント設定 → セキュリティ → 「アプリパスワード」を発行
  3. 発行された16桁のパスワードを$mail->Passwordに設定

重要： Googleアカウントの通常パスワードは使えません。必ず「アプリパスワード」を使ってください。

ConoHa WING

$mail->Host       = 'mail.yourdomain.com';  // 例：mail.codequest.work
$mail->Username   = 'info@yourdomain.com';
$mail->Password   = 'メールアカウントのパスワード';
$mail->SMTPSecure = PHPMailer::ENCRYPTION_SMTPS;
$mail->Port       = 465;

ConoHa WINGのコントロールパネル → メール管理 → メール設定 でSMTP情報を確認できます。

Xserver

$mail->Host       = 'sv●●●●.xserver.jp';   // サーバーパネルで確認
$mail->Username   = 'info@yourdomain.com';
$mail->Password   = 'メールアカウントのパスワード';
$mail->SMTPSecure = PHPMailer::ENCRYPTION_SMTPS;
$mail->Port       = 465;

Xserverのサーバーパネル → メールアカウント設定 でSMTP情報を確認できます。

さくらのレンタルサーバ

$mail->Host       = '初期ドメイン.sakura.ne.jp';
$mail->Username   = 'メールアドレス@初期ドメイン';
$mail->Password   = 'メールパスワード';
$mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
$mail->Port       = 587;

HTMLメール・添付ファイルの送信方法

HTMLメールを送る

$mail->isHTML(true);
$mail->Subject = 'HTMLメールのテスト';
$mail->Body    = '<h1>こんにちは</h1><p>HTMLメールのテスト送信です。</p>';
$mail->AltBody = 'こんにちは。HTMLメールのテスト送信です。';

AltBodyは、HTMLメールに対応していないメールクライアント向けのプレーンテキスト版です。 設定しなくても動きますが、設定しておくとメールの到達率が上がります。

添付ファイルを送る

// ファイルパスで添付
$mail->addAttachment('/path/to/file.pdf', '請求書.pdf');

// 複数ファイルも可能
$mail->addAttachment('/path/to/image.jpg', '写真.jpg');

CC・BCC・Reply-Toの設定

$mail->addCC('cc@example.com', 'CCの宛名');
$mail->addBCC('bcc@example.com');
$mail->addReplyTo('reply@example.com', '返信先の名前');

よくあるエラーと対処法

SMTP connect() failed

原因： SMTPサーバーへの接続に失敗しています。

確認ポイント：

  • Hostのサーバー名が正しいか
  • Port番号が正しいか（587 or 465）
  • SMTPSecureの暗号化方式がポートと一致しているか
  • サーバー側でSMTP接続がブロックされていないか

ポートと暗号化方式の正しい組み合わせは以下の通りです。

ポート暗号化方式PHPMailerの設定値
587STARTTLSPHPMailer::ENCRYPTION_STARTTLS
465SSL/TLSPHPMailer::ENCRYPTION_SMTPS

Could not authenticate

原因： 認証情報（ユーザー名・パスワード）が間違っています。

確認ポイント：

  • Usernameがメールアドレス全体（@以降も含む）になっているか
  • Passwordが正しいか
  • Gmailの場合：通常のGoogleパスワードではなく「アプリパスワード」を使っているか
  • Gmailの場合：2段階認証が有効になっているか

日本語が文字化けする

原因： 文字コードの設定が不足しています。

対処： 以下の2行が設定されているか確認してください。

$mail->CharSet  = 'UTF-8';
$mail->Encoding = 'base64';

PHPファイル自体の文字コードもUTF-8で保存されているか確認しましょう。

メールが迷惑メールフォルダに入る

原因： 送信元ドメインの信頼性が低い可能性があります。

対処：

  • SPFレコードを設定する（DNSに送信元サーバーのIPを登録）
  • DKIM署名を設定する（メールに電子署名を付与）
  • setFrom()に設定するメールアドレスのドメインと、実際のSMTPサーバーのドメインを一致させる

SPFレコードとは、「このドメインからのメール送信を許可するサーバーはこれです」とDNSに宣言する仕組みです。 DKIM署名とは、メールが送信途中で改ざんされていないことを証明する電子署名です。 どちらもレンタルサーバーのコントロールパネルから設定できることが多いので、確認してみてください。

デバッグモードを使う

エラーの原因が特定できない場合は、デバッグモードを有効にすると詳細なログが表示されます。

$mail->SMTPDebug = 2; // 0:無効 1:クライアント 2:クライアント+サーバー

本番環境では必ず0に戻してください。デバッグ情報にSMTP認証の詳細が含まれるため、そのまま公開するとセキュリティリスクになります。

セキュリティ対策

PHPMailerをお問い合わせフォームなどで使う場合、入力値のセキュリティ対策は必須です。 PHPMailer自体が安全でも、フォームから受け取った値をそのまま使うと攻撃の対象になります。

XSS（クロスサイトスクリプティング）対策

フォームから受け取った値は、必ずhtmlspecialchars()でエスケープ処理します。

$name = htmlspecialchars($_POST['name'], ENT_QUOTES, 'UTF-8');

XSSとは、悪意のあるスクリプト（JavaScriptなど）をフォーム経由で埋め込む攻撃です。 エスケープしないと、入力された<script>タグがそのまま実行される危険があります。

メールヘッダーインジェクション対策

メールの宛先や件名に改行文字が含まれていると、意図しない宛先にメールが送信される可能性があります。

$email = str_replace(["\r", "\n"], '', $_POST['email']);
$email = filter_var($email, FILTER_VALIDATE_EMAIL);

バリデーション（入力チェック）

// 空チェック
if (empty($_POST['name']) || empty($_POST['email'])) {
    die('名前とメールアドレスは必須です');
}

// メールアドレスの形式チェック
$email = filter_var($_POST['email'], FILTER_VALIDATE_EMAIL);
if (!$email) {
    die('有効なメールアドレスを入力してください');
}

SMTP認証情報の管理

パスワードをコード内に直書きするのは避け、環境変数や設定ファイルで管理しましょう。

// .envファイルや設定ファイルから読み込む例
$mail->Username = getenv('SMTP_USER');
$mail->Password = getenv('SMTP_PASS');

.envファイルを使う場合は、Webからアクセスできない場所に配置するか、.htaccessでアクセスを禁止してください。

よくある質問（FAQ）

Q. PHPMailerは無料で使えますか？

はい、MITライセンスで完全無料です。個人サイトでも商用サイトでも、制限なく使用できます。

Q. PHPのバージョンに制限はありますか？

PHPMailer 6.x はPHP 5.5以上が必要です。セキュリティの観点から、PHP 8.0以上の使用を推奨します。

Q. mail()関数とPHPMailerのどちらを使うべきですか？

実務ではPHPMailer一択です。mail()関数はSMTP認証に対応しておらず、送信したメールが迷惑メールに振り分けられるリスクが高いためです。

Q. WordPressでもPHPMailerは使えますか？

WordPressには標準でPHPMailerが組み込まれています。ただし、テーマやプラグインのカスタマイズで直接使う場合は、WordPress標準のwp_mail()関数経由で使うのが推奨されます。

Q. 送信数に制限はありますか？

PHPMailer自体に制限はありませんが、SMTPサーバー側に送信数の制限があります。Gmailの場合、1日あたり500通が上限です（Google Workspaceは2,000通）。大量送信が必要な場合は、SendGridやAmazon SESなどの専用サービスを検討してください。

Q. ローカル環境でテスト送信したい場合は？

Mailtrapなどのメール送信テストサービスを使うのがおすすめです。実際のメールアドレスに送信せずに、メールの内容や表示を確認できます。

まとめ

PHPMailerは、PHPでメール送信するなら最初に覚えるべきライブラリです。 この記事で紹介した基本構成をベースに、自分の環境に合わせた設定を行ってください。

この記事のポイント：

  • PHPMailerはmail()関数より安全で機能が豊富
  • Composerでインストールするのが最も簡単
  • 日本語メールにはCharSet = 'UTF-8'とEncoding = 'base64'が必須
  • Gmail送信には2段階認証＋アプリパスワードが必要
  • フォーム連携時はXSS・ヘッダーインジェクション対策を忘れずに

実際にお問い合わせフォームと組み合わせる方法は、以下の記事で詳しく解説しています。

▶ PHPMailerで安全にメール送信【Gmail対応コード例＋SMTP認証】

▶ PHPで作るお問い合わせフォーム｜確認画面＆メール送信付き

カテゴリー: 上級 タグ: , ,