CSV Handling Component for PHP

This project aims to deliver an easy to use and free as in freedom php compontent for dealing with csv files (read and write).

This component is heavily influenced by jwage/easy-csv. It was mainly created because of missing compatibility with php 5.6 and no official packagist support from jwage/easy-csv.

The build status of the current master branch is tracked by Travis CI:

The scrutinizer status are:

The versioneye status is:

Take a look on openhub.net.

The current change log can be found here.

Benefits

• low and stable memory usage (give it a try by using benchmarkReader and benchmarkWriter)
• works with PHP 5.6 and above
• __invoke() implemented to use it as function
• unified reader and writer
• adapter to easy up migration from EasyCsv - 0.0.1 to this component
  • writer
  • reader
• usage of filters - control what comes in and what comes out
• reader
  • implemented iterator
  • readOne();
  • readMany();
  • readAll();
• writer
  • copy();
  • delete();
  • move();
  • truncate();
  • writeOne();
  • writeMany();
  • writeAll(); //truncates file and writes content

Install

By Hand

mkdir -p vendor/net_bazzline/php_component_csv
cd vendor/net_bazzline/php_component_csv
git clone https://github.com/bazzline/php_component_csv .

With Packagist

composer require net_bazzline/php_component_csv:dev-master

Usage

Reader

Read Content

$reader = newReader('my/file.csv');
//I am using json_encode() since there is no official and best way how to// output arrays on the command line.//read one lineechojson_encode($reader->readOne()) . PHP_EOL;
//read 10 linesforeach ($reader->readMany(10) as$line) {
echojson_encode($line) . PHP_EOL;
}
//read all linesforeach ($reader->readAll() as$line) {
echojson_encode($line) . PHP_EOL;
}

By Iteration

$reader = newReader('my/file.csv');
//I am using json_encode() since there is no official and best way how to// output arrays on the command line.if ($reader->hasHeadline()) {
echo'headlines: ' . json_encode($reader->readHeadline());
}
foreach ($readeras$line) {
echojson_encode($line) . PHP_EOL;
}

By Using As A Function

$reader = newReader('my/file.csv');
//I am using json_encode() since there is no official and best way how to// output arrays on the command line.while ($line = $reader()) {
echojson_encode($line) . PHP_EOL;
}

Writer

Write Content

By Iteration

//$headlines contains a php array//$lines contains a php array of arrays$writer = newWriter('my/file.csv');
$writer->writeHeadline($headlines);
foreach ($linesas$line) {
$writer->writeOne($line);
}

At Once

//$headlines contains a php array//$lines contains a php array of arrays$writer = newWriter('my/file.csv');
$writer->writeHeadline($headlines);
$writer->writeMany($lines);

By Using As A Function

//$line contains a php array//$lines contains a php array of arrays$writer = newWriter('my/file.csv');
$writer($line);
foreach ($linesas$line) {
$writer($line);
}

Truncate

$writer = newWriter('my/file.csv');
$writer->truncate();

Copy

$writer = newWriter('my/file.csv');
$writer->copy('my/my_first_copy.csv'); //writer will still write into "file.csv"$writer->copy('my/my_second_copy.csv', true); //writer will write in "my_second_copy.csv"

Move

$writer = newWriter('my/file.csv');
$writer->move('my/new_name.csv'); //writer will write in "new_name.csv"

API

API is available at bazzline.net.

Other Great Components

• goodby/csv
• thephpleague/csv
• keboola/php-csv
• ajgarlag/AiglCsv
• jwage/easy-csv
• swt83/php-csv

Hall of Fame - The list of contributors

• peter279k - homepage
• stevleibelt - homepage

Contributing

Please see CONTRIBUTING for details.

Final Words

Star it if you like it :-). Add issues if you need it. Pull patches if you enjoy it. Write a blog entry if you use it. Donate something if you love it :-].