kzykhys/php-csv-parser

将CSV转换为数组(完全支持Excel样式!)

1.4.1 2014-01-15 05:17 UTC

This package is not auto-updated.

Last update: 2024-09-14 12:44:33 UTC


README

将CSV转换为数组/迭代器(完全支持Excel样式!)

Latest Stable Version Build Status Coverage Status SensioLabsInsight

为什么选择PHPCsvParser?

正如您所知,PHP有内置的fgetcsv函数。但存在一些问题

  • 单元格中的换行符
  • 多字节字符串(特别是非UTF-8)
  • 单元格中的双引号

要求

PHP5.3.3或更高版本

安装

创建或修改您的composer.json

{
    "require": {
        "kzykhys/php-csv-parser": ">1.4"
    }
}

然后运行

$ php composer.phar install

用法

解析CSV文件

1,"some text",150
2,"some multi line
text",2000
<?php

require('./vendor/autoload.php');

$parser = \KzykHys\CsvParser\CsvParser::fromFile('./test.csv');
$result = $parser->parse();

var_dump($result);

这和

<?php

require('./vendor/autoload.php');

$iterator = new \SplFileObject('./test.csv');
$parser = new \KzykHys\CsvParser\CsvParser($iterator);
$result = $parser->parse();

var_dump($result);

从字符串解析

<?php

require('./vendor/autoload.php');

$parser = \KzykHys\CsvParser\CsvParser::fromString($string);
$result = $parser->parse();

var_dump($result);

从数组/迭代器解析

<?php

require('./vendor/autoload.php');

$parser = \KzykHys\CsvParser\CsvParser::fromArray(array('a,b,c,d', 'e,f,g,h'));
$result = $parser->parse();

$iterator = new ArrayIterator(array('a,b,c,d', 'e,f,g,h'));
$parser2 = new \KzykHys\CsvParser\CsvParser($iterator);
$result2 = $parser2->parse();

var_dump($result);
var_dump($result2);

处理大文件

\KzykHys\CsvParser\CsvParser本身是Traversable,所以您可以在运行时转换CSV行。

以下示例是性能最佳选择

<?php

require('./vendor/autoload.php');

$parser = \KzykHys\CsvParser\CsvParser::fromFile('./test.csv');

foreach ($parser as $record) {
    // handles each record
    var_dump($record);
}

选项

您可以将选项传递给每个静态方法的第二个参数。

  • CsvParser::fromFile($file, $options);
  • CsvParser::fromString($string, $options);
  • CsvParser::fromArray($array, $options);
  • new CsvParser($iterator, $options);

可用的选项有

测试

只需运行phpunit(需要PHPUnit)

作者

Kazuyuki Hayashi (@kzykhys)

变更日志

CHANGELOG

许可证

MIT许可证