gamringer/php-json-pointer

PHP JSON Pointer (RFC6901) implementation

JSONPointer

, _(*1)

, _(*2)

, _(*3)

, _(*4)

A RFC6901 compliant JSON Pointer PHP implementation, _(*5)

License

JSONPointer is licensed under the MIT license., _(*6)

Installation

composer require gamringer/php-json-pointer

Tests

composer install
phpunit

Documentation

Testing a value for existence

<?php

$target = [
  "foo" => ["bar", "baz"],
  "qux" => "quux"
];

$pointer = new \gamringer\JSONPointer\Pointer($target);

var_dump($pointer->has("/foo"));

/* Results:

bool(true)

*/

Retrieving a value that does not exist will return false, _(*7)

<?php

$target = [
  "qux" => "quux"
];

$pointer = new \gamringer\JSONPointer\Pointer($target);

var_dump($pointer->has("/foo"));

/* Results:

bool(false)

*/

Retrieving a value

<?php

$target = [
    "foo" => ["bar", "baz"],
    "qux" => "quux"
];

$pointer = new \gamringer\JSONPointer\Pointer($target);

var_dump($pointer->get("/foo"));

/* Results:

array(2) {
  [0] =>
  string(3) "bar"
  [1] =>
  string(3) "baz"
}

*/

Retrieving a value that does not exist will throw an exception, _(*8)

<?php

$target = [
    "qux" => "quux"
];

$pointer = new \gamringer\JSONPointer\Pointer($target);

var_dump($pointer->get("/foo"));

/* Results:

Throws gamringer\JSONPointer\Exception

*/

Inserting a value

Inserting a value will returns a VoidValue object if used on an indexed array., _(*9)

<?php

$target = [
    "foo" => ["bar", "baz"],
    "qux" => "quux"
];

$pointer = new \gamringer\JSONPointer\Pointer($target);

$value = "waldo";
var_dump($pointer->insert("/foo/1", $value));
var_dump($pointer->get("/foo"));

/* Results:

class gamringer\JSONPointer\VoidValue#6 (2) {
  protected $owner =>
  array(3) {
    ...
  }
  protected $target =>
  string(1) "1"
}
array(3) {
  [0] =>
  string(3) "bar"
  [1] =>
  string(5) "waldo"
  [2] =>
  string(3) "baz"
}

*/

If used on anything else, it will behave in the exact same way as get(), _(*10)

<?php

$target = [
    "foo" => ["bar", "baz"],
    "qux" => "quux"
];

$pointer = new \gamringer\JSONPointer\Pointer($target);

$value = "waldo";
var_dump($pointer->insert("/foo", $value));
var_dump($pointer->get("/foo"));

/* Results:

array(2) {
  [0] =>
  string(3) "bar"
  [1] =>
  string(3) "baz"
}
string(5) "waldo"

*/

Setting a value

Setting a value returns the content previously at that path, _(*11)

<?php

$target = [
    "foo" => ["bar", "waldo", "baz"],
    "qux" => "quux"
];

$pointer = new \gamringer\JSONPointer\Pointer($target);

$value = "corge";
var_dump($pointer->set("/foo", $value));

/* Results:

array(3) {
  [0] =>
  string(3) "bar"
  [1] =>
  string(5) "waldo"
  [2] =>
  string(3) "baz"
}

*/

If the path was attainable, but not set, it will return a VoidValue, _(*12)

<?php

$target = [
    "foo" => ["bar", "waldo", "baz"],
    "qux" => "quux"
];

$pointer = new \gamringer\JSONPointer\Pointer($target);

$value = "garply";
var_dump($pointer->set("/grault", $value));

/* Results:

class gamringer\JSONPointer\VoidValue#6 (2) {
  protected $owner =>
  array(3) {
    ...
  }
  protected $target =>
  string(6) "grault"
}

*/

Remove a value

Removing a value returns the content previously at that path, _(*13)

<?php

$target = [
    "foo" => ["bar", "waldo", "baz"],
    "qux" => "quux"
];

$pointer = new \gamringer\JSONPointer\Pointer($target);

var_dump($pointer->remove("/qux"));

/* Results:

string(4) "quux"

*/

Removing a value that does not exist will throw an exception, _(*14)

<?php

$target = [
    "foo" => ["bar", "waldo", "baz"],
];

$pointer = new \gamringer\JSONPointer\Pointer($target);

var_dump($pointer->remove("/qux"));

/* Results:

Throws gamringer\JSONPointer\Exception

*/

Operations affect the original object

This affects Remove Operations, _(*15)

<?php

$target = [
  "foo" => ["bar", "waldo", "baz"],
  "qux" => "quux"
];

$pointer = new \gamringer\JSONPointer\Pointer($target);
$pointer->remove("/qux");

var_dump($target);

/* Results:

array(1) {
  'foo' =>
  array(3) {
    [0] =>
    string(3) "bar"
    [1] =>
    string(5) "waldo"
    [2] =>
    string(3) "baz"
  }
}

*/

This also affects Add Operations, _(*16)

<?php

$target = [
  "foo" => ["bar", "waldo", "baz"],
  "qux" => "quux"
];

$value = "bar";
$pointer = new \gamringer\JSONPointer\Pointer($target);
$pointer->set("/foo", $value);

var_dump($target);

/* Results:

array(2) {
  'foo' =>
  string(3) "bar"
  'qux' =>
  string(4) "quux"
}

*/