加入收藏 | 设为首页 | 会员中心 | 我要投稿 李大同 (https://www.lidatong.com.cn/)- 科技、建站、经验、云计算、5G、大数据,站长网!
当前位置: 首页 > 站长学院 > PHP教程 > 正文

[PHP 开源类库]simple-Excel — 兼具优雅与性能的Excel和CSV文件

发布时间:2020-12-13 21:02:37 所属栏目:PHP教程 来源:网络整理
导读:该扩展包可让你轻松读取和写入简单的 Excel 和 CSV 文件。在后台使用生成器来确保低内存使用,即使在处理大型文件时也是如此。 这是有关如何读取 Excel 或 CSV 的示例。 SimpleExcelReader::create($pathToFile)-getRows() -each(function(array $rowPropert

该扩展包可让你轻松读取和写入简单的 Excel 和 CSV 文件。在后台使用生成器来确保低内存使用,即使在处理大型文件时也是如此。

这是有关如何读取 Excel 或 CSV 的示例。

SimpleExcelReader::create($pathToFile)->getRows()
   ->each(function(array $rowProperties) {
        // process the row
    });

  

如果?$ pathToFile?以?.csv?结尾。则假定为 CSV 文件。如果以?.xlsx?结尾,则假定为 Excel 文件。

安装

你可以通过 composer 安装该软件包:

$ composer require spatie/simple-excel

  

用法

?

读取 CSV

想象你有一个包含如下内容的 CSV 文件

email,first_name
john@example.com,john
jane@example.com,jane

  

?

// $rows是 IlluminateSupportLazyCollection 的一个实例
$rows = SimpleExcelReader::create($pathToCsv)->getRows();

$rows->each(function(array $rowProperties) {
   // 循环的第一个 $rowProperties 应该是下面这样的
   // ['email' => 'john@example','first_name' => 'john']
});

  

读取 Excel 文件

读取 Excel 文件与读取 CSV 文件相同。只需确保提供给?SimpleExcelReader?的?create?方法的路径以?xlsx?结尾。

使用懒集合

getRows?将返回?LazyCollection?实例,该实例是 Laravel 框架的一部分。因为在后台使用了生成器,即使是大文件内存使用量也会较低。

你可以在这里. 找到关于?LazyCollection?的方法

这是一个简单的愚蠢的例子,我们只想处理?first_name?长度大于 5 的行。

SimpleExcelReader::create($pathToCsv)->getRows()
    ->filter(function(array $rowProperties) {
       return strlen($rowProperties['first_name']) > 5
    })
    ->each(function(array $rowProperties) {
        // processing rows
    });

  

读取一个没有标题的文件

如果你要读取一个没有标题的文件,你应该使用?noHeaderRow()

// $rows是 IlluminateSupportLazyCollection 的一个实例
$rows = SimpleExcelReader::create($pathToCsv)
    ->noHeaderRow()
    ->getRows()
    ->each(function(array $rowProperties) {
       // 第一次循环的 $rowProperties 会是下面这样
       // [0 => 'john@example',1 => 'john']
});

  

自己创建一个阅读器

首先我们已经引入了?box/spout?这个包。 你可以通过?getReader?方法获取一个阅读器的接口?BoxSpoutReaderReaderInterface

$reader = SimpleExcelReader::create($pathToCsv)->getReader(); 

写入文件

这里将展示如何写入一个 CSV 文件:

$writer = SimpleExcelWriter::create($pathToCsv)
     ->addRow([
        'first_name' => 'John','last_name' => 'Doe',])
    ->addRow([
        'first_name' => 'Jane',])

  

; 

pathToCsv?文件将包含以下内容:

first_name,last_name
John,Doe
Jane,Doe

  

写入 Excel 文件

写入 Excel 文件与写入 CSV 相同。只需确保提供给?SimpleExcelWriter?的?create?方法的路径以?xlsx?结尾。

将 Excel 文件流式传输到浏览器

无需将文件写入磁盘,您可以将其直接流式传输到浏览器。

$writer = SimpleExcelWriter::streamDownload('your-export.xlsx')
     ->addRow([
        'first_name' => 'John',])
    ->toBrowser();

  

写入没有标题的文件

如果正在写入的文件没有标题行,则应使用?noHeaderRow()?方法。

$writer = SimpleExcelWriter::create($pathToCsv)
    ->noHeaderRow()
    ->addRow([
        'first_name' => 'Jane',]);
});

  

这将输出:

Jane,Doe

  

添加布局

这个包底层使用了?box/spout?包。该软件包包含一个?StyleBuilder?,可用于格式化行。请注意样式只能在 Excel 文档上使用。

use BoxSpoutWriterCommonCreatorStyleStyleBuilder;
use BoxSpoutCommonEntityStyleColor;

$style = (new StyleBuilder())
   ->setFontBold()
   ->setFontSize(15)
   ->setFontColor(Color::BLUE)
   ->setShouldWrapText()
   ->setBackgroundColor(Color::YELLOW)
   ->build();

$writer->addRow(['values,'of','the','row'],$style)

  

有关样式的更多信息,请查阅?Spout 文档.

?

使用替代定界符

默认情况下,?SimpleExcelReader?将假定分隔符为?,

使用其他分隔符的方法:

SimpleExcelWriter::create($pathToCsv)->useDelimiter(';');

  

获取写入的行数

您可以获取写入的行数。该数字包括自动添加的标题行。

$writerWithAutomaticHeader = SimpleExcelWriter::create($this->pathToCsv)
    ->addRow([
        'first_name' => 'John',]);

$writerWithoutAutomaticHeader->getNumberOfRows() // returns 2

  

手动使用 writer 对象

因基于?box/spout?包,所以你可以通过?getWriter?来获取到底层的?BoxSpoutReaderWriterInterface?实现:

$writer = SimpleExcelWriter::create($pathToCsv)->getWriter();

  

更多学习内容请访问:

腾讯T3-T4标准精品PHP架构师教程目录大全,只要你看完保证薪资上升一个台阶(持续更新)

?

(编辑:李大同)

【声明】本站内容均来自网络,其相关言论仅代表作者个人观点,不代表本站立场。若无意侵犯到您的权利,请及时与联系站长删除相关内容!

    推荐文章
      热点阅读