🌈 简单使用 Excel 导入导出的工具库 🌸
🌈 简单使用, 方便快捷。 支持 xls
xlsx
csv
🌸
依赖:PhpSpreadsheet
包地址: packagist.org/packages/yuxiaobo/si...
github开源地址: github.com/edk24/simple-excel
使用 🎉
要求 php >= 7.3
安装
composer require yuxiaobo/simple-excel
导入
$arr = SimpleExcel::import(dirname(__DIR__) . '/test/test.xlsx', 'xlsx', array(
'姓名' => 'name',
'年龄' => 'age',
'性别' => 'gender'
));
var_dump($arr);
导出
// 导出到文件
SimpleExcel::export('/tmp/dump.xlsx', 'xlsx', [
'name' => '姓名',
'idcard' => '身份证',
'mobile' => '手机号'
], [
['name' => '张三', 'idcard' => '`522131199703213342', 'mobile'=>'18311548011'],
['name' => '李四', 'idcard' => '`522131199703213342', 'mobile' => '18311548011'],
['name' => '赵五', 'idcard' => '`522131199703213342', 'mobile' => '18311548011'],
],'#ff0000', '#00ff00', '#333333');
// 直接下载导出数据
SimpleExcel::setDownloadHeader('导出数据.xlsx'); // 设置下载文件响应头
SimpleExcel::export('php://output', 'xlsx', [
'name' => '姓名',
'idcard' => '身份证',
'mobile' => '手机号'
], [
['name' => '张三', 'idcard' => '`522131199703213342', 'mobile'=>'18311548011'],
['name' => '李四', 'idcard' => '`522131199703213342', 'mobile' => '18311548011'],
['name' => '赵五', 'idcard' => '`522131199703213342', 'mobile' => '18311548011'],
],'#ff0000', '#00ff00', '#333333');
常见问题 ❓
1. 导入或导出几十万条数据失败
⭐️ 解决办法只有两个 ⭐️
① 分批导入或者导出
② 数据量较大建议做成异步队列,避免影响主业务
2. 内存超出使用限制
Allowed memory size of 8388608 bytes exhausted (tried to allocate 1298358 bytes)
上述问题是由于内存不足导致的,可能是有死循环,或者代码对内存的使用量比较大。
临时解决办法:ini_set('memory_limit', '256M');
数据量太大的话,建议导出、导入做成异步任务
🌸 优化建议 🌸
① 尽量不要使用框架模型,使用大 DB 查数据(以 thinkphp为例)能明显优化内存与任务耗时
② 只查询需要的字段
③ 使用游标分批查询数据
④ 耗时任务强烈建议做成异步队列的方式!!!不要犟,避免影响主业务
3. 请求超时
临时解决:ini_set('max_execution_time', 600);
也需要注意一下 nginx 的最大保持 http 请求时间
数据量太大的话,建议导出、导入做成异步任务
🌸 优化建议 🌸
① 可以临时通过增加 php 执行时间解决
ini_set('max_execution_time', 600);
② 忘记说了,也需要对应增加 nginx/apache 的 http 请求保持时间,它在你的上层~
③ 耗时任务强烈建议做成异步队列的方式!!!不要犟,避免影响主业务
4. 数字太长变成 E+
导出时在前面加个单元号或者反单元号,如身份证:522131199703253412
改成 '522131199703253412
5. 大数据导出
🌸 建议 🌸
使用 csv 替代 xlsx,
xls 最大行 65536,xlsx 最大行 1048576(一百万)
, csv 没有限制
① 如果你是处理大数据,不要用这个库, 直接用 php 的
fputcsv
和fgetcsv
② 导出几百万上千万的数据,怎么打开?用
UltraEdit
即可,很🐂🍺的
6. 空行忽略
遇到空行数据默认是跳过的
可以通过 simpleExcel::import() 函数的参数4 ignoreEmptyRow
设置
感谢 🙏
- PhpSpreadsheet
问题反馈 ⬆️
如果您在使用过程中遇到了问题,请先反馈 issue
着急使用的话请联系 绿泡泡:Base1024
或是 fork
一份自己改,项目遵循 MIT 开源协议
请务必反馈 issue 让我持续完善 谢谢啦 ♪(・ω・)ノ
关于这种简单的工具库, 有建议和想法都可以给我讲 我会认真听取 积极改进的
最近的更新记录
dev-main
FEAT
增加 excel 导入遇到空行(有格式但没有数据) 的参数配置, 默认跳过空行0.0.9
FEAT
增加 excel 导入遇到空行(有格式但没有数据) 的参数配置, 默认跳过空行0.0.8
FIX
明确最低 php 版本要求为 7.30.0.7
FIX
导出数据中包含null
报错;FIX
导出下载时遇报错,更改响应头为text/html
便于查看问题;