在 Laravel 5 中使用 Laravel Excel 实现 Excel/CSV 文件导入导出功能

Posted 2020-09-07 caigan的技术博客

1、简介

Laravel Excel 在 Laravel 5 中集成 PHPOffice 套件中的 PHPExcel ，从而方便我们以优雅的、富有表现力的代码实现Excel/CSV文件的导入和 导出 。

该项目的GitHub地址是： https://github.com/Maatwebsite/Laravel-Excel 。

本文我们将在Laravel中使用Laravel Excel简单实现Excel文件的导入和导出。

2、安装&配置

使用Composer安装依赖

首先在Laravel项目根目录下使用Composer安装依赖：

composer require maatwebsite/excel ~2.0.0

安装后的设置

在 config/app.php 中注册服务提供者到 providers 数组：

Maatwebsite\Excel\ExcelServiceProvider::class,

同样在 config/app.php 中注册门面到 aliases 数组：

‘Excel‘ => Maatwebsite\Excel\Facades\Excel::class,

如果想要对Laravel Excel进行更多的自定义配置，执行如下Artisan命令：

php artisan vendor:publish

执行成功后会在 config 目录下生成一个配置文件 excel.php 。

3、导出Excel文件

为了演示Laravel Excel相关功能，我们为本测试创建一个干净的控制器 ExcelController.php：

php artisan make:controller ExcelController --plain

然后在 routes.php 中定义相关路由：

Route::get(‘excel/export‘,‘ExcelController@export‘);
Route::get(‘excel/import‘,‘ExcelController@import‘);

接下来我们先在 ExcelController.php 中定义 export 方法实现导出功能：

<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
use App\Http\Requests;
use App\Http\Controllers\Controller;
use Excel;
class ExcelController extends Controller
{
	//Excel文件导出功能 By Laravel学院
	public function export(){
		$cellData = [
			[‘学号‘,‘姓名‘,‘成绩‘],
			[‘10001‘,‘AAAAA‘,‘99‘],
			[‘10002‘,‘BBBBB‘,‘92‘],
			[‘10003‘,‘CCCCC‘,‘95‘],
			[‘10004‘,‘DDDDD‘,‘89‘],
			[‘10005‘,‘EEEEE‘,‘96‘],
		];
		Excel::create(‘学生成绩‘,function($excel) use ($cellData){
			$excel->sheet(‘score‘, function($sheet) use ($cellData){
				$sheet->rows($cellData);
			});
		})->export(‘xls‘);
	}
}

我们在浏览器中访问 http://laravel.app:8000/excel/export ，会导出一个名为 学生成绩.xls的Excel文件：

如果你要导出csv或者xlsx文件，只需将 export 方法中的参数改成csv或xlsx即可。

如果还要将该Excel文件保存到服务器上，可以使用 store 方法：

Excel::create(‘学生成绩‘,function($excel) use ($cellData){
     $excel->sheet(‘score‘, function($sheet) use ($cellData){
         $sheet->rows($cellData);
     });
})->store(‘xls‘)->export(‘xls‘);

文件默认保存到 storage/exports 目录下，如果出现文件名中文乱码，将上述代码文件名做如下修改即可：

iconv(‘UTF-8‘, ‘GBK‘, ‘学生成绩‘)

4、导入Excel文件

我们将刚才保存到服务器上的Excel文件导入进来，导入很简单，使用 Excel 门面上的 load方法即可：

//Excel文件导入功能 By Laravel学院
public function import(){
    $filePath = ‘storage/exports/‘.iconv(‘UTF-8‘, ‘GBK‘, ‘学生成绩‘).‘.xls‘;
    Excel::load($filePath, function($reader) {
        $data = $reader->all();
        dd($data);
    });
}

load 方法基于项目根路径作为根目录，同样我们对中文进行了转码，否则会提示文件不存在。

在浏览器中访问 http://laravel.app:8000/excel/import ，页面显示如下：

当然，Laravel Excel还有很多其它功能，比如将Blade视图导出为Excel或CSV，以及对导入/导出更加细粒度的控制，具体可参考其官方文档： http://www.maatwebsite.nl/laravel-excel/docs