README

PlumExcel 包含了用于 Plum 的 Microsoft Excel 文件的读取器和写入器。Plum 是一个 PHP 的数据处理管道。

由欧洲维也纳的 Florian Eckerstorfer 开发。

功能

• 读取 Microsoft Excel（.xlsx 和 .xls）文件
• 写入 Microsoft Excel（.xlsx 和 .xls）文件
• 使用 PHPExcel

安装

您可以使用 Composer 安装 plum-excel。

$ composer require plumphp/plum-excel

用法

PlumExcel 包含了 Plum 的读取器和写入器。有关 Plum 的更多信息，请参阅Plum 文档。

您还可以在examples/文件夹中找到如何使用 ExcelReader 和 ExcelWriter 的示例。

写入 Excel 文件

写入 Excel 文件非常简单。只需将文件名传递给构造函数。如果想要添加表头行，调用 autoDetectHeader() 方法。

use Plum\PlumExcel\ExcelWriter;

$writer = new ExcelWriter(__DIR__.'/example.xlsx');
$writer->autoDetectHeader();

您也可以通过调用 setHeader() 方法并传递包含名称的数组来手动设置表头名称。

$writer->setHeader(['Country Name', 'ISO 3166-1-alpha-2 code']);

但是，如果您想要更多的控制，您还可以将 PHPExcel 的实例传递给构造函数，以及格式（Excel2007 或 Excel5）或 PHPExcel_Writer_IWriter 的实现。

$writer = new ExcelWriter(__DIR__.'/example.xlsx', $excel, 'Excel2007', $writer);

读取 Excel 文件

读取 Excel 文件也很简单。

use Plum\PlumExcel\ExcelReader;

$reader = new ExcelReader(__DIR__.'/example.xlsx');

您也可以将 PHPExcel 的实例传递给构造函数，而不是文件名。

use Plum\PlumExcel\ExcelReader;

$excel = PHPExcel_IOFactory::load(__DIR__.'/example.xlsx');
$reader = new ExcelReader($excel);

Plum 可以通过使用 Plum\Plum\Converter\HeaderConverter 自动检测表头。

use Plum\Plum\Converter\HeaderConverter;
use Plum\Plum\Filter\SkipFirstFilter;
use Plum\PlumExcel\ExcelReader;

$workflow->addConverter(new HeaderConverter());
$workflow->addFilter(new SkipFirstFilter(1));
$workflow->process(new ExcelReader($filename));

变更日志

版本 0.3（2015年10月24日）

• #2 处理非数组项

版本 0.2.1（2015年4月28日）

• 修复 Plum 版本

版本 0.2（2015年4月22日）

• ExcelReader 支持以文件名作为输入
• 添加对 Plum\Plum\Reader\ReaderFactory 的支持

版本 0.1（2015年4月21日）

• 首次发布

许可证

MIT 许可证适用于 plumphp/plum-excel。有关完整的版权和许可信息，请查看与此源代码一起分发的 LICENSE 文件。