FastAdmin--实现导入Excel表时对日期数据进行格式转换

FastAdmin是什么?

FastAdmin – 基于ThinkPHP5和Bootstrap的极速后台开发框架

FastAdmin启用数据导入功能以及遇到的问题

FastAdmin启用数据导入功能
导入时,出现的问题-求助交流-FastAdmin交流社区
Excel表的第一行数据为数据库表的字段注释,去掉作为主键的自增ID列。
Excel表
数据表
导入

日期导入出错问题的原因和解决办法

日期导入出错问题的原因

Excel中的日期和时间数据是以数值格式存储的,例如日期2018/8/12,实际上是以数值43324存储的。
execlDateTime
FastAdmin的数据导入功能默认是不会对导入的数据进行数据转换处理的。
如果数据库要求输入的日期格式为YYYY/mm/dd,而程序从Excel表格中读取并导入数据库的日期为数值,这时候数据库就会报日期格式不正确的错误。

日期导入出错问题的解决办法

FastAdmin使用了PHPExcel来导入Excel表,PHPExcel自带了日期格式转换的功能。

<?php
date("Y-m-d", \PHPExcel_Shared_Date::ExcelToPHP(43324));
/* 2018/8/12 */

如果不能对Excel表本身进行修改,那该怎么解决这个问题?
方法一,直接修改\app\admin\library\traits\Backend.php的import()方法,加上日期格式转换的代码。问题是这样会影响到全局。
方法二,在自己的控制器将上述的import()方法复制一遍再改写。但这样也不够简洁。
方法三,利用面向对象继承方面的知识,添加并修改少量代码,使得数据转换操作更加灵活。

  1. 给\app\admin\library\traits\Backend.php添加一个属性。
/*
 * 字段-数据转换函数 键值对数组
 */
protected $dataConversionFunMap = [];
  1. 给\app\admin\library\traits\Backend.php添加两个方法。
/*
 * 设置 字段-数据转换函数 键值对数组
 */
protected function setDataConversionFunMap()
{
    $this->dataConversionFunMap = [];
}

/*
 * 数据转换
 */
private function dataConversion($fieldArr, $k, $v)
{
    $this->setDataConversionFunMap();
    if (isset($this->dataConversionFunMap)) {
        foreach ($this->dataConversionFunMap as $field => $dataConversionFun) {
            if ($fieldArr[$k] === $field) {
                return $dataConversionFun($v);
            } else {
                return $v;
            }
        }
    } else {
        return $v;
    }
}
  1. 修改\app\admin\library\traits\Backend.php的import()方法。将其中的$row[$fieldArr[$k]] = $v;这一行改成$row[$fieldArr[$k]] = $this->dataConversion($fieldArr, $k, $v);
// 修改前
foreach ($temp as $k => $v) {
    if (isset($fieldArr[$k]) && $k !== '') {
        $row[$fieldArr[$k]] = $v;
    }
}

// 修改后
foreach ($temp as $k => $v) {
    if (isset($fieldArr[$k]) && $k !== '') {
        $row[$fieldArr[$k]] = $this->dataConversion($fieldArr, $k, $v);
    }
}
  1. 如何使用?
    在自己的控制器中重写setDataConversionFunMap()方法。
    假设要进行数据转换的字段为warehousing_date,将它和针对它进行数据转换处理的函数加入键值对数组。
    这样导入Excel表时,我们设置的数据转换函数就会对字段为warehousing_date的数据进行处理了。
/*
 * 设置 字段-数据转换函数 键值对数组
 */
protected function setDataConversionFunMap()
{
    $dataConversionFunMap['warehousing_date'] = function ($v) {
        if($v){
            return date("Y-m-d", \PHPExcel_Shared_Date::ExcelToPHP($v));
        }
        return date('Y-m-d');
    };
    $this->dataConversionFunMap = $dataConversionFunMap;
}

后续思考

UML类图
UML类图
为了将对原FastAdmin框架代码的修改减少到最小,可以先创建一个MyBackend控制器继承框架原有的公共控制器Backend,再重写Backend的部分属性和方法。
对框架源码改动少,后续升级框架就更容易。
修改后的UML类图

comments powered by Disqus