Csv data manipulation made easy in PHP

Installs: 259 535

Dependents: 44

Stars: 575

Watchers: 32

Forks: 68

Open Issues: 4

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');


Csv has a PHPUnit test suite. To run the tests, run the following command from the project folder:

$ phpunit


Contributions are welcome and will be fully credited. Please see CONTRIBUTING 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.