Laravel Excel导出：如何基于年月参数设置动态文件名

安全阿岳

2026-8-15

解决Laravel Excel动态生成YYYY-MM格式CSV文件名的问题

方案1：直接传入动态生成的文件名（最简方案）

不需要修改现有UsersExport类，直接从Artisan命令参数生成目标格式的文件名，传给Excel::store即可：

获取并格式化参数
在命令的handle方法中，提取年份和月份参数，确保月份是两位数字：

$year = $this->option('year');
// 补全月份为两位，比如1→01
$month = str_pad($this->option('month'), 2, '0', STR_PAD_LEFT);
// 生成YYYY-MM.csv格式的文件名
$fileName = "{$year}-{$month}.csv";

替换硬编码文件名
把生成好的动态文件名传入Excel::store：

$response = Excel::store(new UsersExport($formatted_data), $fileName, null, \Maatwebsite\Excel\Excel::CSV);

方案2：通过导出类封装文件名逻辑（可选）

如果希望文件名逻辑和导出类绑定，可以给UsersExport实现WithFilename接口：

修改UsersExport类

use Maatwebsite\Excel\Concerns\FromArray;
use Maatwebsite\Excel\Concerns\WithFilename;

class UsersExport implements FromArray, WithFilename
{
    protected $data;
    protected $filename;

    public function __construct(array $data, string $filename)
    {
        $this->data = $data;
        $this->filename = $filename;
    }

    public function array(): array
    {
        return $this->data;
    }

    public function filename(): string
    {
        return $this->filename;
    }
}

在命令中调用
生成文件名后传入导出类，Excel::store的第二个参数传null即可：

$year = $this->option('year');
$month = str_pad($this->option('month'), 2, '0', STR_PAD_LEFT);
$fileName = "{$year}-{$month}.csv";

$response = Excel::store(new UsersExport($formatted_data, $fileName), null, null, \Maatwebsite\Excel\Excel::CSV);

额外建议

加参数校验，避免无效输入：

if (empty($year) || empty($month) || !ctype_digit($year) || !ctype_digit($month)) {
    $this->error('请传入有效的年份和月份，示例：--year=2024 --month=6');
    return;
}