PHPackages                             teariot/json-repair - 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. [Database &amp; ORM](/categories/database)
4. /
5. teariot/json-repair

ActiveLibrary[Database &amp; ORM](/categories/database)

teariot/json-repair
===================

Repair broken, malformed, or non-standard JSON — fix quotes, commas, comments, Python constants, JSONP, NDJSON, HTML entities, and more

1.0.2(today)01↑2900%MITPHPPHP &gt;=8.0

Since Mar 24Pushed todayCompare

[ Source](https://github.com/TeaRiot/JsonRepair)[ Packagist](https://packagist.org/packages/teariot/json-repair)[ RSS](/packages/teariot-json-repair/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (1)Versions (4)Used By (0)

teariot/json-repair
===================

[](#teariotjson-repair)

PHP 8.0+ library to repair broken, malformed, or non-standard JSON.

Handles real-world garbage: LLM responses with `` blocks, truncated output, single quotes, trailing commas, comments, JSONP, Python constants, MongoDB types, HTML entities, and more.

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

[](#installation)

```
composer require teariot/json-repair
```

Quick Start
-----------

[](#quick-start)

```
use Teariot\JsonRepair\JsonRepair;

// Fix broken JSON
$json = JsonRepair::fix("{name: 'John', age: 30,}");
// → {"name":"John","age":30}

// Fix and decode in one call
$data = JsonRepair::decode("{active: True, tags: ['php', 'json',]}");
// → ['active' => true, 'tags' => ['php', 'json']]
```

Extract JSON from Text
----------------------

[](#extract-json-from-text)

Pull JSON out of LLM responses, log lines, or any surrounding text:

```
// From LLM response with  block
$raw = 'Analyzing the query... {"result": true, "score": 42}';
$json = JsonRepair::extractAndFix($raw);
// → {"result":true,"score":42}

// From log line
$log = '[2024-03-24 13:17:52] production.WARNING: Response: {"status": "ok"}';
$json = JsonRepair::extractAndFix($log);
// → {"status":"ok"}

// From markdown code block
$md = "```json\n{\"a\": 1}\n```";
$json = JsonRepair::extractAndFix($md);
// → {"a":1}

// From plain text
$text = "Here is the analysis result:\n\n{\"mentioned\": true, \"tone\": \"positive\"}";
$json = JsonRepair::extractAndFix($text);
// → {"mentioned":true,"tone":"positive"}
```

Template: Fill Missing Keys
---------------------------

[](#template-fill-missing-keys)

When LLM output is truncated or incomplete, apply a template to ensure all expected keys exist:

```
$template = [
    'mentioned'    => false,
    'occurrences'  => [],
    'position'     => null,
    'tone'         => 'non',
    'comment'      => null,
    'other_brands' => [],
];

// Truncated JSON — missing keys filled from template
$data = JsonRepair::fixWithTemplate(
    '{"mentioned": true, "tone": "negative"',
    $template
);
// → ['mentioned' => true, 'tone' => 'negative', 'occurrences' => [], 'position' => null, ...]

// Extract + fix + decode + template in one call
$data = JsonRepair::extractAndDecode(
    'reasoning {"mentioned": true, "tone": "negative"}',
    $template
);
```

What It Fixes
-------------

[](#what-it-fixes)

ProblemInputOutputUnquoted keys`{name: "John"}``{"name":"John"}`Single quotes`{'a': 'b'}``{"a":"b"}`Smart/curly quotes`{"a": "b"}``{"a":"b"}`Backtick quotes`{`a`: `b`}``{"a":"b"}`Trailing commas`{"a": 1,}``{"a":1}`Leading commas`{,"a": 1}``{"a":1}`Missing commas`{"a": 1 "b": 2}``{"a":1,"b":2}`Missing colons`{"a" 1}``{"a":1}`Missing brackets`{"a": 1``{"a":1}`Redundant brackets`{"a": 1}}``{"a":1}`Block comments`{"a": 1 /* x */}``{"a":1}`Line comments`{"a": 1 // x}``{"a":1}`Hash comments`{"a": 1 # x}``{"a":1}`JSONP`callback({"a": 1});``{"a":1}`Markdown fences````json{"a":1}`````{"a":1}`Python True/False/None`{a: True, b: None}``{"a":true,"b":null}`JS undefined/NaN`undefined``null`String concatenation`"a" + "b"``"ab"`Ellipsis`[1, 2, ...]``[1,2]`Leading zero numbers`0123``"0123"`Truncated JSON`{"a":``{"a":null}`NDJSON`{"a":1}\n{"b":2}``[{"a":1},{"b":2}]`Regex literals`/test/gi``"/test/gi"`MongoDB types`ObjectId("abc")``"abc"`HTML entities`"a &amp; b"``"a & b"``` blocks`... {}``{}`Log prefixes`[date] level: {}``{}`Full API
--------

[](#full-api)

### Static Facade

[](#static-facade)

```
use Teariot\JsonRepair\JsonRepair;

// Core
JsonRepair::fix(string $input, bool $beautify = false): string
JsonRepair::decode(string $input, bool $assoc = true, int $depth = 512, int $flags = 0): mixed
JsonRepair::tryFix(string $input, bool $beautify = false): string      // never throws
JsonRepair::needsRepair(string $input): bool

// Extract from text
JsonRepair::extractAndFix(string $raw, bool $beautify = false): string
JsonRepair::extractAndDecode(string $raw, ?array $template = null, bool $assoc = true): mixed

// Template
JsonRepair::fixWithTemplate(string $input, array $template): array

// Streaming (memory-efficient for large files)
JsonRepair::stream($source, int $chunkSize = 65536, bool $beautify = false): Generator
JsonRepair::streamCollect($source, int $chunkSize = 65536, bool $beautify = false): string
```

### Helper Functions

[](#helper-functions)

```
use function Teariot\JsonRepair\json_repair;
use function Teariot\JsonRepair\json_repair_decode;
use function Teariot\JsonRepair\json_try_repair;
use function Teariot\JsonRepair\json_extract_and_fix;
use function Teariot\JsonRepair\json_extract_and_decode;
use function Teariot\JsonRepair\json_fix_with_template;
use function Teariot\JsonRepair\json_repair_stream;
```

Streaming
---------

[](#streaming)

Process large JSON files without loading everything into memory:

```
$handle = fopen('large.json', 'r');
foreach (JsonRepair::stream($handle) as $chunk) {
    echo $chunk;
}
fclose($handle);

// Or collect into a string
$handle = fopen('large.json', 'r');
$json = JsonRepair::streamCollect($handle);
fclose($handle);
```

Requirements
------------

[](#requirements)

- PHP &gt;= 8.0
- ext-json
- ext-mbstring
- ext-ctype

Testing
-------

[](#testing)

```
composer install
vendor/bin/phpunit
```

License
-------

[](#license)

MIT

###  Health Score

39

—

LowBetter than 87% of packages

Maintenance100

Actively maintained with recent releases

Popularity2

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity40

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 ~0 days

Total

3

Last Release

0d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/6f6607a58ba1ad9fbbdcdf6566b2300b87e38135e8697bebe5a5883b6034eebe?d=identicon)[TeaRiot](/maintainers/TeaRiot)

---

Top Contributors

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

---

Tags

jsonstreamingNDJSONtemplateparseextractmongodbpythoncommentsllminvalidfixbrokenrepairmalformedJSONP

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/teariot-json-repair/health.svg)

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

###  Alternatives

[mongodb/mongodb

MongoDB driver library

1.6k62.7M506](/packages/mongodb-mongodb)[clue/ndjson-react

Streaming newline-delimited JSON (NDJSON) parser and encoder for ReactPHP.

15063.4M13](/packages/clue-ndjson-react)[apix/cache

A thin PSR-6 cache wrapper with a generic interface to various caching backends emphasising cache taggging and indexing to Redis, Memcached, PDO/SQL, APC and other adapters.

114540.4k6](/packages/apix-cache)[davidbadura/fixtures

A library to load yaml, json or php fixtures. Easy extendable, resolve object dependency and validate objects.

2468.8k1](/packages/davidbadura-fixtures)[moloquent/moloquent

A MongoDB based Eloquent model and Query builder for Laravel (Moloquent)

120114.2k7](/packages/moloquent-moloquent)[denchikby/phalcon-mongodb-odm

Phalcon MongoDB ODM

4212.6k](/packages/denchikby-phalcon-mongodb-odm)

PHPackages © 2026

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