Csv data manipulation made easy in PHP

8.1.1 2016-09-05 08:16 UTC


Latest Version Software License Build Status Coverage Status Quality Score Total Downloads

Csv is a simple library to ease CSV parsing, writing and filtering in PHP. The goal of the library is to be powerful while remaining lightweight, by utilizing PHP native classes whenever possible.


  • Simple API
  • Read and Write to CSV documents in a memory efficient and scalable way
  • Use SPL to interact with the CSV documents
  • Support PHP Stream filtering capabilities
  • Transform CSV documents into popular format (JSON, XML or HTML)
  • Fully documented
  • Fully unit tested
  • Framework-agnostic
  • Composer ready, PSR-2 and PSR-4 compliant


Full documentation can be found at csv.thephpleague.com. Contribute to this documentation in the gh-pages branch

System Requirements

You need PHP >= 5.5.0 and the mbstring extension to use Csv but the latest stable version of PHP is recommended.


Install Csv using Composer.

$ composer require league/csv


Warning: If your CSV document was created or is read on a Macintosh computer, add the following lines before using the library to help PHP detect line ending.

if (!ini_get("auto_detect_line_endings")) {
    ini_set("auto_detect_line_endings", '1');


Csv has a PHPUnit test suite and a coding style compliance test suite using PHP CS Fixer. To run the tests, run the following command from the project folder.

$ composer test


Contributions are welcome and will be fully credited. Please see CONTRIBUTING and CONDUCT for details.


If you discover any security related issues, please email nyamsprod@gmail.com instead of using the issue tracker.



The MIT License (MIT). Please see LICENSE for more information.