Laravel -- Excel 导入(import) （v2.1.0）

原博客地址 https://www.jianshu.com/p/7287ebdc77bb

Install （安装）

//> composer.json 中 require中添加如下：
"maatwebsite/excel": "~2.1.0"
//> 然后使用如下composer命令安装
composer update

//> config/app.php 中注册 服务提供类 providers数组中
Maatwebsite\Excel\ExcelServiceProvider::class,
//> config/app.php 中注册 门面类 aliases 数组中
'Excel' => Maatwebsite\Excel\Facades\Excel::class,

//> 移动配置文件 excel.php 到 config目录下面 命令：
php artisan vendor:publish --provider="Maatwebsite\Excel\ExcelServiceProvider"

//> 服务器容器中绑定 的是'excel'
App::make('excel')

Import（导入）

• 我们来修改 config/excel.php 的导入配置参数

//>　修改一下 excel.php 配置文件 的 import 数组参数，否则导入时只解析ASCII（对中文不敏感）
'to_ascii'  => false # 这个参数改为false(否则，只会得到excel的ascii编码以内组成的字符串)
'heading' => 'slugged' # 表示得到关联数组（键是Excel的A1行标题）
# 'heading' => false # 表示得到索引数组（从0开始到...）(其他参数请自行尝试)
'startRow' => 1 # 如果没特殊需求，就使用默认值（表示开始取得位置 row ：从第几行还是取值）
# 这里就采用默认值吧（输入、输出编码）
'encoding'  => [
    'input'  => 'UTF-8',
    'output' => 'UTF-8'
],
# 根据需要适当配置该参数（作用：如果设置为true，会自动忽略为空的某一数值）
# 比如 SPU标题下存在一行为空值，那么该行中就不会出现 apu => null 情况（会自动忽略）
'ignoreEmpty'  => false,
# 改值为 false （表示：当前我们默认只或的一个sheet文件）；true：表示当前默认获取多个sheet文件；（如果不是多文件导入，默认设置为false）
'force_sheets_collection' => false,
//> 其他import参数，遇到再详细讨论

//> 文件导入
    Excel::load($fileName, function ($reader){
        foreach ($reader->get() as $item){
                dump($item);
        }
    });
# 参看一下上传控制器 动作
public function excel(Request $request){
        //> 判断请求类型
        if( $request->isMethod('post') && $_FILES['file'] ){
            //> 获取上传文件路径 $_FILES
            if( $_FILES['file']['error'] == 0 ){
                //> 获取上传文件名称(已便于后面判断是否上传需要后缀文件)
                $name = $_FILES['file']['name'];
                //> 获取上传文件后缀 如(xls exe xlsx 等)
                $ext = strtolower(trim(substr($name,(strpos($name,'.')+1))));
                //> 判断文件是否为指定的上传文件后缀
                if( ! in_array($ext,array('xls','xlsx')) ){
                    //> 返回上一次请求位置,并携带错误消息
                    return redirect()->back()->withErrors('请输入xls或xlsx后缀文件')->withInput();
                }
                //> 获取文件上传路径
                $fileName = $_FILES['file']['tmp_name'];
                //> excel文件导入 上传文件
                Excel::load($fileName, function ($reader){
                    //> 处理上传文件数据 此时 处理多个上传的 sheet 文件
                    foreach ($reader->get() as $item){
                        //> 处理相关上传excel数据
                        dump($item);
                    }
                });
            }
            exit;
        }
        return redirect()->route('home.index');
    }
//> 现在我们讨论一下get()和all()方法
load回调的$reader->get()或$reader->all()并没有很大的区别（得到结果都是一样的）
# 获取 sheet 标题 （改标题）
$reader->getTitle()

# 获取指定 前 $limit 行 数据
# ->takeRows($limit) 获取指定的前$limit条数据
Excel::load($fileName, function ($reader){
          //> takeRows 限制获取数据
          foreach ($reader->takeRows(10)->get() as $item) {
                  dump($item);
          }
});
# ->limitRows($start=0,$end) 获取指定长度数据
Excel::load($fileName, function ($reader){
          //> limitRows(5,10)：获取第5条到第10条数据
          foreach ($reader->limitRows(5,10)->get() as $item) {
                   dump($item);
          }
});
# ->skipRows($num)：跳过指定行
Excel::load($fileName, function ($reader){
          //> skipRows($num) ：开始跳过多少行，在取数据（这里：从第5行开始，取10条数据）
          //> skipRows和takeRows一起使用才能达到上面描述的效果（和limitRows()好像就无效了）
          foreach ($reader->skipRows(5)->takeRows(10)->get() as $item) {
                   dump($item);
          }
});

//> 上面是获取行；下面介绍获取列
# ->takeColumns()  类比 takeRows()方法：只是takeColumns获取的是列数据
# ->limitColumns() 类比 limitRows()方法：只是limitColumns()获取的是列数据
# ->skipColumns() 类比 skipColumns()方法： 只是skipColumns()跳过的列

//> toArray() 对象转换为数组
Excel::load($fileName, function ($reader){
         //> 这样使用也是可以的 $reader->get()->toArray()；
         foreach ($reader->get() as $item) {
                 //> toArray() 转换为数组
                 dump($item->toArray());
         }
});
//> toObject() 转换为对象
# toObject() 好像并没有多大用处（一直提示错误）

Laravel Excel提供了两个打印方法（并没有多个用处）
$reader->dump();
$reader->dd();

//> each() 遍历方法（该方法类似 foreach）
Excel::load($fileName, function ($reader){
      $reader->each(function($sheet){
            $sheet->each(function($row){
                 dump($row);
            });
      });
});

• 选择页和列

//> Excel门面提供一个 selectSheets(...$sheet) 方法：允许打开指定的sheet文件
# 当我们上传多个sheet文件需要被处理时，加载指定的sheet文件就可以使用该方法
Excel::selectSheets('sheet1', 'sheet2')->load();  //> 当然我们也可以选择一张sheet表加载
//> 通过索引加载sheet文件
Excel::selectSheetsByIndex(0, 1)->load(); //> 表示加载第一个第二个sheet文件

//> 获取指定sheet文件指定字段
$reader->select(array('firstname', 'lastname'))->get();  //> 获取firstname和lastname字段
# Or
$reader->get(array('firstname', 'lastname'));  //> 直接给get()传递参数

• 日期处理

//> 日期形式默认会被解析成Carbon对象 如 2017-01-01 08:00
//> 我们来看一下日期配置参数
dates => [
    //> 是否开启日期解析：默认开启（解析日期字符串）
    //> 如果设置为false：2017-01-01 08:00 可能会得到一个 1/1/17 08:00结果（由于美格式（月/日/年）可能会有些区别）
    'enabled' => true,
    //> 日期格式：如果设置为false 将返回一个Carbon时间对象
    # 'format' => 'U' 时：返回一个时间戳 如 2016/1/1 8:12:00 => 1451635920
    'format' => false,
    //> 日期字段，那些字段是日期字段 如果不存在值：默认解析值为字符串 时间的形式的 数据
    //> 如果写上：解析指定的字段 值 为指定字符串的形式
    'columns' => []
],
//> ----------------------------------------------------------
//> date 参数是处理整个导入文件时（如果我们想处理单独某个字段数据时）
# ->formatDates($boolean, $format) 开启或关闭 日期 参数
$reader->formatDates(true);
$reader->formatDates(false);
$reader->formatDates(true, 'Y-m-d H:i');  //> 转换为 Y-m-d H:i 时间形式
Excel::load($fileName, function ($reader){
    $reader->formatDates(false)->each(function($sheet){
          $sheet->each(function($row){
              dump($row);
          });
    });
});
$reader->formatDates(true, 'U'); 装换为时间戳形式
//> format($dateFormat)  转换为指定数据形式
Excel::load($fileName, function ($reader){
    $reader->each(function($sheet){
         $sheet->each(function($row){
               dump($row->{"颜色分类"});
               dump($row->{"颜色分类"}->format('U'));
               dump($row->{"颜色分类"}->format('Y-m-d'));
         });
         exit;
     });
});
//> setDateFormat($format) 默认返回指定形式，不在返回Carbon对象
$reader->setDateFormat('Y-m-d');
//> 设置日期列 setDateColumns()
$reader->setDateColumns(array(
    'created_at',
    'deleted_at'
))->get();

import配置文件 参数 ：calculate 是否开启计算 （经测试，没什么用处）
// Enable calculation
$reader->calculate();
// Disable calculation
$reader->calculate(false);