laravel框架复合表头的导出Excel

在Laravel框架中，要实现复合表头的导出Excel功能，通常会借助Laravel Excel这个扩展包。Laravel Excel是一个强大的库，用于处理Excel文件的操作，包括读取、写入以及复杂的格式化等。复合表头指的是在Excel中某一列的单元格跨越了多行或多列的情况，这在数据展示上可以带来更好的可读性。

以下是一个简单的示例，演示如何使用Laravel Excel来导出包含复合表头的Excel文件：

1. 首先确保已经安装了Maatwebsite/Laravel-Excel扩展包，可以通过Composer进行安装。

composer require maatwebsite/excel

2. 接着发布配置文件并执行Laravel的配置命令：

php artisan vendor:publish --tag="excel"

3. 创建一个用于导出Excel的类：

php artisan make:export UsersExport --model=User

这个命令会在`app/Exports`目录下创建一个新的类`UsersExport`，它继承自`Maatwebsite\Excel\Concerns\FromCollection`。

4. 在`UsersExport`类中定义复合表头，可以使用`WithHeadings`、`WithMapping`、`FromCollection`等接口来实现。以下是一个简单的实现示例：

namespace App\Exports;

use Maatwebsite\Excel\Concerns\FromCollection;
use Maatwebsite\Excel\Concerns\WithHeadings;
use Maatwebsite\Excel\Concerns\WithMapping;
use Maatwebsite\Excel\Concerns\WithStartRow;

class UsersExport implements FromCollection, WithHeadings, WithMapping, WithStartRow
{
    public function collection()
    {
        return User::all();
    }

    public function startRow(): int
    {
        return 3; // 设置开始行号，例如从第三行开始
    }

    public function headings(): array
    {
        return [ // 这里定义复合表头
            '姓名',
            ['部门', '职位', '城市'],
            '邮箱',
        ];
    }

    public function map($user): array
    {
        return [
            $user->name,
            [$user->department, $user->position, $user->city], // 注意这里将部门、职位、城市作为一个数组输出，以匹配复合表头
            $user->email,
        ];
    }
}

5. 最后，创建一个路由来触发Excel导出：

use App\Exports\UsersExport;
use Maatwebsite\Excel\Facades\Excel;

Route::get('/export', function () {
    return Excel::download(new UsersExport, 'users.xlsx');
});

当访问这个路由时，就会触发`UsersExport`类的导出操作，并下载名为`users.xlsx`的Excel文件，文件中包含复合表头。