Download the PHP package csanquer/colibri-csv without Composer
On this page you can find all versions of the php package csanquer/colibri-csv. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package colibri-csv
CSanquer ColibriCSV
LOOKING FOR NEW MAINTAINER
A lightweight, simple and performant CSV Reader/Writer PHP 5.4+ Library, inspired from Python CSV Module. Fully Tested, very memory efficient and able to parse/write CSV files that weigh over 100 Mb.
This is a fork of Spyrit LightCSV library, I have developed previously in this company.
Installation
-
get composer http://getcomposer.org/ and install dependencies
-
add "https://packagist.org/packages/csanquer/colibri-csv" package to your composer.json file require section
-
install dependencies
- include vendor/autoload.php
How To
Read
Instanciate a new CSVReader with the following CSV parameters:
- field delimiter (default for Excel = ; )
- field enclosure character (default for Excel = " )
- character encoding = (default for Excel = CP1252 )
- end of line character (default for Excel = "\r\n" )
- escape character (default for Excel = "\" )
- first_row_header : (default for excel = false) use the first CSV row as header
- UTF8 BOM (default false) force removing BOM
- transliteration (default for Excel = null ) available options : 'translit', 'ignore', null
- force encoding detection (default for Excel = false )
- skip empty lines (default for Excel = false ) lines which all values are empty
- trim (default = false for Excel) trim all values
Write
Instanciate a new CSVWriter with the following CSV parameters:
- field delimiter (default for Excel = ; )
- field enclosure character (default for Excel = " )
- character encoding = (default for Excel = CP1252 )
- end of line character (default for Excel = "\r\n" )
- escape character (default for Excel = "\" )
- first_row_header : (default for excel = false) use the PHP keys as CSV headers and write a first row with them
- enclosing_mode (default = 'minimal'), possible values :
- all : always enclose string
- minimal : enclose string only if the delimiter, enclosure or line ending character is present
- nonumeric : enclose string only if the value is non numeric (other character than digits and dot)
- escape_double (default = true) if true double the enclosure to escape it, else escape it with escape character
- UTF8 BOM (default false) force writing BOM if encoding is UTF-8
- transliteration (default for Excel = null ) available options : 'translit', 'ignore', null
- trim (default = false for Excel) trim all values
Configuration : Dialect class
Instead of giving directly an array to the CsvReader or CsvWriter constructor, you can create a Dialect object, use setter methods to change parameters and pass it to the CsvReader (or CsvWriter) :
Be careful, the options 'force_encoding_detect', 'skip_empty' and 'trim' decrease significantly the performances
Requirements
- PHP >= 5.4
- extension mbstring
Suggested :
- extension iconv
Tests
run unit tests with phpunit :
run benchmark test :
Licensing
This library is a Fork of Spyrit LightCSV
License LGPL 3
- Copyright (C) 2012-2013 Spyrit Systeme (Spyrit LightCSV)
- Copyright (C) 2014 Charles Sanquer
This file is part of ColibriCSV.
ColibriCSV is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
ColibriCSV is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with ColibriCSV. If not, see http://www.gnu.org/licenses/.