teacup/json

Class which provides methods to en- and decode JSON.

0.2.0 2014-09-24 13:13 UTC

This package is auto-updated.

Last update: 2024-10-29 04:36:17 UTC


README

Usage

use Teacup\Json as Json;

//Encode.
Json::encode($value);

//Encode with options.
Json::encode($value, Json::HEX_AMP);
Json::encode($value, Json::HEX_AMP|Json::HEX_QUOT);

//Decode.
Json::decode($json);

//Get result as array.
Json::decode($json, true);

//Limit depth to 50.
Json::decode($json, false, 50);

Options

  • HEX_TAG: All < and > are converted to \u003C and \u003E. Available since PHP 5.3.0.
  • HEX_AMP: All &s are converted to \u0026. Available since PHP 5.3.0.
  • HEX_APOS: All ' are converted to \u0027. Available since PHP 5.3.0.
  • HEX_QUOT: All " are converted to \u0022. Available since PHP 5.3.0.
  • FORCE_OBJECT: Outputs an object rather than an array when a non-associative array is used. Especially useful when the recipient of the output is expecting an object and the array is empty.
  • NUMERIC_CHECK: Encodes numeric strings as numbers. Available since PHP 5.3.3.
  • BIGINT_AS_STRING: Encodes large integers as their original string value. Available since PHP 5.4.0.
  • JSON_PRETTY_PRINT: Use whitespace in returned data to format it. Available since PHP 5.4.0.
  • JSON_UNESCAPED_SLASHES: Don't escape /. Available since PHP 5.4.0.
  • JSON_UNESCAPED_UNICODE: Encode multibyte Unicode characters literally (default is to escape as \uXXXX). Available since PHP 5.4.0.

Errors

Json::encode() and Json::decode() are throwing RuntimeExceptions if an error occures.