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

laravel-excel

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文件:

使用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('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导入文件

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

学院君 has written 639 articles

资深PHP工程师,Laravel学院院长

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

  1. 曾经恋上豆豆 says:

    为什么我要报下面的错误,这个报错说的非静态方法maatweb Excel Excel::create()不应该被静态调用
    Non-static method Maatwebsite\Excel\Excel::create() should not be called statically, assuming $this from incompatible context

  2. 伊麦 says:

    请教下使用这个方法打开文件,cpu 占用100% 文件大小csv的大概10m Excel::filter(‘chunk’)->load($file_path)->chunk(200,function($res){}); 或者使用 Excel::load($file_paht,function() {}); 一样cpu 占用100% 请教各位大哥,如何解决。谢谢

  3. 河岸的花- says:

    laravel excel2.1.6测试:xls格式的第一行是中文的时候,只会读到每一行最后一列的值,这样处理就好了可以去看官方手册,忽略第一行,然后读成数组或者对象自己选择 $reader->noHeading(); $data = $reader->toArray(); foreach ($data as $key => $val) { // 从1开始的数组 var_dump($val); }

  4. says:

    请问用该插件导出之后的宽度一直不正常,得如何解决?(是汉字的问题,autosize计算不正确,试了好多种方法了,还是没法解决,求解)

  5. 转码了之后找到了,但是不知道问什么一直提示错误ErrorException in String.php line 496:iconv(): Detected an illegal character in input string我打开了String.php文件修改了496行,加上了ignore,可以运行,但是打印的只用数字,没有中文array:5 [▼ 0 => array:1 [▼ 0 => 99.0 ] 1 => array:1 [▼ 0 => 92.0 ] 2 => array:1 [▶] 3 => array:1 [▶] 4 => array:1 [▶]]

        1. Char Ming says:

          除了修改”to_ascii”,还要看看”encoding”中的”input”是否与自己传输的类型相同。一开始默认是”UTF-8″,我就算改了to_ascii之后中文还是显示不出来。后来修改为”GBK”,就可以显示了~

发表评论

标记为*的字段是必填项(邮箱地址不会被公开)

你可以使用这些HTML 标签和属性: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>