cylab/json

Encodes, decodes, and validates JSON data.

3.0.0 2019-11-12 12:29 UTC

This package is auto-updated.

Last update: 2024-12-13 00:00:29 UTC


README

pipeline status coverage report

A library for encoding, decoding, linting, and validating JSON data.

Forked from https://github.com/kherge-php/json

This library provides a simplified interface into existing functionality that is provided by PHP's json extension, justinrainbow/json-schema, and also seld/jsonlint. The purpose is to make it easy to use while making it hard to miss errors.

Usage

<?php

use KHerGe\JSON\JSON;

$json = new JSON();

// Decode JSON values.
$decoded = $json->decode('{"test":123}');

// Decode JSON values in files.
$decoded = $json->decodeFile('/path/to/file.json');

// Encode native values.
$encoded = $json->encode(['test' => 123]);

// Encode native values into files.
$json->encodeFile(['test' => 123], '/path/to/file.json');

// Lint an encoded JSON value.
$json->lint('{"test":}');

// Lint an encoded JSON value in a file.
$json->lintFile('/path/to/file.json');

// Validate a decoded JSON value using a JSON schema.
$json->validate(
    $json->decodeFile('/path/to/schema.json'),
    $decoded
);

Documentation

The JSONInterface interface is your best resource. The JSON class you will be using implements this interface and contains all of the information you will need.

Requirements

  • PHP 5.6+
    • json

Installation

composer require kherge/json=^2.0

License

This library is released under the MIT and Apache 2.0 licenses.