league/csv PHP：方法、示例、安装

league/csv 库简介（用于 PHP）

\n\n

league/csv 库是一个强大且便捷的工具，用于在 PHP 中处理 CSV（逗号分隔值）文件。它为开发者提供了一个简单而灵活的 API，用于读取、写入、处理和转换 CSV 数据。与 PHP 内置函数（fgetcsv、fputcsv）不同，league/csv 提供了面向对象的方法、支持多种 CSV 方言、处理 BOM（字节顺序标记）、通过迭代器处理大文件以及许多其他有用的功能。

\n\n

该库是 The League of Extraordinary Packages 生态系统的一部分，被认为是 PHP 中处理 CSV 的事实标准。它得到积极维护，拥有出色的文档，并经过测试覆盖。

\n\n

为什么需要 league/csv？

简化 CSV 处理： 无需手动管理文件指针和循环，您可以直接使用清晰的对象和方法进行操作。
安全性： 该库能正确处理字符转义、引号以及字段内的换行符。
灵活性： 支持多种分隔符（逗号、分号、制表符）、转义字符和字符串限定符。
性能： 使用生成器（yield）可以处理任意大小的文件，而无需将整个内容加载到内存中。
功能性： 内置方法用于转换为 JSON、HTML、XML，以及排序、过滤和转换列。

\n\n

库的安装

\n\n

league/csv 通过 Composer（PHP 的依赖管理器）进行安装。请确保您的系统中已安装 Composer。

\n\n

在项目的根目录中打开终端并执行以下命令：

\n\n

composer require league/csv

\n\n

安装成功后，您的项目中会出现 vendor 文件夹以及 composer.json / composer.lock 文件。要在 PHP 脚本中引入该库，请使用 Composer 的标准自动加载器：

\n\n

require 'vendor/autoload.php';\n\nuse League\\Csv\\Reader;\nuse League\\Csv\\Writer;\nuse League\\Csv\\Statement;

\n\n

快速入门及代码示例

\n\n

让我们创建一个简单的 CSV 文件，向其中写入数据，然后再读取它们。

\n\n

示例 1：向 CSV 写入数据

\n\n

<?php\nrequire 'vendor/autoload.php';\n\nuse League\\Csv\\Writer;\n\n// 创建 Writer 对象\n$writer = Writer::createFromPath('users.csv', 'w+');\n\n// 插入标题行\n$writer->insertOne(['ID', '姓名', 'Email']);\n\n// 插入多行数据\n$writer->insertAll([\n    [1, '伊万·伊万诺夫', 'ivan@example.com'],\n    [2, '彼得·彼得罗夫', 'petr@example.com'],\n    [3, '安娜·斯米尔诺娃', 'anna@example.com'],\n]);\n\necho "文件 users.csv 已成功创建！";\n?>

\n\n

示例 2：从 CSV 读取数据

\n\n

<?php\nrequire 'vendor/autoload.php';\n\nuse League\\Csv\\Reader;\n\n// 创建 Reader 对象\n$reader = Reader::createFromPath('users.csv', 'r');\n$reader->setHeaderOffset(0); // 指定第一行为标题行\n\n// 获取所有记录，以关联数组形式返回\n$records = $reader->getRecords();\n\nforeach ($records as $record) {\n    echo "ID: " . $record['ID'] . ", 姓名: " . $record['姓名'] . ", Email: " . $record['Email'] . "<br>";\n}\n?>

\n\n