Laravelでメールにファイルを添付する方法を徹底解説！初心者向けattachガイド

1. メール送信におけるファイル添付とは？

1. メール送信におけるファイル添付とは？

パソコンやスマートフォンで普段使っているメールと同じように、プログラムから送るメールにも、資料や写真などを添えることができます。これを添付（てんぷ）と呼びます。Laravelという便利な道具（フレームワーク）では、この添付作業をattach（アタッチ）という名前の機能で行います。

例えば、ネットショップで買い物をした後に届く「領収書PDF」や、お問い合わせフォームから送信された「確認画像」などは、この機能を使って自動で送られています。初心者の方にとって「ファイルをプログラムで扱う」と聞くと難しく感じるかもしれませんが、実際には「どの場所にある、何という名前のファイルを送るか」を指定するだけなので、構える必要はありません。

この記事では、PHPのフレームワークであるLaravelを使い、誰でも簡単にメールへファイルを添えて送信できるスキルを身につけていただくことを目的としています。サーバーの知識がなくても、コードの意味を理解すればすぐに実践できるようになります。

2. 事前準備：Mailableクラスを作成しよう

2. 事前準備：Mailableクラスを作成しよう

Laravelでメールを送る際、最も一般的なのがMailable（メイラブル）クラスを使う方法です。これは、メールの「設計図」のようなものです。この設計図の中に「タイトルは何にするか」「本文はどれか」「添付ファイルはあるか」といった情報を書き込んでいきます。

まずは、コマンドプロンプトやターミナルという黒い画面で、下記の命令を実行してメールの設計図を作成します。今回は、請求書を送る場面を想定して「InvoiceMail」という名前にしてみましょう。

php artisan make:mail InvoiceMail

この命令を実行すると、app/Mail/InvoiceMail.phpというファイルが自動で作られます。このファイルが、メールの動作を制御する中心地となります。プログラミング未経験の方は「artisan（アーティザン）」という言葉に馴染みがないかもしれませんが、これはLaravel専用の便利な「お手伝いロボット」への指示出しだと考えてください。

3. attachメソッドの基本的な書き方

3. attachメソッドの基本的な書き方

それでは、実際にファイルを添付するコードを見ていきましょう。Mailableクラスの中にあるattachmentsという場所（メソッド）に、添付したいファイルの情報を追加します。ここで登場するのがattachです。

基本的には、ファイルの保存場所をフルパス（住所のようなもの）で指定します。まずは、一番シンプルな書き方の例を確認してください。

namespace App\Mail;

use Illuminate\Bus\Queueable;
use Illuminate\Mail\Mailable;
use Illuminate\Mail\Mailables\Attachment;
use Illuminate\Queue\SerializesModels;

class InvoiceMail extends Mailable
{
    use Queueable, SerializesModels;

    public function attachments(): array
    {
        return [
            Attachment::fromPath('/path/to/file/sample.pdf'),
        ];
    }
}

上記のコードで、Attachment::fromPathという部分が「この場所にあるファイルを添付してね」という命令です。/path/to/file/sample.pdfの部分を、実際に皆さんのパソコンやサーバーにあるファイルの場所に書き換えるだけで、メールにファイルがくっついた状態で届くようになります。

4. 添付ファイルに名前を付けて送る方法

4. 添付ファイルに名前を付けて送る方法

サーバーに保存されているファイル名が、例えば「20260330_abc_123.pdf」のような、人間が見て分かりにくい名前だった場合、そのまま送ると受け取った相手が困ってしまいます。そんな時は、メールに表示されるファイル名だけを綺麗な名前に変更して送ることができます。

これを実現するには、asという指示を使います。下記の例では、サーバー上のファイル名はバラバラでも、相手には「請求書.pdf」として届くように設定しています。

public function attachments(): array
{
    return [
        Attachment::fromPath('/storage/app/reports/data_99.pdf')
            ->as('請求書.pdf')
            ->withMime('application/pdf'),
    ];
}

ここで出てきたwithMime（ウィズ・マイム）という言葉は、そのファイルが「何の種類のデータか」を教えてあげるための設定です。PDFならapplication/pdf、画像ならimage/jpegなどと書きます。これを正しく指定することで、相手のメールソフトがファイルを正しく認識できるようになります。初心者のうちは、おまじないのように書いておくと安心です。

5. 複数のファイルを同時に添付する

5. 複数のファイルを同時に添付する

メールに添付したいファイルが2つ以上ある場合も、Laravelなら非常にスマートに記述できます。attachmentsメソッドが返す「配列（リスト形式）」の中に、複数のファイルを並べて書くだけです。

例えば、商品画像と説明書の2つを同時に送りたい場合のコードは、以下のようになります。リストの中身を増やすだけなので、とても直感的ですね。

public function attachments(): array
{
    return [
        Attachment::fromPath('/uploads/image.jpg')->as('商品写真.jpg'),
        Attachment::fromPath('/uploads/manual.pdf')->as('マニュアル.pdf'),
    ];
}

プログラミングでは、このように複数のデータを一箇所にまとめることを「配列」と呼び、[ ]（角括弧）を使って表現します。カンマで区切ることで、3つでも4つでも、必要な分だけファイルを積み込んで送ることが可能です。これができると、一気に実用的なシステムっぽくなりますね。

6. ストレージに保存されたファイルの扱い

6. ストレージに保存されたファイルの扱い

Laravelでは、画像やPDFを「storage（ストレージ）」というフォルダに保存するのが一般的です。この場所に保存されたファイルを添付する場合は、Laravelが用意してくれているstorage_pathという便利な機能を使って、ファイルの場所を特定します。

直接「Cドライブの...」のように書くのではなく、Laravelにお任せして場所を探してもらう書き方が推奨されます。これにより、自分のパソコンで作ったプログラムを、インターネット上のサーバーに移動させた時でも、場所のズレを気にせず正しく動作させることができます。

public function attachments(): array
{
    return [
        Attachment::fromPath(storage_path('app/public/invoices/inv_01.pdf'))
            ->as('最新の請求書.pdf'),
    ];
}

storage_path('...')と書くことで、Laravelが自動的に「プロジェクトの中にあるstorageフォルダ」からの道順を計算してくれます。初心者の方がよく躓くポイントとして、「ファイルの場所を指定したつもりが、プログラムが見つけられずにエラーになる」ということがありますが、この方法を使えばミスを大幅に減らすことができます。

7. メール本文を表示するためのビュー作成

7. メール本文を表示するためのビュー作成

ファイルを添付する準備ができたら、メールの本文も作らなければなりません。LaravelではHTMLを使って、まるでおしゃれなウェブサイトのようなメールを作成できます。これをView（ビュー）と呼びます。

まずは、resources/views/emails/invoice.blade.phpというファイルを作成しましょう。中身はシンプルなHTMLで構いません。Bootstrapのクラスなどを使って、見た目を整えることも可能です。

<div style="font-family: sans-serif; padding: 20px;">
    <h2 style="color: #333;">請求書送付のお知らせ</h2>
    <p>いつもご利用いただきありがとうございます。</p>
    <p>ご依頼いただきました請求書を添付いたしましたので、ご確認ください。</p>
    <hr>
    <p style="font-size: 12px; color: #777;">※本メールはシステムより自動送信されています。</p>
</div>

このHTMLファイルが、メールの「中身」になります。プログラム未経験の方は、HTMLを「メールの便箋（びんせん）」のデザインだと考えてください。この便箋に、先ほど設定した「添付ファイル」がセットになって、相手に届くという流れになります。専門用語では、このように見た目と機能を分けることで、メンテナンスを楽にしています。

8. 実際にメールを送信するコードの実行

8. 実際にメールを送信するコードの実行

最後に、作成したMailableクラスを使って、実際に送信ボタンを押すような処理を書きます。これは通常、コントローラーと呼ばれる「司令塔」の役割を持つ場所に記述します。

Mail::toという命令を使って「誰に」送るかを指定し、その後にsendを使って「何を（どの設計図を）」送るかを指定します。驚くほど短いコードで送信が完了します。

use App\Mail\InvoiceMail;
use Illuminate\Support\Facades\Mail;

public function sendInvoice()
{
    // 送信先のメールアドレスを指定
    $userEmail = 'test@example.com';

    // メール送信を実行！
    Mail::to($userEmail)->send(new InvoiceMail());

    return 'メールの送信が完了しました！';
}

プログラムを実行して「メールの送信が完了しました！」と画面に表示されれば成功です。送信先の受信トレイを確認してみてください。先ほど設定したPDFや画像が、しっかりと一緒に届いているはずです。初心者の方でも、ここまでの手順を一つずつクリアすれば、プロのような自動メール送信システムを構築することができます。

まとめ

まとめ

ここまで、Laravelを利用してメールにファイルを添付する基本から応用までを詳しく解説してきました。メール送信機能は、現代のWebアプリケーションにおいて欠かせない要素の一つです。特に「attach」機能をマスターすることで、請求書の自動送付やユーザーがアップロードした画像の確認メールなど、実用的なシステム構築が可能になります。LaravelのMailableクラスは非常に強力で、複雑な処理も直感的なコードで記述できる点が大きな魅力です。

Laravelメール添付の重要ポイント再確認

今回の学習で最も重要なのは、ファイルを添付する際の「パスの指定」と「表示名の設定」です。サーバー内部での管理用ファイル名と、受信者が目にするファイル名を分けることで、ユーザー体験を大きく向上させることができます。また、複数のファイルを配列形式で一括指定できる柔軟性も、開発効率を高める重要なポイントです。

さらに、ストレージの概念を理解し、storage_path関数を適切に使用することで、環境が変わっても動作が安定する堅牢なプログラムを作成できます。初心者のうちは、MIMEタイプの指定やパスの記述に戸惑うこともあるかもしれませんが、エラーが出た際は「ファイルが実際にその場所に存在するか」をまず確認する癖をつけましょう。

実践的なサンプルコード：複数の条件を組み合わせた添付

最後に、これまでの内容を凝縮した実践的なサンプルコードを掲載します。このコードでは、PDFの請求書と、補足資料としての画像ファイルを同時に、かつ名前を変えて添付する方法を示しています。これをテンプレートとして活用し、自身のプロジェクトに合わせてカスタマイズしてみてください。

namespace App\Mail;

use Illuminate\Bus\Queueable;
use Illuminate\Mail\Mailable;
use Illuminate\Mail\Mailables\Attachment;
use Illuminate\Mail\Mailables\Content;
use Illuminate\Mail\Mailables\Envelope;
use Illuminate\Queue\SerializesModels;

class AdvancedInvoiceMail extends Mailable
{
    use Queueable, SerializesModels;

    /**
     * メールの封筒（件名など）を設定
     */
    public function envelope(): Envelope
    {
        return new Envelope(
            subject: '【重要】ご注文明細と領収書の発行について',
        );
    }

    /**
     * メールの本文（ビュー）を設定
     */
    public function content(): Content
    {
        return new Content(
            view: 'emails.invoice',
        );
    }

    /**
     * 添付ファイルを定義
     */
    public function attachments(): array
    {
        // 複数のファイルを配列で返す
        return [
            // サーバー上のPDFを「領収書.pdf」として添付
            Attachment::fromPath(storage_path('app/private/docs/rec_2026.pdf'))
                ->as('領収書_2026.pdf')
                ->withMime('application/pdf'),

            // プロフィール画像などを別名で添付
            Attachment::fromPath(storage_path('app/public/images/user_thumb.jpg'))
                ->as('案内図.jpg')
                ->withMime('image/jpeg'),
        ];
    }
}

上記のコードをコントローラーから呼び出す際は、以下のような記述になります。シンプルでありながら、高度なメール送信処理を実現しています。

use App\Mail\AdvancedInvoiceMail;
use Illuminate\Support\Facades\Mail;

// 特定のユーザーへ送信
Mail::to('customer@example.jp')->send(new AdvancedInvoiceMail());

実行結果として、以下のようなメッセージがログや画面に出力されれば、無事に処理が完了しています。

Mail sent successfully to customer@example.jp with 2 attachments.

これで、Laravelを使ったメールのファイル添付に関する知識は完璧です。プログラミングは実際に手を動かしてコードを書くことで、より深い理解へと繋がります。ぜひ、今回のガイドを参考に、オリジナルのメール送信機能を作ってみてください。これからの開発がより楽しく、効率的なものになることを願っています。