JSON Wrapper

Encoding

<?php

function \Arokettu\Json\Json::encode(
    mixed $value,
    int|\Arokettu\Json\EncodeOptions $options =
        JSON_THROW_ON_ERROR |
        JSON_UNESCAPED_SLASHES |
        JSON_UNESCAPED_UNICODE,
    int $depth = 512,
): string;

Main features:

• JSON_THROW_ON_ERROR is enforced

• Two convenience constants:

  <?php
  
  const \Arokettu\Json\Json::ENCODE_DEFAULT =
      JSON_THROW_ON_ERROR |
      JSON_UNESCAPED_SLASHES |
      JSON_UNESCAPED_UNICODE;
  const \Arokettu\Json\Json::ENCODE_PRETTY =
      JSON_THROW_ON_ERROR |
      JSON_UNESCAPED_SLASHES |
      JSON_UNESCAPED_UNICODE |
      JSON_PRETTY_PRINT;
  

Decoding

Changed in version 1.3.0: ArrayObject now has ARRAY_AS_PROPS enabled

<?php

function \Arokettu\Json\Json::decode(
    string $json,
    int|\Arokettu\Json\DecodeOptions $options = JSON_THROW_ON_ERROR,
    int $depth = 512,
): mixed;

Main features:

• JSON_THROW_ON_ERROR is enforced

• Pass JSON_OBJECT_AS_ARRAY to get associative arrays

• JSON objects are decoded to instances of ArrayObject instead of stdClass when parsed as objects

Force decoding objects as associative arrays:

<?php

function \Arokettu\Json\Json::decodeToArray(
    string $json,
    int|\Arokettu\Json\DecodeOptions $options = JSON_THROW_ON_ERROR,
    int $depth = 512,
): mixed;

Force decoding objects as instances of ArrayObject:

<?php

function \Arokettu\Json\Json::decodeToObject(
    string $json,
    int|\Arokettu\Json\DecodeOptions int $options = JSON_THROW_ON_ERROR,
    int $depth = 512,
): mixed;

Post-processor

Added in version 2.0: Exposed to public

If you have a library that does json decoding internally and you just want to post-process its output from stdClass to ArrayObject or array:

<?php

function \Arokettu\Json\Json::stdClassToArrayObject(
    mixed $value,
): mixed;

function \Arokettu\Json\Json::stdClassToArray(
    mixed $value,
): mixed;

Example:

<?php

use Arokettu\Json\Json;

$internallyDecoded = json_decode('{"a": 123}'); // output from some lib
var_dump($internallyDecoded->a); // 123
var_dump($internallyDecoded['a']); // Error!
$decoded = Json::stdClassToArrayObject($internallyDecoded);
var_dump($decoded['a']); // 123