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()
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 = 0)

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

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

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 83
__construct(int $options = 0)

Create a new instance

Parameters

int $options Configuration options (bitmask)

at line 97
__get(JsonBrowser|mixed $key)

Dynamically get child nodes or values as object properties

Parameters

JsonBrowser|mixed $key Index key

at line 116
__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 128
JsonBrowser asRoot()

Get the current node as a document root

Return Value

JsonBrowser A new JsonBrowser instance pointing to the current node

at line 144
attach(mixed $document)

Attach to an existing decoded document

Parameters

mixed $document Reference to the target document

at line 157
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 169
deleteValue(bool $deleteEmpty = false)

Delete the current node value

Parameters

bool $deleteEmpty Whether to delete empty containers

at line 182
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 195
JsonBrowser getChild(mixed $key)

Get a child node

Parameters

mixed $key Index key

Return Value

JsonBrowser Child node

at line 214
Iterator getIterator()

Get an iterator handle

Return Value

Iterator Iterator instance

at line 227
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 239
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 252
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 271
JsonBrowser|null getParent()

Get parent node

Return Value

JsonBrowser|null Parent node

at line 291
string getPath()

Get the node path

Return Value

string The node path as a JSON pointer

at line 303
JsonBrowser getRoot()

Get root node

Return Value

JsonBrowser Root node

at line 316
JsonBrowser getSibling(mixed $key)

Get a sibling node

Parameters

mixed $key Index key

Return Value

JsonBrowser Sibling node

at line 337
int getType()

Get the document value type

Return Value

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

at line 379
mixed getValue()

Get the node value

Return Value

mixed Node value

at line 398
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 422
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 441
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 455
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 470
loadJSON(string $json)

Load document from a JSON string

Parameters

string $json JSON-encoded document

at line 503
bool nodeExists()

Check whether the current node exists in the parent document

Return Value

bool Whether the current node exists

at line 516
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 530
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 543
bool siblingExists(mixed $key)

Check whether a sibling exists

Parameters

mixed $key Index key

Return Value

bool Whether the sibling exists