viest/php-ext-xlsxwriter的读取功能详解

文章详细介绍了php-ext-xlsxwriter的三种核心读取模式：全量数据读取模式、游标读取模式和按数据类型读取。全量模式适合一次性加载中小型文件，游标模式针对大数据集优化内存占用，按数据类型读取则确保数据格式准确性。此外还包含性能优化与内存管理的专业方案。

全量数据读取模式

php-ext-xlsxwriter 提供了强大的全量数据读取功能，适用于需要一次性加载整个 Excel 文件内容的场景。全量数据读取模式通过 openFile 方法实现，能够高效地将 Excel 文件中的数据加载到内存中，并以数组形式返回。

核心功能

1. 快速加载：全量读取模式通过一次性加载文件内容，减少了多次 I/O 操作的开销，适合处理中小型 Excel 文件。
2. 数据完整性：返回的数据包含完整的单元格内容，支持文本、数字、日期等多种数据类型。
3. 内存优化：尽管全量读取会占用较多内存，但 php-ext-xlsxwriter 通过内部优化，显著降低了内存消耗。

使用示例

以下是一个完整的示例代码，展示了如何使用全量数据读取模式加载 Excel 文件并处理数据：

<?php
$excel = new \Vtiful\Kernel\Excel([
    'path' => __DIR__,
]);

// 创建测试文件
$filePath = $excel->fileName('open_xlsx_get_data.xlsx')
    ->header(['Name', 'Age'])
    ->data([
        ['Alice', 25],
        ['Bob', 30],
    ])
    ->output();

// 全量读取数据
$data = $excel->openFile('open_xlsx_get_data.xlsx')->getSheetData();

print_r($data);

// 清理测试文件
@unlink(__DIR__ . '/open_xlsx_get_data.xlsx');
?>

输出结果

Array
(
    [0] => Array
        (
            [0] => Name
            [1] => Age
        )
    [1] => Array
        (
            [0] => Alice
            [1] => 25
        )
    [2] => Array
        (
            [0] => Bob
            [1] => 30
        )
)

性能对比

全量数据读取模式在性能上表现出色，尤其是在处理大量数据时。以下是一个简单的性能对比表格：

模式	数据量（行）	耗时（秒）	内存占用（MB）
全量读取模式	10,000	0.5	50
游标读取模式	10,000	0.8	<1

适用场景

全量数据读取模式适合以下场景：

1. 数据量较小：文件内容可以完全加载到内存中。
2. 需要完整数据：例如生成报表或数据分析时，需要一次性获取所有数据。
3. 快速开发：全量读取模式代码简洁，适合快速实现功能。

注意事项

1. 内存限制：全量读取会占用较多内存，建议在 php.ini 中调整 memory_limit 参数。
2. 文件大小：对于超大型文件（如超过 100MB），建议使用游标读取模式以避免内存溢出。

通过以上内容，您可以轻松掌握 php-ext-xlsxwriter 的全量数据读取功能，并在实际项目中灵活应用。

游标读取模式

游标读取模式是 php-ext-xlswriter 提供的一种高效读取 Excel 文件数据的方式，特别适用于处理大型数据集。通过游标模式，可以逐行或逐单元格读取数据，从而显著降低内存消耗，同时保持较高的性能。

游标模式的工作原理

游标模式的核心思想是“按需读取”，即仅在需要时才从文件中加载数据，而不是一次性将整个文件加载到内存中。以下是游标模式的工作流程：

1. 打开文件：通过 open_xlsx_file 方法打开 Excel 文件。
2. 初始化游标：调用 next_row 或 next_cell 方法初始化游标。
3. 逐行/逐单元格读取：通过循环调用游标方法，逐行或逐单元格读取数据。
4. 关闭文件：读取完成后，关闭文件释放资源。

flowchart TD
    A[打开文件] --> B[初始化游标]
    B --> C{是否还有数据?}
    C -->|是| D[读取当前行/单元格]
    D --> E[处理数据]
    E --> C
    C -->|否| F[关闭文件]

游标模式的优势

特性	游标模式	全量模式
内存占用	极低	高
读取速度	快	慢
适用场景	大数据集	小数据集
是否支持逐行读取	是	否
是否支持逐单元格读取	是	否

代码示例

以下是一个使用游标模式读取 Excel 文件的示例代码：

<?php
$excel = new \Vtiful\Kernel\Excel([
    'path' => './files',
]);

$file = $excel->openFile('example.xlsx');

// 初始化游标
$cursor = $file->nextRow();

// 逐行读取数据
while ($row = $cursor->next()) {
    print_r($row);
}

// 关闭文件
$file->close();
?>

游标模式的高级用法

1. 跳过空行：通过 skip_empty 方法跳过空行，仅读取有效数据。
2. 按数据类型读取：通过 set_type 方法指定数据类型，确保读取的数据格式正确。
3. 回调函数：通过 next_cell_callback 方法为每个单元格设置回调函数，实现自定义处理逻辑。

<?php
$excel = new \Vtiful\Kernel\Excel([
    'path' => './files',
]);

$file = $excel->openFile('example.xlsx');

// 跳过空行
$cursor = $file->nextRow()->skip_empty();

// 按数据类型读取
$cursor->set_type(\Vtiful\Kernel\Excel::TYPE_STRING);

// 逐行读取数据
while ($row = $cursor->next()) {
    print_r($row);
}

// 关闭文件
$file->close();
?>

注意事项

• 文件路径：确保文件路径正确，否则会抛出异常。
• 数据类型：根据实际需求设置数据类型，避免数据解析错误。
• 资源释放：读取完成后务必关闭文件，避免资源泄漏。

通过游标模式，php-ext-xlswriter 能够高效处理大型 Excel 文件，同时保持极低的内存占用，是处理大数据集的理想选择。

按数据类型读取

在 viest/php-ext-xlsxwriter 中，按数据类型读取功能允许开发者根据单元格中数据的实际类型（如字符串、数字、日期等）来提取数据。这种功能在处理复杂数据时非常有用，尤其是在需要确保数据类型的准确性时。

功能概述

通过 open_xlsx_get_data_with_set_type 方法，可以指定数据类型来读取 Excel 文件中的数据。以下是其核心功能点：

1. 指定数据类型：开发者可以为每一列或单元格指定期望的数据类型，确保读取的数据符合预期格式。
2. 灵活性：支持多种数据类型，包括字符串、整数、浮点数、日期等。
3. 性能优化：通过预定义数据类型，可以减少数据转换的开销，提升读取效率。

代码示例

以下是一个完整的示例，展示如何使用 open_xlsx_get_data_with_set_type 方法按数据类型读取 Excel 文件：

<?php
$excel = new \Vtiful\Kernel\Excel([
    'path' => __DIR__,
]);

// 创建一个示例文件并写入数据
$filePath = $excel->fileName('open_xlsx_get_data_with_set_type.xlsx')
    ->header(['Name', 'Age', 'Salary'])
    ->data([
        ['Alice', 25, 5000.50],
        ['Bob', 30, 6000.75],
    ])
    ->output();

// 按数据类型读取文件
$data = $excel->openFile('open_xlsx_get_data_with_set_type.xlsx')
    ->setType([
        \Vtiful\Kernel\Excel::TYPE_STRING, // Name 列作为字符串
        \Vtiful\Kernel\Excel::TYPE_INT,    // Age 列作为整数
        \Vtiful\Kernel\Excel::TYPE_DOUBLE, // Salary 列作为浮点数
    ])
    ->getSheetData();

print_r($data);

// 清理文件
@unlink(__DIR__ . '/open_xlsx_get_data_with_set_type.xlsx');
?>

数据类型支持

以下是 viest/php-ext-xlsxwriter 支持的主要数据类型：

数据类型常量	描述
TYPE_STRING	字符串类型
TYPE_INT	整数类型
TYPE_DOUBLE	浮点数类型
TYPE_TIMESTAMP	时间戳类型
TYPE_BOOL	布尔类型

流程图

以下是通过 open_xlsx_get_data_with_set_type 方法按数据类型读取数据的流程：

flowchart TD
    A[开始] --> B[创建 Excel 文件并写入数据]
    B --> C[打开 Excel 文件]
    C --> D[设置每列的数据类型]
    D --> E[读取数据]
    E --> F[输出数据]
    F --> G[清理文件]
    G --> H[结束]

注意事项

1. 数据类型匹配：确保设置的数据类型与单元格中的实际数据匹配，否则可能导致读取失败或数据转换错误。
2. 性能考虑：对于大型文件，建议使用游标模式（Cursor Mode）以减少内存占用。
3. 文件路径：确保文件路径正确，否则会抛出异常。

通过以上内容，开发者可以轻松掌握 viest/php-ext-xlsxwriter 中按数据类型读取的功能，并在实际项目中灵活应用。

性能优化与内存管理

在viest/php-ext-xlsxwriter中，性能优化与内存管理是其核心优势之一。通过高效的C扩展实现，该项目在处理大规模Excel文件时表现出色。以下将从内存管理策略、性能优化技巧以及实际应用场景三个方面展开说明。

内存管理策略

1. 固定内存模式
   该模式通过限制内存使用量，避免因数据量过大导致的内存溢出问题。适用于处理超大规模数据（如百万行以上）。

   • 内存消耗：<1MB
   • 适用场景：数据导出

   flowchart LR
       A[数据生成] --> B[写入缓冲区]
       B --> C[刷新到磁盘]
       C --> D[释放内存]
   

2. 游标读取模式
   在读取数据时，游标模式逐行处理数据，避免一次性加载全部数据到内存。

   • 内存消耗：<1MB
   • 适用场景：数据导入

   flowchart LR
       A[打开文件] --> B[逐行读取]
       B --> C[处理数据]
       C --> D[释放资源]
   

性能优化技巧

1. 批量写入
   通过减少I/O操作次数提升性能。建议每次写入多行数据而非单行。

   $writer->writeSheetRow('Sheet1', [$data1, $data2, $data3]);
   

2. 数据类型优化
   明确指定数据类型（如整数、字符串），避免自动类型推断的开销。

   $writer->writeSheetRow('Sheet1', [1, 'text', 3.14], ['int', 'string', 'float']);
   

3. 资源复用
   避免频繁创建和销毁资源对象。例如，重复使用同一个format对象。

   $format = $writer->addFormat(['bold' => true]);
   $writer->writeSheetRow('Sheet1', ['Header'], $format);
   

实际应用场景

以下是一个性能对比表格，展示了不同模式下的表现：

模式	数据量	耗时	内存消耗
普通模式	1M行	29S	2083MB
固定内存模式	1M行	52S	<1MB
游标读取模式	1M行	2.8S	<1MB

通过合理选择模式和优化代码，可以显著提升处理效率并降低资源消耗。

php-ext-xlsxwriter通过全量/游标双模式覆盖不同规模数据处理需求，配合数据类型预设和内存优化策略，成为PHP处理Excel的高效解决方案。开发者可根据数据量级选择全量模式（快速开发）或游标模式（大数据处理），结合明确数据类型声明来构建稳定高性能的电子表格应用。