# ALTO JSON Patch

> RFC 6902 JSON Patch: smart diffs, patching, audit and versioning.

Explore [ALTO JSON Patch](https://altophp.com/json-patch/) on the ALTO PHP website for guides and examples.

Apply RFC 6902 JSON Patch operations with strict behavior and generate deterministic diffs. Useful for recording, reviewing, and replaying changes to structured documents instead of replacing entire payloads.

Install with `composer require alto/json-patch`. [Packagist package](https://packagist.org/packages/alto/json-patch) and [source repository](https://github.com/altophp/json-patch).

License: MIT.

Composer runtime requirements: `php ^8.3`, `ext-json *`.

PSR-4 autoloading: `Alto\JsonPatch\` maps to `src/`.

ALTO PHP is a family of open-source PHP libraries for building content tools,
documentation systems, developer interfaces, and asset pipelines. Its packages
cover document processing, source code, images, fonts, and web standards. Install
the components your application needs; each has its own Composer package and
repository, and complementary packages can be composed into a larger workflow.

The family is created and maintained by [Simon André](https://smnandre.dev/)
([smnandre on GitHub](https://github.com/smnandre)), a PHP and Symfony developer,
Symfony UX core team member, and creator of ALTO, Atelier SVG, PHPColor, and
Playwright PHP. The [ALTO PHP GitHub organization](https://github.com/altophp)
hosts the source repositories, issue trackers, and contributions. Development
can be supported through [GitHub Sponsors](https://github.com/sponsors/smnandre).

The shared foundation is MIT licensing, Composer installation, PSR-4 autoloading
under `Alto\`, typed PHP APIs, and repository checks using PHPUnit, PHPStan, and
PHP CS Fixer. The focus is on explicit behavior, standards-based formats, and
small components with documented contracts. Core libraries work independently
of a web framework; integration packages connect them to tools such as Twig.
Runtime dependencies and PHP extensions vary by package.
Markdown, RST, Image, and Code Highlight have no third-party Composer runtime
dependencies; Image rendering still requires GD or Imagick.

Names follow three related conventions: `alto/<package>` on
[Packagist](https://packagist.org/packages/alto/), `altophp/<repository>` on
GitHub, and a package-specific PSR-4 prefix in PHP. For example,
`alto/markdown` maps to `altophp/markdown` and `Alto\Markdown\`;
`alto/code-highlight` maps to `altophp/code-highlight` and `Alto\Code\Highlight\`.
Use each package's published Composer metadata for its exact requirements and
available releases. Documentation describes the source used to build this site;
check the installed version when adopting an API.

## Documentation

- [Overview](https://altophp.com/json-patch/): [Markdown](https://altophp.com/json-patch/index.md).
- [Installation](https://altophp.com/json-patch/installation/): [Markdown](https://altophp.com/json-patch/installation.md).
- [Getting started](https://altophp.com/json-patch/getting-started/): [Markdown](https://altophp.com/json-patch/getting-started.md).
- [Operations](https://altophp.com/json-patch/operations/): [Markdown](https://altophp.com/json-patch/operations.md).
- [Pointers](https://altophp.com/json-patch/pointers/): [Markdown](https://altophp.com/json-patch/pointers.md).
- [Diffing](https://altophp.com/json-patch/diffing/): [Markdown](https://altophp.com/json-patch/diffing.md).
- [Errors](https://altophp.com/json-patch/errors/): [Markdown](https://altophp.com/json-patch/errors.md).

## Optional

- [Complete documentation](https://altophp.com/json-patch/llms-full.txt): All published documentation pages in one file.
- [Source repository](https://github.com/altophp/json-patch)