Laravel 5.* 实现 Excel/CSV文件导入导出功能以及常见问题处理

Song5019 次浏览5个评论2017年07月19日

本教程只适合Laravel5.*使用,最新的请查看 Laravel使用maatwebsite/excel实现Excel/CSV文件导入导出及常见问题解决方案

1、简介

Laravel ExcelLaravel 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 = [
            [电话,姓名,身份证],
            [18888888888,李雷,99],
            [18888888888,李雷,92],
            [18888888888,李雷,95],
            [18888888888,李雷,89],
            [18888888888,李雷,96],
        ];
        Excel::create(学习测试,function($excel) use ($cellData){
            $excel->sheet(score, function($sheet) use ($cellData){
                $sheet->rows($cellData);
            });
        })->export(csv);
    }
}

我们在浏览器中访问http://laravel.app:8000/excel/export,会导出一个名为学习测试.csv的Excel文件:

使用Laravel 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(csv)->export(csv);

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

iconv(UTF-8, GBK, 学习测试)

4、导入Csv/Excel文件

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

//Excel文件导入功能 By Laravel学习网
public function import(){
    $filePath = storage/exports/.iconv(UTF-8, GBK, 学习测试)..csv;
    Excel::load($filePath, function($reader) {
        $reader = $reader->getSheet(0);
        //获取表中的数据
        $results = $reader->toArray();
        foreach ($results as $result) {
            $idcard = $result[0];
            $other_message = $result[1];
            dump($idcard);
        }
    });
}

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

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

使用Laravel Excel导入文件

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

5、常见问题讲解

1、读取身份证,电话等发生转译出现6.201021984062554E+17等等信息,只需要把单元格设置成文本格式即可

2、Excel中有时间变成了数字,其实是因为转变成了时间戳,自己转变一下即可,也可把Excel中的单元格格式转变为文本格式

3、导出电话,身份证在单元格中显示1.86E+10,也是格式问题,单元格设置成文本格式即可

4、导入超大Excel,服务器出现500错误怎么办?其实是因为数据过大,占有内存高;解决办法有几种,

  1. 优化插入数据库代码,执行批量插入,比如说读取500条数据,然后执行一次查询数据库操作;
  2. 上传文件后,发布一个异步事件,由任务listener去异步处理excel内容的导入。
  3. 逐行读存数据,这样占用内存就小了

5、导入/导出中文乱码;只需要注意一下编码就可以了

更多相关好文