52 lines
1.4 KiB
Markdown
52 lines
1.4 KiB
Markdown
|
---
|
|||
|
|
name: backend-excel
|
|||
|
|
description: Excel 导入导出规范（基于 PhpSpreadsheet）
|
|||
|
|
globs:
|
|||
|
|
- "core/excel/**/*.php"
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 导出
|
|||
|
|
|
|||
|
|
```php
|
|||
|
|
use core\excel\ExcelExportService;
|
|||
|
|
|
|||
|
|
$params = [
|
|||
|
|
'filename' => '数据导出',
|
|||
|
|
'sheetName' => '数据导出',
|
|||
|
|
'format' => 'xlsx',
|
|||
|
|
'isHeader' => true,
|
|||
|
|
'fields' => [
|
|||
|
|
['field' => 'name', 'title' => '名称'],
|
|||
|
|
['field' => 'status', 'title' => '状态'],
|
|||
|
|
],
|
|||
|
|
];
|
|||
|
|
|
|||
|
|
ExcelExportService::export($params, static function (callable $chunkHandler): void {
|
|||
|
|
$chunkHandler([
|
|||
|
|
['name' => '名称', 'status' => '启用'],
|
|||
|
|
]);
|
|||
|
|
});
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 明细数组按行导出
|
|||
|
|
|
|||
|
|
`app\adminapi\controller\Crud::export()` 在写入 Excel 前会调用可覆写的 `expandExportRows(iterable $items)`。当一条主记录包含多个明细（如维修记录的 `parts`）时，在对应控制器覆盖该方法并为每项明细 `yield` 一条数组：主记录字段重复，明细字段取当前项。不要将多项明细拼接成同一个单元格，以保证 Excel 可筛选、复制和统计。
|
|||
|
|
|
|||
|
|
## 导入
|
|||
|
|
|
|||
|
|
```php
|
|||
|
|
use core\excel\ExcelImportService;
|
|||
|
|
|
|||
|
|
$rows = ExcelImportService::import($filePath, [
|
|||
|
|
'name' => 'required',
|
|||
|
|
'status' => 'integer',
|
|||
|
|
]);
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 检查清单
|
|||
|
|
|
|||
|
|
- [ ] 导出列名是否与数据键名一致
|
|||
|
|
- [ ] 大数据量是否分页导出
|
|||
|
|
- [ ] 导入是否有数据校验
|
|||
|
|
- [ ] 导入是否有事务保护
|