Laravel多图片邮件发送报错：basename()期望字符串而非数组求助

嘿，作为Laravel新手碰到这个问题太正常了，我来帮你理清思路搞定它！你遇到的basename() expects parameter 1 to be string, array given错误，根源很明确：你在邮件模板里直接把整个路径数组传给了$message->embed()方法，但这个方法需要的是单个文件的字符串路径，不是数组，所以内部调用basename处理数组时就触发了报错。

下面咱们一步步来修正：

1. 正确编写你的SendMail邮件类 #

首先要确保邮件类能正确接收路径数组，然后在build方法里逐个处理图片（不管是内嵌显示还是作为附件）：

namespace App\Mail;

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

class SendMail extends Mailable
{
    use Queueable, SerializesModels;

    // 定义公开属性，让模板能直接访问路径数组
    public $imagePaths;

    // 构造函数接收路径数组并赋值
    public function __construct(array $imagePaths)
    {
        $this->imagePaths = $imagePaths;
    }

    public function build()
    {
        $mail = $this->view('emails.your-mail-template'); // 替换成你的实际模板名

        // 选项1：把图片作为**内嵌图片**（邮件内容里直接显示）
        // 先把所有图片的嵌入ID收集到数组，传给模板
        $embeddedImageCids = [];
        foreach ($this->imagePaths as $path) {
            // embed()会返回图片的CID，用于模板里的img标签
            $embeddedImageCids[] = $this->embed($path);
        }
        $mail->with('embeddedImages', $embeddedImageCids);

        // 选项2：把图片作为**邮件附件**（出现在附件列表里）
        // 如果需要附件，取消下面的注释即可（可以和内嵌同时使用）
        // foreach ($this->imagePaths as $path) {
        //     $mail->attach($path);
        // }

        return $mail;
    }
}

2. 控制器里的调用方式 #

确保你生成的$pathToFile是正确的绝对路径数组，然后直接传给SendMail实例：

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

// 假设你已经正确生成了图片绝对路径数组$pathToFile
// 示例：$pathToFile = [public_path('images/pic1.jpg'), public_path('images/pic2.jpg')];

Mail::to('your-recipient@example.com')->send(new SendMail($pathToFile));

3. 邮件模板的正确写法 #

现在模板里可以直接循环我们传过来的embeddedImages数组，把每个内嵌图片显示出来：

<!-- 你的邮件模板内容 -->
<p>这是你要发送的图片：</p>

@foreach($embeddedImages as $imageCid)
    <img src="{{ $imageCid }}" alt="邮件内嵌图片" style="max-width: 300px; margin: 10px 0;">
@endforeach

关键注意点 #

• 必须用绝对路径：比如用public_path()、storage_path()生成路径，不要用相对路径，否则Laravel找不到文件。
• 别再把整个数组传给embed()：之前的错误就是因为这点，一定要逐个处理数组里的每个路径。

这样修改后，你就能正常发送带多张内嵌图片（或附件）的邮件，也不会再碰到那个basename的错误啦！

内容的提问来源于stack exchange，提问作者Hashan