Laravel可通过Mail功能发送带附件的邮件，需先配置SMTP驱动，再创建Mailable类并使用attach()、attachFromStorage()或attachData()添加文件，结合Blade模板定义内容，最后调用Mail::to()->send()发送。

如果您需要通过 Laravel 发送包含文件的电子邮件，例如发送报表、合同或图片等附件，可以通过内置的 Mail 功能实现。邮件中添加附件能够提升信息传递的完整性与专业性。

本文运行环境：MacBook Pro，macOS Sonoma

一、配置邮件驱动

在发送邮件之前，必须确保 Laravel 的邮件系统已正确配置。Laravel 支持多种邮件驱动，包括 SMTP、Mailgun、Postmark 等，推荐使用 SMTP 进行本地开发和测试。

1、打开 .env 文件，设置 MAIL_DRIVER 和相关 SMTP 参数。

2、确保以下配置项已填写正确的邮件服务信息：

MAIL_MAILER=smtp
MAIL_HOST=smtp.example.com
MAIL_PORT=587
MAIL_USERNAME=your_email@example.com
MAIL_PASSWORD=your_password
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=your_email@example.com
MAIL_FROM_NAME="${APP_NAME}"

3、保存并清除配置缓存：php artisan config:clear。

二、创建邮件类

邮件内容和附件逻辑封装在邮件类中，使用 Artisan 命令生成 Mailable 类，便于组织视图和数据。

1、执行命令创建邮件类：php artisan make:mail OrderShipped。

2、打开生成的 app/Mail/OrderShipped.php 文件。

3、在 build() 方法中使用 attach() 方法添加附件路径。

4、示例代码如下：

$this->view('emails.orders.shipped')
    ->subject('订单已发货')
    ->attach('/path/to/document.pdf');

三、添加多种附件类型

Laravel 允许添加多个附件，并支持指定附件名称或条件附加，适用于不同业务场景。

1、使用 attach() 添加多个文件：

$this->attach('/path/to/file1.pdf');
$this->attach('/path/to/image.jpg', [
  'as' => 'photo.jpg',
  'mime' => 'image/jpeg'
]);

2、使用 attachFromStorage() 从存储目录添加附件，如从 storage/app/invoices/invoice-123.pdf 添加：

$this->attachFromStorage('invoices/invoice-123.pdf');

3、使用 attachData() 发送原始数据作为附件，例如生成的 PDF 内容：

$pdfContent = PDF::loadView('pdf.invoice')->output();
$this->attachData($pdfContent, 'invoice.pdf', [
  'mime' => 'application/pdf'
]);

四、定义邮件视图模板

邮件正文应使用 Blade 模板引擎构建，以实现动态内容渲染和样式控制。

1、在 resources/views/emails/orders/ 目录下创建 shipped.blade.php 文件。

2、编写 HTML 邮件内容，例如：

亲爱的用户

您的订单已发货，请查收附件中的运单信息。

3、可通过 {{ $content }} 插入传递的数据变量。

五、发送邮件

完成配置和模板后，即可在控制器或任务中调用 Mail Facade 发送邮件。

1、在控制器中引入 Mail 和 Mailable 类：

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

2、调用 Mail::to() 方法发送：

Mail::to('recipient@example.com')->send(new OrderShipped());

3、可链式调用 cc 或 bcc：

Mail::to('user@example.com')
    ->cc('manager@example.com')
    ->bcc('admin@example.com')
    ->send(new OrderShipped());