NSY Json Library — User Tutorial

Native JSON helper at System/Libraries/Json.php (namespace System\Libraries, class Json). All methods are static.

Table of Contents

1. Quick Start
2. Reading & Writing Files
3. Encode & Decode
4. Quick Reference

Quick Start

use System\Libraries\Json;

// Read
$config = Json::read('storage/app.json');          // array
$object = Json::read('storage/app.json', false);   // stdClass

// Write (atomic)
Json::write('storage/app.json', ['theme' => 'dark']);

Reading & Writing Files

Json::has('storage/app.json');                     // bool
$data = Json::read('storage/app.json');            // mixed (throws if malformed)
Json::write('storage/app.json', ['a' => 1]);       // bool — atomic

write() encodes to a sibling *.tmp file, then rename()s it into place, so a crash never leaves a partially written file. Missing parent directories are created.

Encode & Decode

$json = Json::encode(['a' => 1]);                  // pretty + unicode
$json = Json::encode(['a' => 1], 0);               // '{"a":1}'
$data = Json::decode('{"a":1}');                   // ['a' => 1]
$obj  = Json::decode('{"a":1}', false);            // stdClass

encode() and decode() throw InvalidArgumentException on failure instead of returning false.

Quick Reference

Related source: System/Libraries/Json.php. Tests: System/Test/Libraries/JsonTest.php.