PHPackages                             php-alchemist/json - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. php-alchemist/json

ActiveLibrary[Utility & Helpers](/categories/utility)

php-alchemist/json
==================

Collection of services for JSON functionality

v1.0.0(1y ago)01[1 PRs](https://github.com/PHP-Alchemist/json/pulls)BSD-3-ClausePHPPHP >=8.4CI passing

Since Jun 26Pushed 2w agoCompare

[ Source](https://github.com/PHP-Alchemist/json)[ Packagist](https://packagist.org/packages/php-alchemist/json)[ RSS](/packages/php-alchemist-json/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (1)Dependencies (5)Versions (3)Used By (0)

PHP Alchemist JSON
==================

[](#php-alchemist-json)

Package: `php-alchemist/json`Current Version: v1.x -- (2025/06)

What?
-----

[](#what)

A basic library for working with json and being able to map json objects to a particular class

[![Unit Tests](https://github.com/PHP-Alchemist/json/actions/workflows/php.yml/badge.svg)](https://github.com/PHP-Alchemist/json/actions/workflows/php.yml)[![StyleCI](https://camo.githubusercontent.com/657b4831ac55094a5fc5b2cea85b784fb484d7f9f0029043949e123b8c3930dc/68747470733a2f2f6769746875622e7374796c6563692e696f2f7265706f732f313030373237373232362f736869656c643f6272616e63683d6d6173746572)](https://github.styleci.io/repos/1007277226?branch=master)
[![Quality Gate Status](https://camo.githubusercontent.com/839773d1b3f1d206c245f08762f375cdd86e6ca8f590cafc2d0c2473dfe14409/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d5048502d416c6368656d6973745f6a736f6e266d65747269633d616c6572745f737461747573)](https://sonarcloud.io/summary/new_code?id=PHP-Alchemist_json)

Usage
-----

[](#usage)

The PHP Alchemist JSON library consists of two parts that can be used together or separately.

### JsonHydratorTrait

[](#jsonhydratortrait)

The first is a trait `PHPAlchemist\Json\Trait\JsonHydratorTrait` which has a single function called `hydrateFromJson()` which accepts a string called `$json` which is expected to be a JSON object. It then will loop through the object and looks for setter functions or if the property exists for each key and then sets the data appropriately on the object.

### JsonMapper

[](#jsonmapper)

The second is `PHPAlchemist\Json\Service\JsonMapper` which has a `map()` functino which will accept a JSON string (`$json`) and a classname (`$class`). This will validate the JSON and throw a `PHPAlchemist\Json\Exception\BadJsonException` if it is invalid. It will then instantiate a new class of the given type, check to see if the `hydrateFromJson()` exists. If it does, then it will use that otherwise it will then go through the same process to set the JSON keys via setter or public access.

#### Example

[](#example)

```
class Demo {
  public string $test;
  public string $doSomething;
}

$json   = '{"test":"blah","doSomething":"asdf"}';
$mapper = new PHPAlchemist\Json\Service\JsonMapper();
$asdf   = $mapper->map($json, Demo::class);

var_dump($asdf);
```

OUTPUT:

```
object(Demo)#1 (2) {
  ["test"]=>
  string(4) "blah"
  ["doSomething"]=>
  string(4) "asdf"
}
```

###  Health Score

37

—

LowBetter than 81% of packages

Maintenance74

Regular maintenance activity

Popularity1

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 82.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

418d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/1f32ae1f0bf9491a59f474478c6344e37034667512769884f00d31c8d1568757?d=identicon)[druid628](/maintainers/druid628)

---

Top Contributors

[![druid628](https://avatars.githubusercontent.com/u/522820?v=4)](https://github.com/druid628 "druid628 (23 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (5 commits)")

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/php-alchemist-json/health.svg)

```
[![Health](https://phpackages.com/badges/php-alchemist-json/health.svg)](https://phpackages.com/packages/php-alchemist-json)
```

###  Alternatives

[igorw/get-in

Functions for hash map (assoc array) traversal.

39513.5M28](/packages/igorw-get-in)[tochka-developers/work-calendar

Russian Federation production calendar extension for Carbon

1927.6k](/packages/tochka-developers-work-calendar)[v17development/flarum-user-badges

Adds user badges to your Flarum community

1923.6k3](/packages/v17development-flarum-user-badges)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)