Laravel导出文件技巧与方法分享

在 Laravel 框架中导出文件（如 Excel、CSV 或 PDF）是常见需求，比如导出用户数据、订单记录等。Laravel 本身不内置导出功能，但可以结合第三方库高效实现。以下是几种常用的导出方式及实现方法。

使用 Laravel Excel (Maatwebsite) 导出 Excel 和 CSV

Laravel Excel 是最流行的 Laravel 插件之一，基于 PHPSpreadsheet，支持导出 Excel (.xlsx) 和 CSV 文件。

安装步骤：

• 通过 Composer 安装： composer require maatwebsite/excel
• Laravel 9+ 已支持自动发现，无需手动注册服务提供者

创建导出类：

生成的类示例如下：

namespace App\Exports;

use App\Models\User;
use Maatwebsite\Excel\Concerns\FromCollection;

class UsersExport implements FromCollection
{
    public function collection()
    {
        return User::select('id', 'name', 'email', 'created_at')->get();
    }
}

在控制器中调用导出：

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

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

访问该方法时，浏览器会自动下载名为 users.xlsx 的文件。

导出为 CSV 格式

只需更改文件名后缀即可：

return Excel::download(new UsersExport, 'users.csv');

确保导出类兼容 CSV（FromCollection 默认支持）。

自定义导出内容（标题行、格式化等）

可通过实现更多接口来自定义导出行为：

• WithHeadings：添加表头
• ShouldAutoSize：自动调整列宽
• WithMapping：格式化字段

示例：添加表头和格式化时间

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

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

    public function headings(): array
    {
        return ['ID', '姓名', '邮箱', '注册时间'];
    }

    public function map($user): array
    {
        return [
            $user->id,
            $user->name,
            $user->email,
            $user->created_at->format('Y-m-d H:i'),
        ];
    }
}

导出为 PDF（使用 DomPDF 或 Snappy）

若需导出 PDF，可结合 barryvdh/laravel-dompdf。

• 安装： composer require barryvdh/laravel-dompdf
• 创建视图模板（如 exports.users-pdf.blade.php）

控制器中生成 PDF：

use PDF;

public function exportPdf()
{
    $users = User::select('id', 'name', 'email')->get();
    $pdf = PDF::loadView('exports.users-pdf', compact('users'));
    
    return $pdf->download('users.pdf');
}

注意：PDF 不适合大量数据，容易内存溢出。

路由与权限控制

建议将导出接口设为 POST 或加入中间件防止未授权访问：

Route::get('/export/users', [UserController::class, 'export'])->middleware('auth', 'can:export-users');

避免直接暴露 GET 接口被爬取或滥用。

基本上就这些。Laravel 配合扩展库能轻松实现各类文件导出，关键是选对工具并注意性能和安全。