1. class
  2. JsonBrowser
  3. \
  4. JsonBrowser

JsonBrowser

class JsonBrowser implements IteratorAggregate

Helper class for working with JSON-encoded data

Constants

OPT_NONEXISTENT_EXCEPTIONS

Throw exceptions instead of using NULL for nonexistent children & siblings
OPT_GET_VALUE

Get node value instead of JsonBrowser object for __get()
OPT_DECODE

Treat the document definition passed to the constructor as JSON, and decode it
OPT_DEFAULT

Default config options [none]
ERR_DECODING_ERROR

Error decoding JSON data
ERR_UNKNOWN_TYPE

Encountered an unknown type
ERR_UNKNOWN_CHILD

Unknown child
ERR_UNKNOWN_SIBLING

Unknown sibling
ERR_UNKNOWN_SELF

Unknown self
ERR_INVALID_CONTAINER_TYPE

Invalid container type
ERR_UNKNOWN_TARGET

Unknown target
TYPE_NULL

NULL type
TYPE_BOOLEAN

Boolean type
TYPE_STRING

String type
TYPE_NUMBER

Number type
TYPE_INTEGER

Integer type (subset of TYPE_NUMBER)
TYPE_ARRAY

Array type
TYPE_OBJECT

Object type

Methods

__construct(int $options = self::OPT_DEFAULT, mixed $document = null)

Create a new instance

__get(JsonBrowser|mixed $key)

Dynamically get child nodes or values as object properties

__set(mixed $key, mixed $value)

Dynamically set child node values as object properties

JsonBrowser
asRoot()

Get the current node as a document root

attach(mixed $document)

Attach to an existing decoded document

bool
childExists(mixed $key)

Check whether a child element exists

deleteValue(bool $deleteEmpty = false)

Delete the current node value

deleteValueAt(string $path, bool $deleteEmpty = false)

Delete the value at a given path

mixed
getAnnotation(string $name)

Get single node annotation

array
getAnnotations(string $name = null)

Get node annotations

JsonBrowser
getChild(mixed $key)

Get a child node

Iterator
getIterator()

Get an iterator handle

string
getJSON(int $options = \JSON_PRETTY_PRINT | \JSON_UNESCAPED_SLASHES | \JSON_UNESCAPED_UNICODE)

Get the JSON source for the current node

mixed
getKey()

Get the node index key (i.e. the child name within the parent node)

JsonBrowser
getNodeAt(string $path)

Get the node at a given path

JsonBrowser|null
getParent()

Get parent node

string
getPath()

Get the node path

JsonBrowser
getRoot()

Get root node

JsonBrowser
getSibling(mixed $key)

Get a sibling node

int
getType()

Get the document value type

mixed
getValue()

Get the node value

mixed
getValueAt(string $path)

Get the value at a given path

bool
isEqualTo(JsonBrowser|mixed $value)

Test whether the document value is equal to a given value

bool
isNotType(int $types)

Test whether the document value is not of a given type

bool
isType(int $types, bool $all = false)

Test whether the document value is of a given type

loadJSON(string $json)

Load document from a JSON string

bool
nodeExists()

Check whether the current node exists in the parent document

setAnnotation(string $name, mixed $value, bool $clear = false)

Set a node annotation

setValue(mixed $value, bool $padSparseArray = false)

Set the node value

setValueAt(string $path, mixed $value, bool $padSparseArray = false)

Set the value at a given path

bool
siblingExists(mixed $key)

Check whether a sibling exists

Details

at line 90
__construct(int $options = self::OPT_DEFAULT, mixed $document = null)

Create a new instance

Parameters

int $options Configuration options (bitmask)
mixed $document Reference to the default document

at line 107
__get(JsonBrowser|mixed $key)

Dynamically get child nodes or values as object properties

Parameters

JsonBrowser|mixed $key Index key

at line 126
__set(mixed $key, mixed $value)

Dynamically set child node values as object properties

Will set the value on a child node, but will not pad sparse arrays.

Parameters

mixed $key Index key
mixed $value Value data to set

at line 138
JsonBrowser asRoot()

Get the current node as a document root

Return Value

JsonBrowser A new JsonBrowser instance pointing to the current node

at line 154
attach(mixed $document)

Attach to an existing decoded document

Parameters

mixed $document Reference to the target document

at line 167
bool childExists(mixed $key)

Check whether a child element exists

Parameters

mixed $key Index key

Return Value

bool Whether the given child exists

at line 179
deleteValue(bool $deleteEmpty = false)

Delete the current node value

Parameters

bool $deleteEmpty Whether to delete empty containers

at line 192
deleteValueAt(string $path, bool $deleteEmpty = false)

Delete the value at a given path

Parameters

string $path JSON pointer to the node that should be deleted
bool $deleteEmpty Whether to delete empty containers

at line 205
mixed getAnnotation(string $name)

Get single node annotation

Parameters

string $name Annotation name

Return Value

mixed Most recently-set annotation matching the given name, or null if not set

at line 219
array getAnnotations(string $name = null)

Get node annotations

Parameters

string $name Annotation name

Return Value

array Array of annotations matching $name, or an associative array of all annotations

at line 232
JsonBrowser getChild(mixed $key)

Get a child node

Parameters

mixed $key Index key

Return Value

JsonBrowser Child node

at line 251
Iterator getIterator()

Get an iterator handle

Return Value

Iterator Iterator instance

at line 264
string getJSON(int $options = \JSON_PRETTY_PRINT | \JSON_UNESCAPED_SLASHES | \JSON_UNESCAPED_UNICODE)

Get the JSON source for the current node

Parameters

int $options Bitwise options for json_encode()

Return Value

string Encoded JSON string

at line 276
mixed getKey()

Get the node index key (i.e. the child name within the parent node)

Return Value

mixed Index key within parent node, or null if this is the root

at line 289
JsonBrowser getNodeAt(string $path)

Get the node at a given path

Parameters

string $path JSON pointer to the requested node

Return Value

JsonBrowser Node at the target path

at line 308
JsonBrowser|null getParent()

Get parent node

Return Value

JsonBrowser|null Parent node

at line 328
string getPath()

Get the node path

Return Value

string The node path as a JSON pointer

at line 340
JsonBrowser getRoot()

Get root node

Return Value

JsonBrowser Root node

at line 353
JsonBrowser getSibling(mixed $key)

Get a sibling node

Parameters

mixed $key Index key

Return Value

JsonBrowser Sibling node

at line 374
int getType()

Get the document value type

Return Value

int Bitmask list of applicable types (See JsonBrowser::TYPE_* constants)

at line 416
mixed getValue()

Get the node value

Return Value

mixed Node value

at line 435
mixed getValueAt(string $path)

Get the value at a given path

Parameters

string $path JSON pointer to the requested node

Return Value

mixed Value at the given path

at line 459
bool isEqualTo(JsonBrowser|mixed $value)

Test whether the document value is equal to a given value

Comparisons considered equal: - normal strictly-typed equality (===); - loosely-typed equality (==) where both values are numeric and are not strings; - any object having the same number and value for all properties, as per the above tests.

Parameters

JsonBrowser|mixed $value Value to compare against

Return Value

bool Whether the node value is equal to $value

at line 478
bool isNotType(int $types)

Test whether the document value is not of a given type

Parameters

int $types Types to test for

Return Value

bool Whether the type does not match

at line 492
bool isType(int $types, bool $all = false)

Test whether the document value is of a given type

Parameters

int $types Types to test for
bool $all Whether to require all types, or just one

Return Value

bool Whether the type matches

at line 507
loadJSON(string $json)

Load document from a JSON string

Parameters

string $json JSON-encoded document

at line 540
bool nodeExists()

Check whether the current node exists in the parent document

Return Value

bool Whether the current node exists

at line 554
setAnnotation(string $name, mixed $value, bool $clear = false)

Set a node annotation

Parameters

string $name Annotation name
mixed $value Annotation value
bool $clear Clear existing annotations with the same name

at line 567
setValue(mixed $value, bool $padSparseArray = false)

Set the node value

Parameters

mixed $value Data to set
bool $padSparseArray Whether to left-pad sparse arrays with null values

at line 581
setValueAt(string $path, mixed $value, bool $padSparseArray = false)

Set the value at a given path

Parameters

string $path JSON pointer to the requested node
mixed $value Data to set
bool $padSparseArray Whether to left-pad sparse arrays with null values

at line 594
bool siblingExists(mixed $key)

Check whether a sibling exists

Parameters

mixed $key Index key

Return Value

bool Whether the sibling exists