Laravel-Excel 项目教程

1. 项目的目录结构及介绍

Laravel-Excel 项目的目录结构遵循标准的 Laravel 项目结构，并在此基础上添加了一些特定的文件和目录来支持 Excel 文件的导入和导出功能。以下是项目的主要目录结构及其介绍：

Laravel-Excel/
├── app/
│   ├── Console/
│   ├── Exceptions/
│   ├── Http/
│   ├── Providers/
│   └── ...
├── bootstrap/
├── config/
│   ├── app.php
│   ├── excel.php
│   └── ...
├── database/
├── public/
├── resources/
├── routes/
├── storage/
├── tests/
├── vendor/
├── .env
├── artisan
├── composer.json
└── README.md

• app/: 包含应用程序的核心代码，如控制器、模型、中间件等。
• bootstrap/: 包含框架启动文件。
• config/: 包含应用程序的配置文件，如 app.php 和 excel.php。
• database/: 包含数据库迁移和种子文件。
• public/: 包含公共资源文件，如 index.php 和前端资源。
• resources/: 包含视图、语言文件和前端资源。
• routes/: 包含应用程序的路由定义。
• storage/: 包含应用程序生成的文件，如日志和缓存文件。
• tests/: 包含测试文件。
• vendor/: 包含 Composer 依赖包。
• .env: 环境配置文件。
• artisan: Laravel 命令行工具。
• composer.json: Composer 依赖管理文件。
• README.md: 项目说明文件。

2. 项目的启动文件介绍

Laravel-Excel 项目的启动文件主要位于 bootstrap/ 目录下，其中最重要的是 app.php 文件。该文件负责初始化应用程序并加载必要的服务提供者和服务。

// bootstrap/app.php

<?php

require __DIR__.'/../vendor/autoload.php';

$app = new Illuminate\Foundation\Application(
    $_ENV['APP_BASE_PATH'] ?? dirname(__DIR__)
);

$app->singleton(
    Illuminate\Contracts\Http\Kernel::class,
    App\Http\Kernel::class
);

$app->singleton(
    Illuminate\Contracts\Console\Kernel::class,
    App\Console\Kernel::class
);

$app->singleton(
    Illuminate\Contracts\Debug\ExceptionHandler::class,
    App\Exceptions\Handler::class
);

return $app;

• autoload.php: 加载 Composer 自动加载文件。
• Application: 初始化应用程序实例。
• Kernel: 注册 HTTP 和控制台内核。
• ExceptionHandler: 注册异常处理程序。

3. 项目的配置文件介绍

Laravel-Excel 项目的配置文件主要位于 config/ 目录下，其中最重要的是 excel.php 文件。该文件包含了与 Excel 导入和导出相关的配置选项。

// config/excel.php

<?php

return [

    'exports' => [
        'chunk_size' => 1000,
        'pre_calculate_formulas' => false,
        'csv' => [
            'delimiter' => ',',
            'enclosure' => '"',
            'line_ending' => PHP_EOL,
            'use_bom' => false,
        ],
    ],

    'imports' => [
        'start_row' => 1,
        'chunk_size' => 1000,
        'ignore_empty' => true,
        'heading_row' => [
            'formatter' => 'slug',
        ],
    ],

    'cache' => [
        'driver' => 'memory',
    ],

    'temporary_files' => [
        'local' => storage_path('framework/cache/laravel-excel'),
        'remote' => storage_path('framework/cache/laravel-excel'),
        'remote_disk' => null,
        'force_resync_remote' => null,
    ],

];

• exports: 导出配置选项，如分块大小、公式预计算