Tech
Contact Form 7の自動返信メールにPDFを添付する方法|
添付されない原因と対処
Contact Form 7(CF7)の自動返信メールに資料PDFを添付する手順を解説。
メール(2)の添付ファイル欄はwp-content基準で書くこと、メールは届くのに添付だけ消える原因、25MBの容量上限、選択内容でPDFを出し分ける方法まで6.2.3の実コードで検証しています。
「資料請求フォームから送信してもらったら、会社案内のPDFを自動で返したい」という要件は、問い合わせフォームの定番です。
Contact Form 7 は標準でメールに添付ファイルを付けられるので、プラグインを増やさずに実現できます。
ところが実際にやってみると、メールは届くのに添付だけ付いてこないという詰まり方をします。
しかも画面にはエラーが出ません。
原因はほぼ1点で、添付ファイル欄に書くパスの基準が「WordPressのルート」ではなく「wp-content」だからです。
本記事は 6.2.3 の配布zipを取得して実コードを読み、PHP 8.3.6 で実際にパス解決を動かして確認した内容です。
添付ファイル欄に書くパスは、wp-content が基準です
添付の処理は includes/mail.php の attachments() にあります。
6.2.3 の該当部分はこれだけです。
// includes/mail.php 380-414行(6.2.3)より抜粋
foreach ( explode( "\n", $template ) as $line ) {
$line = trim( $line );
if ( '' === $line or str_starts_with( $line, '[' ) ) {
continue;
}
$attachments[] = path_join( WP_CONTENT_DIR, $line );
}
読みどころは3つです。
1行ずつ処理されること、[ で始まる行はフォームのファイル欄として別扱いになること、そして残りの行は WP_CONTENT_DIR と結合されることです。
つまり基準になるディレクトリは wp-content で、WordPressのルートでもテーマフォルダでもありません。
同じ path_join() を PHP 8.3.6 で動かし、書き方ごとの解決先を実測しました。wp-content/uploads/2026/10/guide.pdf に実ファイルを置いた状態での結果です。
| 添付ファイル欄に書いた1行 | 解決されるパス | 添付 |
|---|---|---|
uploads/2026/10/guide.pdf | wp-content/uploads/2026/10/guide.pdf | 付く |
wp-content/uploads/2026/10/guide.pdf | wp-content/wp-content/uploads/2026/10/guide.pdf | 付かない |
/uploads/2026/10/guide.pdf | /uploads/2026/10/guide.pdf(サーバーのルート直下) | 付かない |
./uploads/2026/10/guide.pdf | wp-content/./uploads/2026/10/guide.pdf | 付く |
uploads/2026/10/guide.pdf (末尾に空白) | wp-content/uploads/2026/10/guide.pdf | 付く |
/home/users/…/wp-content/uploads/2026/10/guide.pdf(絶対パス) | そのまま | 付く |
uploads/../../wp-config.php | wp-content の外 | 付かない |
いちばん多い間違いは2行目です。
管理画面のメディアライブラリに表示されるURLが https://example.com/wp-content/uploads/2026/10/guide.pdf なので、そこから wp-content/ 以降をそのまま貼ると wp-content が二重になります。
3行目も見落としやすい形です。
先頭にスラッシュを付けると path_join() が絶対パスと判断してそのまま返すため、サーバーのルート直下を探しに行きます。
相対パスを書くときは先頭のスラッシュを付けないのが正解です。
末尾の空白は trim() で落ちるため影響しません。
絶対パスも使えますが、サーバー移管でパスが変わると壊れるので、uploads/ 始まりの相対パスで書くほうが安全です。
資料請求の自動返信にPDFを添付する手順です
管理画面だけで完結します。
1. PDFの置き場所を決めます。
メディアライブラリからアップロードすると uploads/2026/10/ のような年月フォルダに入ります。
ファイル名が既存と重複すると guide-1.pdf のように連番が付き、差し替えのたびにパスが変わるため、添付用の資料は FTP か ファイルマネージャーで wp-content/uploads/documents/ のような固定フォルダを作って置くほうが運用が楽です。
2. 「メール (2)」タブを有効にします。
フォーム編集画面のメールタブを開き、下部の「メール (2)」のチェックを入れます。
これが送信者向けの自動返信です。
宛先には [your-email] のようにフォームのメールアドレス欄のタグを入れます。
3. 添付ファイル欄にパスを書きます。
同じ「メール (2)」の下部に添付ファイル欄があります。
先ほどの置き場所なら次のように書きます。
複数のPDFを付ける場合は改行で区切り、1行に1ファイルを書きます。
uploads/documents/service-guide.pdf
uploads/documents/price-list.pdf
4. 保存して「設定の検証」を確認します。
保存後にフォーム一覧へ戻り、該当フォームに警告が出ていないか見ます。
添付パスの誤りはここで検出されます(検出条件は次の節に書きます)。
5. 自分宛に実際に送信します。
本番と同じ経路で1通送り、添付の有無とファイルサイズを確認します。
ここを省くと、後述する「ログにしか出ないエラー」を取りこぼします。
なお uploads/ 配下に置いたPDFはURLを直接叩けば誰でもダウンロードできます。
フォームを経由した人だけに配りたい資料であれば、wp-content 配下の別フォルダに置いてWebサーバー側でアクセスを拒否するか、資料の内容を「誰に見られても困らない範囲」に寄せるかの判断が必要です。
Apache なら .htaccess で拒否できますが、Nginx 環境では .htaccess が効かないため、サーバー設定の変更が必要になります。
資料請求フォームを作る前に
自動返信は届いても、誰に資料を送ったかは残りません
Contact Form 7 の標準では、送信内容はメールとしてしか残りません。資料請求フォームでは「いつ誰に何の資料を送ったか」が営業の材料になるのに、メールボックスを検索するしかない状態になります。Frontierline Forms は送信内容のデータベース保存とCSV書き出しを無料版に含んでいるため、管理画面に請求履歴が並びます。確認画面とマルチステップも無料版に入っています。
「エラーは出ないのに添付が付かない」の正体です
添付の不備は2段階でチェックされます。
保存時の設定の検証と、送信時の除外処理です。
やさしいのは前者だけで、後者は画面に何も出ません。
保存時の検証は includes/config-validator/mail.php にあります。
6.2.3 で出るメッセージは次の3つです。
// includes/config-validator/mail.php 406-443行(6.2.3)より抜粋
if ( $this->supports( 'file_not_found' ) ) {
if ( ! empty( $files_not_found ) ) {
foreach ( $files_not_found as $line ) {
$this->add_error( $section, 'file_not_found',
array(
'message' => __( 'Attachment file does not exist at %path%.', 'contact-form-7' ),
'params' => array( 'path' => $line ),
)
);
}
}
}
| エラーコード | 日本語の表示 | 原因 |
|---|---|---|
file_not_found | 添付するファイルが %path% に存在しません。 | パスの基準違い、ファイル名違い、権限不足 |
file_not_in_content_dir | wp-content ディレクトリの外部にあるファイルは指定できません。 | wp-content の外を指している |
attachments_overweight | 添付ファイルの合計容量が大きすぎる。 | 合計25MB超 |
問題は、ここを通過しても送信時に落ちる場合があることです。
送信直前の処理が includes/mail.php の compose() にあります。
// includes/mail.php 271-325行(6.2.3)より抜粋
$attachments = array_filter(
(array) $components['attachments'],
function ( $attachment ) {
$path = path_join( WP_CONTENT_DIR, $attachment );
if ( ! wpcf7_is_file_path_in_content_dir( $path ) ) {
wp_trigger_error( '', sprintf(
__( 'Failed to attach a file. %s is not in the allowed directory.', 'contact-form-7' ),
$path
), E_USER_NOTICE );
return false;
}
if ( ! is_readable( $path ) or ! is_file( $path ) ) {
wp_trigger_error( '', sprintf(
__( 'Failed to attach a file. %s is not a readable file.', 'contact-form-7' ),
$path
), E_USER_NOTICE );
return false;
}
// …合計25MBの判定が続く
}
);
return wp_mail( $recipient, $subject, $body, $headers, $attachments );
array_filter() で添付できないファイルだけを配列から外し、メールはそのまま送信します。
残るのは E_USER_NOTICE のPHPエラーだけです。
送信者には「ありがとうございます」の成功メッセージが出て、本文も普通に届きます。
だから「エラーは出ていないが添付が付かない」という相談になります。
確認手順はこうです。wp-config.php に次の3行を入れ、1通送ってから wp-content/debug.log を見ます。
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false ); // 画面には出さない
grep "Failed to attach" wp-content/debug.log
該当行には解決後のフルパスが入るので、どこを探しに行ったのかが一目で分かります。
原因の切り分けが終わったら、3行は必ず戻します。
本番で WP_DEBUG を出したままにするのは別の事故につながります。
なお、保存時の検証を通ったのに送信時に落ちるのは、ファイルを後から消した場合、パーミッションが変わった場合、ステージングから本番へ移してPDFだけ持ってこなかった場合です。
サイト移管の直後に添付だけ消えているという不具合は、たいていこれです。
25MBの上限は、ユーザーのアップロード枠と合算されます
上限は本体に直書きされています。compose() 側は実ファイルのサイズを足しながら25MBで打ち切ります。
一方で保存時の検証は、添付ファイル欄に書かれたファイル欄タグの上限値も合計に含めます。
// includes/config-validator/mail.php 365-402行(6.2.3)より抜粋
$tags = $this->contact_form->scan_form_tags(
array( 'type' => array( 'file', 'file*' ) )
);
foreach ( $tags as $tag ) {
$name = $tag->name;
if ( ! str_contains( $content, "[{$name}]" ) ) {
continue;
}
$limit = (int) $tag->get_limit_option();
if ( empty( $attachables[$name] ) or $attachables[$name] < $limit ) {
$attachables[$name] = $limit;
}
}
$total_size = array_sum( $attachables );
get_limit_option() の既定値は MB_IN_BYTES(1MB)です。
つまり添付ファイル欄に [your-file] と固定PDFを一緒に書いている場合、検証上の合計は「ファイル欄の上限値+固定PDFの実サイズ」になります。
ファイル欄に limit:20mb のような指定をしていると、固定PDFが数MBあるだけで警告が出ます。
実務では、送信者からの添付を受け取るメール(管理者宛)と、資料を送るメール(自動返信)を分けるのが素直です。
添付ファイル欄はメールごとに独立しているので、管理者宛には [your-file]、自動返信には固定PDFのパスだけを書きます。
選んだ項目ごとに違うPDFを送ります
「サービスAの資料」「サービスBの資料」のように、選択内容で送るPDFを変えたい場合は添付ファイル欄では書けません。
6.2.3 には、そのためのメソッドが用意されています。
// includes/submission.php 880-908行(6.2.3)より抜粋
public function add_extra_attachments( $file_path, $template = 'mail' ) {
if ( ! did_action( 'wpcf7_before_send_mail' ) ) {
return false;
}
$extra_attachments = array();
foreach ( (array) $file_path as $path ) {
$path = path_join( WP_CONTENT_DIR, $path );
if ( file_exists( $path ) ) {
$extra_attachments[] = $path;
}
}
// …以下、テンプレート名をキーに保持
}
ここに落とし穴が2つあります。
1つ目は冒頭の did_action() で、wpcf7_before_send_mail が走る前に呼ぶと何もせず false を返します。wpcf7_submit や init から呼ぶと無反応になるため、必ず wpcf7_before_send_mail のフック内で呼びます。
2つ目はここでも path_join( WP_CONTENT_DIR, $path ) が使われている点で、パスの基準は添付ファイル欄と同じ wp-content です。
実際のコードです。mu-plugins に置くと、プラグインの更新やテーマの切り替えで消えません。
<?php
// wp-content/mu-plugins/cf7-extra-attachment.php
add_action( 'wpcf7_before_send_mail', function ( $contact_form ) {
// 対象フォームだけに限定します(タイトルかIDで判定)
if ( '資料請求' !== $contact_form->title() ) {
return;
}
$submission = WPCF7_Submission::get_instance();
if ( ! $submission ) {
return;
}
$posted = $submission->get_posted_data();
// ラジオボタン [radio material] の値とPDFの対応表
$map = array(
'サービスA' => 'uploads/documents/guide-a.pdf',
'サービスB' => 'uploads/documents/guide-b.pdf',
);
$key = isset( $posted['material'] ) ? (string) $posted['material'] : '';
if ( ! isset( $map[ $key ] ) ) {
return;
}
// 第2引数は添付先のメールテンプレート名。自動返信は mail_2 です
$submission->add_extra_attachments( $map[ $key ], 'mail_2' );
}, 10, 1 );
第2引数のテンプレート名は、管理者宛が mail、自動返信が mail_2 です(includes/contact-form.php 281行でプロパティ名として定義されています)。
ここを mail のままにすると、資料が自分のところにだけ届いて送信者には届きません。
ラジオボタンやチェックボックスの値は配列で入ってくる場合があります。[radio] は単一選択なので文字列ですが、[checkbox] は配列になるため、$posted['material'][0] のように取り出すか is_array() で分岐します。
wp-content の外のファイルは添付できません
添付ファイル欄はフォーム編集権限があれば書き換えられるので、「wp-config.php のパスを書いたら中身がメールで飛んでくるのではないか」という懸念が出ます。
結論はできません。
本体が wpcf7_is_file_path_in_content_dir() で realpath を比較しています。
// includes/validation-functions.php 279-300行(6.2.3)より抜粋
if ( $real_path = realpath( $path ) ) {
$path = $real_path;
} else {
return false;
}
if ( $real_dir = realpath( $dir ) ) {
$dir = trailingslashit( $real_dir );
} else {
return false;
}
return str_starts_with(
wp_normalize_path( $path ),
wp_normalize_path( $dir )
);
PHP 8.3.6 で実測した結果です。uploads/../../wp-config.php は is_readable() が true になるにもかかわらず、realpath() の比較で wp-content の外と判定され、false が返ります。
uploads/../../wp-config.php
-> readable=yes
-> realpath=/…/wp/wp-config.php
-> in_content_dir=NO ← 添付されない
ただしwp-content の中であれば添付できます。
プラグインが書き出した設定ファイルやログ、バックアッププラグインの出力物は wp-content 配下に置かれることが多く、パスが分かれば持ち出せます。
フォーム編集の権限を外部の担当者に渡す運用をしている場合は、Contact Form 7の権限設定で渡す範囲を絞っておくほうが安全です。
まとめ
- 添付ファイル欄のパスは
wp-content基準の相対パスです。uploads/…から書き始め、先頭にスラッシュは付けません wp-content/uploads/…と書くとwp-contentが二重になり、黙って添付されません- 保存時の「設定の検証」で
file_not_foundなどを検出できますが、送信時の除外はPHPのエラーログにしか出ません - 上限は1メールあたり合計25MB。ファイル欄タグを併記すると、その上限値も検証上の合計に入ります
- 選択内容でPDFを変える場合は
wpcf7_before_send_mail内でadd_extra_attachments()を呼び、第2引数にmail_2を渡します
関連する内容は自動返信メールの設定、ファイルアップロードの設定、設定の検証で出る警告の読み方にまとめています。
Frontierline Forms
資料請求フォームは、送ったあとの記録まで含めて設計します
PDFを自動で返すところまでは標準機能で足ります。その先で必要になるのは「誰が、いつ、どの資料を請求したか」の一覧です。Frontierline Forms は送信内容のデータベース保存とCSV書き出し、確認画面、マルチステップを無料版に含んでいます。送信記録が管理画面に残っていれば、添付が落ちた日や通知が止まった日を後から特定できます。定番の要件をプラグイン側へ寄せてから、自前のコードを足す順番が保守を軽くします。
よくある質問
自動返信メールにPDFを添付するには、どこに何を書きますか。
フォーム編集画面の「メール (2)」タブを有効にし、その下部にある添付ファイル欄へ wp-content からの相対パスを1行で書きます。
たとえば wp-content/uploads/documents/guide.pdf に置いたファイルなら uploads/documents/guide.pdf と書きます。
複数添付する場合は改行で区切ります。
添付ファイル欄にパスを書いたのに、メールに添付されません。
パスの基準を間違えている場合がほとんどです。
6.2.3 の includes/mail.php は添付ファイル欄の各行を path_join( WP_CONTENT_DIR, $line ) で解決するため、wp-content/uploads/… と書くと wp-content が二重になり、ファイルが見つかりません。uploads/… から書き始めます。
添付が付かないのに、画面にはエラーが出ません。
なぜですか。
6.2.3 は送信時に添付できないファイルを除外し、PHPのエラーログへ E_USER_NOTICE で「Failed to attach a file.」と記録するだけで、メール自体は送信します。
送信者には成功画面が出て本文も届くため、添付の欠落だけが残ります。WP_DEBUG_LOG を有効にして debug.log を確認します。
添付できる容量の上限はありますか。
本体が1メールあたり合計25MBで打ち切ります。
さらに添付ファイル欄に [your-file] のようなファイル欄のタグを併記している場合、設定の検証はそのタグの上限値(既定1MB)も合計に含めて判定します。
フォームの選択内容によって、送るPDFを変えられますか。
wpcf7_before_send_mail フック内で WPCF7_Submission の add_extra_attachments() を呼べば差し替えられます。
この関数は did_action( 'wpcf7_before_send_mail' ) が false のときに何もせず false を返すため、別のフックから呼ぶと無反応になります。
参考
- Contact Form 7 6.2.3 配布zip(
downloads.wordpress.org・368,433バイト・md568b35dd1c8c1946bf8ec85a56d1763c0)のincludes/mail.php/includes/config-validator/mail.php/includes/validation-functions.php/includes/submission.php/includes/form-tag.php/includes/contact-form.php - WordPress コア
wp-includes/functions.phpのpath_join()path_is_absolute()(相対パスの結合規則) - 検証に使ったPHP=8.3.6(CLI)。
path_join()とwpcf7_is_file_path_in_content_dir()の判定を同条件で再現し、7パターンのパスについて解決先・可読性・wp-content内外を実測しています