README

注意：parseCSV 现在正在修订以符合 PHP 5 标准。如果您有任何问题或功能请求，我们鼓励您提交问题。

parseCSV 是一个易于使用的 PHP 类，可以正确地读取和写入 CSV 数据。它完全符合维基百科上概述的规范（维基百科文章）。它具有许多高级功能，有助于您在处理 CSV 数据时更加轻松。

此库最初由 jimeh 在 2007 年初创建，因为当时 PHP 中缺乏处理 CSV 数据的内置和第三方支持。

安装

使用 Composer 安装很简单。在您的 composer.json 中包含以下内容

"parsecsv/php-parsecsv": "0.4.5"

您也可以手动包含 parsecsv.lib.php 文件

require_once 'parsecsv.lib.php';

功能

• parseCSV 是 PHP 中唯一完整且功能齐全的 CSV 解决方案（据我所知）。
• 支持包含值、包含逗号、双引号和新行。
• 自动检测分隔符字符。
• 按特定字段/列排序数据。
• 易于数据操作。
• 基本 SQL 样式的 条件、偏移量 和 限制 选项用于过滤数据。
• 检测格式不正确的输入错误。它尝试变得智能，但由于 CSV 的结构和不同程序（如 Excel）输出 CSV 数据的方式，不能完全信任 100%。
• 支持使用 PHP 的 iconv 函数进行字符编码转换（需要 PHP 5）。
• 支持 PHP 4 和 5。

示例用法

常规

$csv = new parseCSV('data.csv');
print_r($csv->data);

制表符分隔符和编码转换

$csv = new parseCSV();
$csv->encoding('UTF-16', 'UTF-8');
$csv->delimiter = "\t";
$csv->parse('data.tsv');
print_r($csv->data);

自动检测分隔符字符

$csv = new parseCSV();
$csv->auto('data.csv');
print_r($csv->data);

修改 CSV 文件中的数据

$csv = new parseCSV();
$csv->sort_by = 'id';
$csv->parse('data.csv');
# "4" is the value of the "id" column of the CSV row
$csv->data[4] = array('firstname' => 'John', 'lastname' => 'Doe', 'email' => 'john@doe.com');
$csv->save();

向 CSV 文件末尾添加行/条目

仅在您知道文件的确切结构时才推荐使用。

$csv = new parseCSV();
$csv->save('data.csv', array(array('1986', 'Home', 'Nowhere', '')), true);

将二维数组转换为 CSV 数据，并将标题发送到浏览器以将输出作为文件下载

$csv = new parseCSV();
$csv->output('movies.csv', $array, array('field 1', 'field 2'), ',');

致谢

• parseCSV 基于明洪 Ng 的 CsvFileParser 类的概念。

贡献者

请在此项目的 贡献者 页面上找到完整的列表。

许可

(MIT 许可证)

版权所有 (c) 2014 Jim Myhrberg。

特此授予任何人免费获得本软件及其相关文档文件（“软件”）副本的许可，以不受限制地处理该软件，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或出售软件副本，并允许向获得本软件的人提供软件副本，前提是满足以下条件

上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。

本软件按“现状”提供，不提供任何形式的保证，无论是明示的、暗示的，还是与商业性、特定用途或非侵权有关的保证。在任何情况下，作者或版权所有者均不对任何索赔、损害或其他责任负责，无论是基于合同、侵权或其他原因，源于、因或与该软件或其使用或其他处理有关。