CSV data manipulation made easy in PHP

Fund package maintenance!

Installs: 36 184 214

Dependents: 466

Suggesters: 75

Security: 0

Stars: 2 829

Watchers: 62

Forks: 288

Open Issues: 0

9.7.2 2021-10-05 19:41 UTC


Latest Version Software License Build 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
  • Support PHP stream filtering capabilities
  • Transform CSV documents into popular format (JSON, XML or HTML)
  • Fully documented
  • Fully unit tested
  • Framework-agnostic


Full documentation can be found at csv.thephpleague.com.

System Requirements

You need PHP >= 7.3 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');


League\Csv has a :

  • a PHPUnit test suite
  • a coding style compliance test suite using PHP CS Fixer.
  • a code analysis compliance test suite using PHPStan.

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.


Please see CHANGELOG for more information on what has changed recently.



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