Csv data manipulation made easy in PHP

Installs: 426 908

Dependents: 51

Stars: 678

Watchers: 33

Forks: 87

Open Issues: 2

7.2.0 2015-11-02 07:36 UTC


Latest Version Software License Build Status HHVM 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 League\Csv but the latest stable version of PHP/HHVM is recommended.


Install League\Csv using Composer.

$ composer require league/csv


If you are on a Mac OS X Server, add the following lines before using the library to help PHP detect line ending in Mac OS X.

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


League\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.