lindelius/php-json-patch

A zero-dependency PHP implementation of JSON Patch

0.1.1 2021-07-14 21:24 UTC

Requires

• php: ^7.4||^8.0
• ext-json: *

Requires (Dev)

• php-coveralls/php-coveralls: ^2.0
• phpunit/phpunit: ^9.5

Apache-2.0

• json
• json patch

README

A zero-dependency PHP implementation of JSON Patch (RFC 6902).

Table of Contents

• Requirements
• Installation
• Usage
  • Protected Paths

Requirements

• PHP 7.4, or higher

Installation

If you are using Composer, you may install the latest version of this library by running the following command from your project's root folder:

composer require lindelius/php-json-patch

You may also manually download the library by navigating to the "Releases" page and then expanding the "Assets" section of the latest release.

Usage

Given a set of JSON Patch operations...

[
    { "op": "test", "path": "/name", "value": "Anakin Skywalker" },
    { "op": "replace", "path": "/name", "value": "Darth Vader" },
    { "op": "add", "path": "/order", "value": "Sith" },
    { "op": "move", "from": "/friends", "path": "/foes" }
]

And a document...

{
    "name": "Anakin Skywalker",
    "friends": ["Obi-Wan Kenobi", "Ahsoka Tano"],
    "order": "Jedi"
}

You can (atomically) apply the patches through one of the PatcherInterface methods...

// Option 1: Provide the raw JSON string
$newDocument = $patcher->patchFromJson($documentAsArray, $operationsAsJson);

// Option 2: Provide the JSON Patch operations in array format
$newDocument = $patcher->patch($documentAsArray, $operationsAsArray);

And get a new document back :)

{
    "name": "Darth Vader",
    "foes": ["Obi-Wan Kenobi", "Ahsoka Tano"],
    "order": "Sith"
}

Protected Paths

This library has built-in support for registering "protected paths", which are paths that may not be modified by any patch operation. Protected paths will indirectly also block modifications to their parent path(s) and any child paths.

$patcher->addProtectedPath("/id");
$patcher->addProtectedPath("/created_at");
$patcher->addProtectedPath("/some/nested/path");

Please note that "test" operations can still operate on a protected path since they are not actually modifying the document.