estahn/json-query-wrapper

Wrapper for jq, a lightweight and flexible command-line JSON processor

JSON Query Wrapper

, _(*1)

json-query-wrapper is a wrapper for the popular command-line JSON processor "jq"., _(*2)

Features

• Easy to use interface
• PHP data type mapping

Installation

$ composer require estahn/json-query-wrapper

Usage

Basic usage

test.json:, _(*3)

{
  "Foo": {
    "Bar": "33"
  }
}

Example 1:, _(*4)

$jq = JsonQueryWrapper\JsonQueryFactory::createWith('test.json');
$jq->run('.Foo.Bar'); # string(33)

Example 2:, _(*5)

$jq = JsonQueryWrapper\JsonQueryFactory::createWith('test.json');
$jq->run('.Foo.Bar == "33"'); # Returns bool(true)

Example 3:, _(*6)

$jq = JsonQueryWrapper\JsonQueryFactory::createWith('{"Foo":{"Bar":"33"}}');
$jq->run('.Foo.Bar == "33"'); # Returns bool(true)

Advanced usage

Example 1:, _(*7)

$jq = JsonQueryWrapper\JsonQueryFactory::create();
$jq->setDataProvider(new JsonQueryWrapper\DataProvider\File('test.json');
$jq->run('.Foo.Bar == "33"'); # Returns bool(true)

Data Providers

A "Data Provider" provides the wrapper with the necessary data to read from. It's a common interface for several providers. All providers implement the DataProviderInterface which essentially returns a path to the file for jq., _(*8)

Available providers:, _(*9)

• Text - Regular PHP string containing JSON data
• File - A path to a file containing JSON data

Badge Mania

, _(*10)

Alternatives

• jmespath.php - Declaratively specify how to extract elements from a JSON document, in PHP
• JSONPath - JSONPath implementation for PHP (based on Stefan Goessner's JSONPath script)