kherge/json

Encodes, decodes, and validates JSON data.

Installs: 149 948

Dependents: 6

Suggesters: 0

Security: 0

Stars: 61

Watchers: 3

Forks: 12

3.0.1 2020-01-31 14:53 UTC

This package is auto-updated.

Last update: 2024-10-29 03:37:31 UTC


README

Build Status Packagist Packagist Pre Release

JSON

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

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 7.3+
    • json

Installation

composer require kherge/json=^3

License

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