在 Laravel 5 中使用 Laravel Excel 实现 Excel/CSV 文件导入导出功能
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
数组:
- MaatwebsiteExcelExcelServiceProvider::class,
同样在config/app.php
中注册门面到aliases
数组:
- "Excel" => MaatwebsiteExcelFacadesExcel::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 AppHttpControllers;
- use IlluminateHttpRequest;
- use AppHttpRequests;
- use AppHttpControllersController;
- 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
转自 http://www.shouce.ren/api/view/a/10859
进一步研究发现,表头有关的设置在扩展包的excel.php设置文件中。 找到这行
"to_ascii"
=> true,
改为false,这下就算是中文标题也OK。
如果不想要标题,excel.php中找到"heading"
把设置值改为false,得到无key的数组