phpcsvj

PHP reader and writer for CSVJ files. PHP 8.2+.

Overview

CSVJ is a tabular data format where each value is a JSON literal. The spec is at https://csvj.org; the Go reference implementation lives at csvj-org/gocsvj, the JavaScript reference at csvj-org/jscsvj, and the language-agnostic conformance suite at csvj-org/conformance.

The reader enforces every §1 rule (empty input rejected; trailing newline required; ragged rows rejected; duplicate header names rejected; only string | int | float | bool | null permitted at value position; JSON lexical rules per RFC 8259) and passes all 25 vectors of csvj-org/conformance@master.

Parse

use Csvj\Csvj;

$table = Csvj::parse("\"name\",\"age\"\n\"alice\",30\n\"bob\",null\n");
// [
//   'header' => ['name', 'age'],
//   'rows'   => [
//     ['alice', 30],
//     ['bob', null],
//   ],
// ]

The returned array has a header key (list<string>, zero or more column names) and a rows key (list<list<mixed>>) where every row has exactly count($header) values. Each value is string, int, float, bool, or null.

Parsing rejects every input the spec says must be rejected — see the conformance suite for the full list. Invalid input raises Csvj\ParseError.

Serialize

use Csvj\Csvj;

$bytes = Csvj::stringify([
    'header' => ['name', 'age'],
    'rows' => [
        ['alice', 30],
        ['bob', null],
    ],
]);
// "\"name\",\"age\"\n\"alice\",30\n\"bob\",null\n"

The output is always spec-compliant CSVJ: terminated by \n, every row has exactly count($header) values, and every value is encoded as a JSON literal.

Install

composer require csvj-org/phpcsvj

(Not yet published to Packagist — see PLAN.md §6d for the publication checklist.)

License

MIT — see LICENSE.