jojo1981/json-ast-builder

Json AST builder

1.0.0 2019-10-18 09:07 UTC

This package is auto-updated.

Last update: 2024-09-05 05:56:37 UTC


README

Build Status Coverage Status Latest Stable Version Total Downloads License

作者:Joost Nijhuis <jnijhuis81@gmail.com>

一个用于从JSON字符串构建抽象语法树(AST)的PHP实现。
AST可访问,可以通过实现访问者(行为设计模式访问者)进行访问。

此库的目的包括

  • 验证JSON语法,并给出关于语法错误的精确错误消息
  • 将AST转换为JSON字符串,并控制格式
  • 通过实现自己的访问者遍历AST

有关轻量级数据交换格式JSON(JavaScript对象表示法)的更多信息,请参阅此处

安装

git clone https://github.com/jojo1981/json-ast-builder.git

Composer

安装PHP Composer

composer require jojo1981/json-ast-builder

用法

<?php

require 'vendor/autoload.php';

use Jojo1981\JsonAstBuilder\Generator;
use Jojo1981\JsonAstBuilder\Lexer\Lexer;
use Jojo1981\JsonAstBuilder\Parser;

// setup lexer and parser
$parser = new Parser(new Lexer());
$parser->setInput(\file_get_contents('data.json'));

// build AST
$ast = $parser->parse();

// You can use the generator to generate multiple things
$generator = new Generator();

// default generate json string options
$generateJsonStringOptions = [
    'useTabs' => false,
    'pretty' => true,
    'indentSize' => 2,
    'spacesBeforeColon' => 0,
    'spacesAfterColon' => 1,
    'lineSeparator' => PHP_EOL
];

// options can be omitted
$jsonString = $generator->generateJsonString($ast, $generateJsonStringOptions);

// default generate json string options
$generateDataOptions = [
    'assoc' => false
];

// options can be omitted
$data = $generator->generateData($ast, $generateDataOptions);

$plantUmlString = $generator->generatePlantUmlData($ast);
\file_put_contents('test-output.puml', $plantUmlString);

$statistics = $generator->getStatistics($ast);