PHPackages                             maaaarcel/devalue-php - 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. [Parsing & Serialization](/categories/parsing)
4. /
5. maaaarcel/devalue-php

ActiveLibrary[Parsing & Serialization](/categories/parsing)

maaaarcel/devalue-php
=====================

A library for stringifying and parsing complex data. Inspired by the devalue JavaScript library.

1.0.2(3y ago)16MITPHPPHP ^8.1

Since Jan 16Pushed 3y ago1 watchersCompare

[ Source](https://github.com/Maaaarcel/devalue-php)[ Packagist](https://packagist.org/packages/maaaarcel/devalue-php)[ Docs](https://github.com/Maaaarcel/devalue-php)[ RSS](/packages/maaaarcel-devalue-php/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (3)Dependencies (2)Versions (4)Used By (0)

devalue-php
===========

[](#devalue-php)

This is an PHP port of [devalue](https://github.com/Rich-Harris/devalue), a JavaScript library for stringifying and parsing of data that is too complex for JSON. Take a look at the original repo for all features.

All credit for the parsing and stringifying logic goes to the creator and contributors of the [devalue](https://github.com/Rich-Harris/devalue) library. The logic in this implementation is mostly the same, with some slight changes to improve the performance with PHP.

Installation
------------

[](#installation)

Install it using [composer](https://packagist.org/packages/maaaarcel/devalue-php):

```
composer require maaaarcel/devalue-php
```

Usage
-----

[](#usage)

The `Devalue` class has the `stringify`, `parse` and `unflatten` methods, used for stringifying and parsing on the backend.

```
use Maaaarcel\DevaluePhp\Devalue;
use Maaaarcel\DevaluePhp\JavaScript\JsBigInt;
use Maaaarcel\DevaluePhp\JavaScript\JsNumberObject;
use Maaaarcel\DevaluePhp\JavaScript\JsRegExp;
use DateTime;

$obj = new stdClass();
$obj->self = $obj;
$data = [
    'recursiveObject' => $obj,
    'regex' => new JsRegExp('.+', 'g'),
    'date' => new DateTime('2023-01-16'),
    'autoConverted' => INF,
    'undefined' => JsValue::Undefined,
    'normalNumber' => 1,
    'array' => [new JsBigInt(1), new JsNumberObject(2)]
];
$dataStr = Devalue::stringify($data);
// => '[{"recursiveObject":1,"regex":2,"date":3,"autoConverted":-4,"undefined":-1,"normalNumber":4,"array":5},{"self":1},["RegExp",".+","g"],["Date","2023-01-16T00:00:00.000Z"],1,[6,7],["BigInt","1"],["Object",2]]'

$parsedData = Devalue::parse($dataStr);
// => object(stdClass)#507 (7) {
//   ["recursiveObject"]=>
//   object(stdClass)#505 (1) {
//     ["self"]=>
//     *RECURSION*
//   }
//   ["regex"]=>
//   object(Maaaarcel\DevaluePhp\JavaScript\JsRegExp)#506 (2) {
//     ["source":"Maaaarcel\DevaluePhp\JavaScript\JsRegExp":private]=>
//     string(2) ".+"
//     ["flags":"Maaaarcel\DevaluePhp\JavaScript\JsRegExp":private]=>
//     string(1) "g"
//   }
//   ["date"]=>
//   object(DateTime)#504 (3) {
//     ["date"]=>
//     string(26) "2023-01-16 00:00:00.000000"
//     ["timezone_type"]=>
//     int(2)
//     ["timezone"]=>
//     string(1) "Z"
//   }
//   ["autoConverted"]=>
//   enum(Maaaarcel\DevaluePhp\JavaScript\JsValue::PositiveInfinity)
//   ["undefined"]=>
//   enum(Maaaarcel\DevaluePhp\JavaScript\JsValue::Undefined)
//   ["normalNumber"]=>
//   int(1)
//   ["array"]=>
//   object(ArrayObject)#503 (1) {
//     ["storage":"ArrayObject":private]=>
//     array(2) {
//       [0]=>
//       object(Maaaarcel\DevaluePhp\JavaScript\JsBigInt)#501 (1) {
//         ["value":"Maaaarcel\DevaluePhp\JavaScript\JsBigInt":private]=>
//         int(1)
//       }
//       [1]=>
//       object(Maaaarcel\DevaluePhp\JavaScript\JsNumberObject)#500 (1) {
//         ["value":"Maaaarcel\DevaluePhp\JavaScript\JsNumberObject":private]=>
//         int(2)
//       }
//     }
//   }
// }

// if your devalue payload was inside a normal JSON string, you can use the value from json_decode with the `unflatten`
// method like so:

$json = '{
    "type": "data",
    "data": [{...devalue data...}]
}';
$payload = json_decode($json);

$data = Devalue::unflatten($payload->data);

// You can create custom types to transfer common objects. Custom types must implement the `DevalueSerializable` interface

use Maaaarcel\DevaluePhp\DevalueSerializable;

class CustomType implements DevalueSerializable
{

    public function __construct(
        public readonly string $field1 = '',
        public readonly string $field2 = ''
    )
    {
    }

    // specify the name of the type (used for parsing in the frontend library)
    static function devalueType(): string
    {
        return 'CustomType';
    }

    // create a class instance from the serialized data
    static function devalueParse(array $serialized): static
    {
        return new self($serialized['field1'], $serialized['field2']);
    }

    // serialize the data
    function devalueSerialize(): array
    {
        return [
            'field1' => $this->field1,
            'field2' => $this->field2
        ];
    }
}

$stringifiedCustomType = Devalue::stringify(new CustomType('foo', 'bar'));
// => '[["CustomType",1],{"field1":2,"field2":3},"foo","bar"]'

// To parse custom types, you can either specify your custom types globally, or individually for every parse.

// register type globally
Devalue::registerCustomTypes([CustomType::class]);

$parsedCustomType = Devalue::parse($stringifiedCustomType, [CustomType::class]); // register type only for this parse
// => class CustomType#552 (2) {
//   public readonly string $field1 =>
//   string(3) "foo"
//   public readonly string $field2 =>
//   string(3) "bar"
// }
```

`Devalue::stringify` can handle the following data types:

- `\Maaaarcel\DevaluePhp\JavaScript\JsBooleanObject`
- `\Maaaarcel\DevaluePhp\JavaScript\JsNumberObject`
- `\Maaaarcel\DevaluePhp\JavaScript\JsStringObject`
- `\Maaaarcel\DevaluePhp\JavaScript\JsBigInt`
- `\Maaaarcel\DevaluePhp\JavaScript\JsMap`
- `\Maaaarcel\DevaluePhp\JavaScript\JsSet`
- `\Maaaarcel\DevaluePhp\JavaScript\JsRegExp`
- `int` (gets automatically converted to a `BigInt`, if the number is greater than `9007199254740991`)
- `float`
- `string`
- `bool`
- `null`
- `NAN` (gets converted to `NaN`)
- `INF` (gets converted to `Infinity` / `-Infinity`)
- `\DateTimeInterface` (gets converted to `Date()`)
- `\JsonSerializable` (gets converted to a JS object)
- `\stdClass` (gets converted to a JS object)
- `\ArrayObject` (gets converted to a JS array)
- `[1, 2, 3] (list)` (gets converted to a JS array)
- `['a' => 1, 'b' => 2, 'c' => 3] (assoc array)` (gets converted to a JS object)

The `Devalue::parse` and `Devalue::unflatten` methods convert some JavaScript values into objects/enum values for a more accurate representation of the data. Those objects/enum values can also be used to pass those JavaScript values when using `Devalue::stringify`.

Here is a list of the conversions (left: JavaScript value, right: PHP value):

- `objects`: `\stdClass()`
- `arrays`: `\ArrayObject()`
- `Date()`: `\DateTime()`
- `BigInt()`: `\Maaaarcel\DevaluePhp\JavaScript\JsBigInt()`
- `Boolean()`: `\Maaaarcel\DevaluePhp\JavaScript\JsBooleanObject()`
- `Number()`: `\Maaaarcel\DevaluePhp\JavaScript\JsNumberObject()`
- `String()`: `\Maaaarcel\DevaluePhp\JavaScript\JsStringObject()`
- `RegExp()`: `\Maaaarcel\DevaluePhp\JavaScript\JsRegExp()`
- `Map()`: `\Maaaarcel\DevaluePhp\JavaScript\JsMap()`
- `Set()`: `\Maaaarcel\DevaluePhp\JavaScript\JsSet()`
- `undefined`: `\Maaaarcel\DevaluePhp\JavaScript\JsValue::Undefined`
- `NaN`: `\Maaaarcel\DevaluePhp\JavaScript\JsValue::Nan`
- `-0`: `\Maaaarcel\DevaluePhp\JavaScript\JsValue::NegativeZero`
- `Infinity`: `\Maaaarcel\DevaluePhp\JavaScript\JsValue::PositiveInfinity`
- `-Infinity`: `\Maaaarcel\DevaluePhp\JavaScript\JsValue::NegativeInfinity`

Stringify converts some specific PHP values for better compatability / usability before creating the string:

To consume your data in your frontend code, you have to use the original [devalue](https://github.com/Rich-Harris/devalue) library.

Performance
-----------

[](#performance)

Please see the github action result of the current commit for performance numbers. The benchmarks are run with [phpbench](https://github.com/phpbench/phpbench)

License
-------

[](#license)

[MIT](./LICENSE)

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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

Every ~13 days

Total

3

Last Release

1192d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e7870308d609c386c15b1ab8a563af8050d123dd43f6af1e1e04fcf74257dc29?d=identicon)[Maaaarcel](/maintainers/Maaaarcel)

---

Top Contributors

[![Maaaarcel](https://avatars.githubusercontent.com/u/18512190?v=4)](https://github.com/Maaaarcel "Maaaarcel (8 commits)")

---

Tags

jsonserializationdevaulue

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/maaaarcel-devalue-php/health.svg)

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

###  Alternatives

[jms/serializer

Library for (de-)serializing data of any complexity; supports XML, and JSON.

2.3k135.8M851](/packages/jms-serializer)[jms/serializer-bundle

Allows you to easily serialize, and deserialize data of any complexity

1.8k89.3M627](/packages/jms-serializer-bundle)[sbsaga/toon

🧠 TOON for Laravel — a compact, human-readable, and token-efficient data format for AI prompts & LLM contexts. Perfect for ChatGPT, Gemini, Claude, Mistral, and OpenAI integrations (JSON ⇄ TOON).

6115.6k](/packages/sbsaga-toon)

PHPackages © 2026

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