需求说明
最近需要实现一个导出这种格式的Excel表单，之前都有用过导出Excel的功能，但大都是表头+数据的形式，只用于获取数据，没有太多样式要求，不用合并单元格、合并居中等，也不用对每一行数据特异化定制的，所以对PhpSpreadsheet扩展库进行进阶理解。
解决过程
从github->官方文档->api文档->CSDN文章(文末有链接)，完了跟着操作都会一直报错，csdn的那篇文章中一旦调用了样式的方法后，返回对象就变成了样式相关的，不能继续指定工作单元了，所以仍然不是太实用，只能作为参考了。
最后通过看源码 + api文档实现了这部分的功能点。
需要用到的方法
- mergeCells()：合并单元格，参数为起始单元格到结束单元格
- getCellByColumnAndRow(): 获取指定位置的单元格对象
- setValueExplicit()：设置单元格内容，并指定样式
- getStyle()：获取单元格样式对象
- applyFromArray()：指定单元格样式
代码片段解读
1、填充单元格数据
$sheet->mergeCells('A1:K2')->getCellByColumnAndRow(1, 1)->setValueExplicit('广告请款单', $contentType);mergeCells('A1:K2'): 从A1合并到K2getCellByColumnAndRow(1, 1): 获取第一行第一列单元格对象setValueExplicit('广告请款单', $contentType): 填充内容为广告请款单, 并指定为字符串类型($contentType = DataType::TYPE_STRING)
2、指定样式
$styleArray = [
'alignment' => [
// 水平居中
'horizontal' => Alignment::HORIZONTAL_CENTER,
// 垂直居中
'vertical' => Alignment::VERTICAL_CENTER,
// 自动换行
'wrapText' => true
],
];
$sheet->getStyle('A1:K21')->applyFromArray($styleArray);'wrapText' => true指定单元格内容自动换行，会自动解析文本内容中的\n,\r\n换行符applyFromArray()方法在\PhpOffice\PhpSpreadsheet\Style\Alignment类中，可根据需要指定参数;- 注意：指定样式要在所有单元格数据设置之后，因为设置样式后返回的结果是
\PhpOffice\PhpSpreadsheet\Style\Alignment对象，没有mergeCells()等设置单元格的方法了
剩余的麻烦点就是计算每个特定合并单元的位置了
暴力实现
起初在试验过程，理论基础不够充足，所以就通过暴力计算每个样式位置并进行设置了。
$contentType = DataType::TYPE_STRING;
$sheet->mergeCells('A1:K2')->getCellByColumnAndRow(1, 1)->setValueExplicit('广告请款单', $contentType);
$sheet->mergeCells('A3:B4')->getCellByColumnAndRow(1, 3)->setValueExplicit('申请时间', $contentType);
$sheet->mergeCells('C3:E4')->getCellByColumnAndRow(3, 3)->setValueExplicit(date('Y-m-d H:i:s', $data['apply_clear_time']), $contentType);
$sheet->mergeCells('F3:G4')->getCellByColumnAndRow(6, 3)->setValueExplicit('广告编号', $contentType);
$sheet->mergeCells('H3:K4')->getCellByColumnAndRow(8, 3)->setValueExplicit($data['ad_no'], $contentType);
$sheet->mergeCells('A5:B6')->getCellByColumnAndRow(1, 5)->setValueExplicit('收款单位', $contentType);
$sheet->mergeCells('C5:K6')->getCellByColumnAndRow(3, 5)->setValueExplicit($data['real_name'], $contentType);
$sheet->mergeCells('A7:B8')->getCellByColumnAndRow(1, 7)->setValueExplicit('银行账户', $contentType);
$sheet->mergeCells('C7:K8')->getCellByColumnAndRow(3, 7)->setValueExplicit($data['bank_no'], $contentType);
$sheet->mergeCells('A9:B10')->getCellByColumnAndRow(1, 9)->setValueExplicit('开户行', $contentType);
$sheet->mergeCells('C9:K10')->getCellByColumnAndRow(3, 9)->setValueExplicit($data['bank_name'], $contentType);
$sheet->mergeCells('A11:B12')->getCellByColumnAndRow(1, 11)->setValueExplicit('金额', $contentType);
$sheet->mergeCells('C11:E12')->getCellByColumnAndRow(3, 11)->setValueExplicit($data['amount'], $contentType);
$sheet->mergeCells('F11:G12')->getCellByColumnAndRow(6, 11)->setValueExplicit('大写金额', $contentType);
$sheet->mergeCells('H11:K12')->getCellByColumnAndRow(8, 11)->setValueExplicit($data['amount_desc'], $contentType);
$sheet->mergeCells('A13:B14')->getCellByColumnAndRow(1, 13)->setValueExplicit('备注', $contentType);
$sheet->mergeCells('C13:K14')->getCellByColumnAndRow(3, 13)->setValueExplicit($data['desc'], $contentType);
$sheet->mergeCells('A15:D16')->getCellByColumnAndRow(1, 15)->setValueExplicit('广告BD审核', $contentType);
$sheet->mergeCells('E15:H16')->getCellByColumnAndRow(5, 15)->setValueExplicit('广告主管审核', $contentType);
$sheet->mergeCells('I15:K16')->getCellByColumnAndRow(9, 15)->setValueExplicit('总经理审核', $contentType);
$sheet->mergeCells('A17:D19')->getCellByColumnAndRow(1, 17)->setValueExplicit($data['auth_log_list'][0]['auth_desc'], $contentType);
$sheet->mergeCells('E17:H19')->getCellByColumnAndRow(5, 17)->setValueExplicit($data['auth_log_list'][1]['auth_desc'], $contentType);
$sheet->mergeCells('I17:K19')->getCellByColumnAndRow(9, 17)->setValueExplicit($data['auth_log_list'][2] ? $data['auth_log_list'][2]['auth_desc'] : '无需审核', $contentType);
$sheet->mergeCells('A20:B21')->getCellByColumnAndRow(1, 20)->setValueExplicit('财务', $contentType);
$sheet->mergeCells('C20:K21')->getCellByColumnAndRow(3, 20)->setValueExplicit('', $contentType);封装
复杂点
唯一需要计算一下的就是mergeCells()方法和getCellByColumnAndRow()方法的参数
$sheet->mergeCells($start.':'.$end)->getCellByColumnAndRow($column_start, $row_start)->setValueExplicit($column[2], $contentType);但是通过暴力破解的过程也很好得到规律。
通用方法
public static function exportSpecialExcel($data, $filename='', $post=false)
{
// 此处只需要导出单条数据，对内存没要求，
// ini_set('memory_limit', '3072M');
if (empty($filename)) {
$filename = date('Y-m-d') . '导出表格';
}
$pathinfo = pathinfo($filename);
if (empty($pathinfo['extension']) || !in_array($pathinfo['extension'], ['xls', 'xlsx'])) {
$filename = $filename . '.xlsx';
}
$spreadsheet = new Spreadsheet();
$sheet= $spreadsheet->getActiveSheet();
$contentType = DataType::TYPE_STRING;
/**
* column
* 0 - 行高
* 1 - 列宽
* 2 - 数据内容
*/
$row_start = 1;
foreach ($data as $row) {
$column_start = 1;
foreach ($row as $column) {
$start = (static::$column_header[$column_start]) . $row_start;
$end = (static::$column_header[$column_start + $column[1] - 1]).($row_start + $column[0] - 1);
$sheet->mergeCells($start.':'.$end)->getCellByColumnAndRow($column_start, $row_start)->setValueExplicit($column[2], $contentType);
$column_start += $column[1];
}
$row_start += $row[0][0];
}
$styleArray = [
'alignment' => [
'horizontal' => Alignment::HORIZONTAL_CENTER,
'vertical' => Alignment::VERTICAL_CENTER,
'wrapText' => true
],
];
$sheet->getStyle('A1:K21')->applyFromArray($styleArray);
header('Content-Description: File Transfer');
header('Expires: 0');
header('Pragma: public');
header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');//告诉浏览器输出07Excel文件
header('Content-Disposition: attachment;filename="' . $filename . '"');
header('Cache-Control: max-age=0');
$writer = new Xlsx($spreadsheet);
$writer->save('php://output');
//删除清空：
LogHelper::access(memory_get_peak_usage(), 'export_memory');
$spreadsheet->disconnectWorksheets();
unset($spreadsheet);
exit;
}业务数据
每个子元素数组由行高、列宽、数据内容三者组成
$showData = [
[
[2, 11, '广告请款单'],
],
[
[2, 2, '申请时间'],
[2, 3, date('Y-m-d H:i:s', $data['apply_clear_time'])],
[2, 2, '广告编号'],
[2, 4, $data['ad_no']],
],
[
[2, 2, '收款单位'],
[2, 9, $data['real_name']],
],
[
[2, 2, '银行账户'],
[2, 9, $data['bank_no']],
],
[
[2, 2, '开户行'],
[2, 9, $data['bank_name']],
],
[
[2, 2, '金额'],
[2, 3, $data['amount']],
[2, 2, '大写金额'],
[2, 4, $data['amount_desc']],
],
[
[2, 2, '备注'],
[2, 9, $data['desc']],
],
[
[2, 4, '广告BD审核'],
[2, 4, '广告主管审核'],
[2, 3, '总经理审核'],
],
[
[3, 4, $data['auth_log_list'][0]['auth_desc']],
[3, 4, $data['auth_log_list'][1]['auth_desc']],
[3, 3, isset($data['auth_log_list'][2]) ? $data['auth_log_list'][2]['auth_desc'] : '无需审核'],
],
[
[2, 2, '财务'],
[2, 9, ''],
],
];如此便实现了本次的业务需求，也便于今后相关业务功能的实现
参考资料
- github-PhpSpreadsheet: github源码库，可学习安装
- phpspreadsheet 文档 全英文文档
- phpspreadsheet api 库的类和方法说明
- CSDN-详解PhpSpreadsheet设置单元格：由官方文档整理出的部分使用案例，但过于简单，直接使用仍然会出现问题