CSV Parser (PHP)

PHP client to parse CSV data from a path, file, stream, resource or string into indexed or associative arrays., _(*1)

Namespaces were added in v2.0.2 so make sure you update your code before migrating from an older version., _(*2)

Install

Install using composer, _(*3)

#composer.json

{
  "require": {
    "jabranr/csv-parser": "~2.1.*"
  }
}

Run following to install, _(*4)

$ comsposer install

Use

Initiate a new instance, _(*5)

$csv = new Jabran\CSV_Parser();

API

Get data from a string, _(*6)

/* @param: string $str */
$csv->fromString($str);

Get data from a stream (Will be deprecated in future), _(*7)

/* @param: resource $stream (f.e. php://input) */
$csv->fromStream($stream);

Get data from a resource (Since v2.0.2), _(*8)

/* @param: resource $resource (f.e. resource created using fopen()) */
$csv->fromResource($resource);

Get data from a file path (Will be deprecated in future), _(*9)

/* @param: string $file */
$csv->fromFile($file);

Get data from a path/URL (Since v2.0.2), _(*10)

/* @param: string $path */
$csv->fromPath($path);

Parse data for output, _(*11)

/**
 * Set $headers true/false to include top/first row
 * and output an associative array
 *
 * @param: boolean $headers (Default: true)
 * @return: array
 */
$csv->parse($headers);

More useful methods (Since v2.0.2), _(*12)

/**
 * Set columns
 * @param array $columns
 * @return Jabran\CSV_Parser
 */
$csv->setColumns($columns);

/**
 * Set rows
 * @param array $rows
 * @return Jabran\CSV_Parser
 */
$csv->setRows($rows);

/**
 * Set headers
 * @param array $headers
 * @return Jabran\CSV_Parser
 */
$csv->setHeaders($headers);

/**
 * Get columns
 * @return array
 */
$csv->getColumns();

/**
 * Get rows
 * @return array
 */
$csv->getRows();

/**
 * Get headers
 * @return array
 */
$csv->getHeaders();

Example

Example input string, _(*13)

require 'path/to/vendor/autoload.php';

$csv = new Jabran\CSV_Parser;

$str = 'id,first_name,last_name;1,Jabran,Rafique';

$csv->fromString($str);

// Output with headers:
$csv->parse();

Array(
  [id] => 1,
  [first_name] => 'Jabran',
  [last_name] => 'Rafique'
)

// Output without headers:
$csv->parse(false);

Array(
  [0] => array(
    [0] => 'id',
    [1] => 'first_name',
    [2] => 'last_name'
 ),
  [1] => array(
    [0] => 1,
    [1] => 'Jabran',
    [2] => 'Rafique'
 )
)