Csv data manipulation made easy in PHP

Installs: 331 342

Dependents: 46

Stars: 632

Watchers: 30

Forks: 79

Open Issues: 5

Language: PHP

7.1.2 2015-06-10 11:12 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.4.0 or HHVM >= 3.2 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.