PhpSpreadsheet 从入门到精通：完整实战指南

PhpSpreadsheet 从入门到精通：完整实战指南

【免费下载链接】PhpSpreadsheetA pure PHP library for reading and writing spreadsheet files项目地址: https://gitcode.com/gh_mirrors/ph/PhpSpreadsheet

还在为PHP处理Excel文件而烦恼吗？PhpSpreadsheet作为PHPOffice生态中的明星项目，能够完美解决各种电子表格处理需求。无论你是需要生成报表、导入数据，还是进行复杂的数据分析，这个纯PHP库都能轻松应对。

数据可视化：条件格式的艺术

想要让数据自动"说话"？条件格式就是你的最佳助手。PhpSpreadsheet让这个功能变得异常简单。

基础条件格式设置

让我们从最简单的数值比较开始：

use PhpOffice\PhpSpreadsheet\Spreadsheet; use PhpOffice\PhpSpreadsheet\Style\Conditional; $spreadsheet = new Spreadsheet(); $worksheet = $spreadsheet->getActiveSheet(); // 填充示例数据 $data = [ ['产品', '销量', '单价', '总金额'], ['苹果', 150, 2.5, 375], ['香蕉', 200, 1.8, 360], ['橙子', 80, 3.2, 256], ]; $worksheet->fromArray($data); // 创建条件格式：销量大于100的标为绿色 $conditional = new Conditional(); $conditional->setConditionType(Conditional::CONDITION_CELLIS); $conditional->setOperatorType(Conditional::OPERATOR_GREATERTHAN); $conditional->addCondition(100); $conditional->getStyle()->getFill()->setFillType(Fill::FILL_SOLID); $conditional->getStyle()->getFill()->getStartColor()->setARGB('FF00FF00'); $conditionalStyles = $worksheet->getStyle('B2:B4')->getConditionalStyles(); $conditionalStyles[] = $conditional; $worksheet->getStyle('B2:B4')->setConditionalStyles($conditionalStyles);

进阶规则：公式驱动格式

当基础条件无法满足需求时，公式条件格式就派上用场了：

// 创建基于公式的条件格式 $conditional = new Conditional(); $conditional->setConditionType(Conditional::CONDITION_EXPRESSION); $conditional->setOperatorType(''); $conditional->addCondition('=AND(B2>100, B2<200)'); $conditional->getStyle()->getFont()->getColor()->setARGB('FFFF0000'); // 应用规则到销量列 $worksheet->getStyle('B2:B4')->setConditionalStyles([$conditional]);

智能公式：让数据自动计算

公式是Excel的灵魂，PhpSpreadsheet让这个灵魂在PHP中重生。

基础公式操作

// 写入基本公式 $worksheet->setCellValue('C5', '=SUM(B2:B4)'); $worksheet->setCellValue('D5', '=AVERAGE(C2:C4)'); $worksheet->setCellValue('E5', '=IF(B2>100,"热销","一般")'); // 获取公式计算结果 $formulaValue = $worksheet->getCell('C5')->getCalculatedValue(); echo "总销量: " . $formulaValue;

数组公式实战

数组公式在处理复杂计算时特别有用：

// 创建数组公式示例 $worksheet->fromArray( ['=TRANSPOSE(A1:D3)'], null, 'F1', true // 标记为数组公式 );

数字格式化：专业报表的关键

一个专业的报表，格式设置至关重要。PhpSpreadsheet提供了强大的格式设置功能。

使用格式向导

use PhpOffice\PhpSpreadsheet\Style\NumberFormat\Wizard\Number; // 创建带千位分隔符的数字格式 $numberFormat = new Number(2, Number::WITH_THOUSANDS_SEPARATOR); $worksheet->getStyle('D2:D4')->getNumberFormat()->setFormatCode((string)$numberFormat); // 设置货币格式 $worksheet->getCell('D2')->setValue(1234.56); $worksheet->getStyle('D2')->getNumberFormat()->setFormatCode('¥#,##0.00');


常用格式速查表

工作表管理：多维度数据组织

当数据量庞大时，合理的工作表管理是必须的。

工作表基础操作

// 创建工作表 $spreadsheet->createSheet(); $spreadsheet->setActiveSheetIndex(1); $spreadsheet->getActiveSheet()->setTitle('月度分析'); // 跨工作表引用 $worksheet1 = $spreadsheet->getSheetByName('Sheet1'); $worksheet2 = $spreadsheet->getSheetByName('月度分析'); // 在工作表2中引用工作表1的数据 $worksheet2->setCellValue('A1', '=Sheet1!B5');

项目实战：构建完整销售报表系统

让我们通过一个完整的例子，整合所有学到的知识：

<?php require 'vendor/autoload.php'; use PhpOffice\PhpSpreadsheet\Spreadsheet; use PhpOffice\PhpSpreadsheet\Writer\Xlsx; class SalesReportGenerator { private $spreadsheet; public function __construct() { $this->spreadsheet = new Spreadsheet(); $this->setupMetadata(); } private function setupMetadata() { $properties = $this->spreadsheet->getProperties(); $properties->setCreator('销售系统'); $properties->setTitle('2023年度销售报告'); $properties->setKeywords('销售 年度报告 数据分析'); } public function generateReport($salesData) { $worksheet = $this->spreadsheet->getActiveSheet(); // 设置表头 $headers = ['月份', '产品', '销量', '单价', '总金额']; $worksheet->fromArray($headers, null, 'A1'); // 填充数据 $row = 2; foreach ($salesData as $data) { $worksheet->fromArray($data, null, 'A' . $row); $row++; } // 应用条件格式 $this->applyConditionalFormatting($worksheet, $row); // 添加汇总公式 $this->addSummaryFormulas($worksheet, $row); return $this; } public function save($filename) { $writer = new Xlsx($this->spreadsheet); $writer->save($filename); } } // 使用示例 $generator = new SalesReportGenerator(); $generator->generateReport($yourSalesData); $generator->save('年度销售报告.xlsx'); ?>

常见问题快速解决

Q: 公式不计算结果怎么办？A: 使用getCalculatedValue()方法获取计算结果，而不是getValue()。

Q: 日期显示为数字怎么办？A: 确保设置了正确的日期格式代码。

Q: 如何提高大文件处理性能？A: 使用缓存机制和分块读取技术。

通过本指南，你已经掌握了PhpSpreadsheet的核心功能。从基础的数据填充到复杂的条件格式和公式计算，这个强大的PHP库都能完美胜任。现在就开始使用PhpSpreadsheet，让你的PHP应用具备专业的电子表格处理能力。

【免费下载链接】PhpSpreadsheetA pure PHP library for reading and writing spreadsheet files项目地址: https://gitcode.com/gh_mirrors/ph/PhpSpreadsheet