phplrt / phplrt
PHP Language Recognition Tool
Installs: 22 281
Dependents: 7
Suggesters: 0
Security: 0
Stars: 217
Watchers: 9
Forks: 7
Open Issues: 3
Requires
- php: ^8.1
- ext-json: *
- ext-mbstring: *
- ext-pcre: *
- ext-spl: *
- symfony/deprecation-contracts: ^2.5|^3.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.62
- httpsoft/http-message: ^1.1
- jetbrains/phpstorm-attributes: ^1.0
- phpstan/extension-installer: ^1.4
- phpstan/phpstan: ^1.11
- phpstan/phpstan-strict-rules: ^1.6
- phpunit/phpunit: ^10.5|^11.0
- psr/http-message: ^1.0|^2.0
- rector/rector: ^1.2
- symfony/var-dumper: ^5.4|^6.0|^7.0
- symplify/monorepo-builder: ^11.2
Provides
Replaces
- phplrt/ast-contracts: *
- phplrt/buffer: *
- phplrt/compiler: *
- phplrt/contracts: *
- phplrt/exception: *
- phplrt/exception-contracts: *
- phplrt/grammar: *
- phplrt/grammar-contracts: *
- phplrt/lexer: *
- phplrt/lexer-contracts: *
- phplrt/parser: *
- phplrt/parser-contracts: *
- phplrt/position: *
- phplrt/position-contracts: *
- phplrt/runtime: *
- phplrt/source: *
- phplrt/source-contracts: *
- phplrt/visitor: *
- dev-master / 4.x-dev
- 3.x-dev
- 3.7.2
- 3.7.1
- 3.7.0
- 3.6.6
- 3.6.5
- 3.6.4
- 3.6.3
- 3.6.2
- 3.6.1
- 3.6.0
- 3.5.2
- 3.5.1
- 3.5.0
- 3.4.3
- 3.4.2
- 3.4.1
- 3.4.0
- 3.3.1
- 3.3.0
- 3.2.9
- 3.2.8
- 3.2.7
- 3.2.6
- 3.2.5
- 3.2.4
- 3.2.3
- 3.2.2
- 3.2.1
- 3.2.0
- 3.1.8
- 3.1.7
- 3.1.6
- 3.1.5
- 3.1.4
- 3.1.3
- 3.1.2
- 3.1.1
- 3.1.0
- 3.0.2
- 3.0.1
- 3.0.0
- 2.x-dev
- 2.3.6
- 2.3.5
- 2.3.4
- 2.3.3
- 2.3.2
- 2.3.1
- 2.3.0
- 2.2.4
- 2.2.3
- 2.2.2
- 2.2.1
- 2.2.0
- 2.1.6
- 2.1.5
- 2.1.4
- 2.1.3
- 2.1.2
- 2.1.1
- 2.1.0
- 2.0.4
- 2.0.3
- 2.0.2
- 2.0.1
- 2.0.0
- 1.x-dev
- 1.1.1
- 1.1.0
- 1.0.2
- 1.0.1
- 1.0.0
- dev-feature/reorganize
This package is auto-updated.
Last update: 2024-09-11 14:24:28 UTC
README
Introduction
The phplrt is a set of tools for programming languages recognition. The library provides lexer, parser, grammar compiler, library for working with errors, text analysis and so on.
Installation
Phplrt is available as composer repository and can be installed using the following command in a root of your project:
$ composer require phplrt/phplrt
More detailed installation instructions are here.
Documentation
Quick Start
First, we will create the grammar for our parser.
You can read more about the grammar syntax here.
<?php use Phplrt\Compiler\Compiler; $compiler = new Compiler(); $compiler->load(<<<EBNF %token T_DIGIT \d %token T_PLUS \+ %token T_MINUS \- %token T_POW \* %token T_DIV / %skip T_WHITESPACE \s+ #Expression : <T_DIGIT> (Operator() <T_DIGIT>)* ; #Operator : <T_PLUS> | <T_MINUS> | <T_POW> | <T_DIV> ; EBNF);
Execution
In order to quickly check the performance of what has been written, you can use
the simple parse()
method. As a result, it will output the recognized abstract
syntax tree along with the predefined AST classes which can be converted to their
string representation.
<?php echo $compiler->parse('2 + 2'); // // Output: // // <Expression offset="0"> // <T_DIGIT offset="0">2</T_DIGIT> // <Operator offset="2"> // <T_PLUS offset="2">+</T_PLUS> // </Operator> // <T_DIGIT offset="4">2</T_DIGIT> // </Expression> //
Compilation
After your grammar is ready and tested, it should be compiled. After that,
you no longer need the phplrt/compiler
dependency (see https://phplrt.org/docs/installation#runtime-only).
file_put_contents(__DIR__ . '/grammar.php', (string)$compiler->build());
This file will contain your compiled data that can be used in your custom parser.
use Phplrt\Lexer\Lexer; use Phplrt\Parser\Parser; use Phplrt\Parser\BuilderInterface; use Phplrt\Parser\Context; $data = require __DIR__ . '/grammar.php'; // Create Lexer from compiled data $lexer = new Lexer($data['tokens']['default'], $data['skip']); // Create Parser from compiled data $parser = new Parser($lexer, $data['grammar'], [ // Recognition will start from the specified rule Parser::CONFIG_INITIAL_RULE => $data['initial'], // Rules for the abstract syntax tree builder. // In this case, we use the data found in the compiled grammar. Parser::CONFIG_AST_BUILDER => new class($data['reducers']) implements BuilderInterface { public function __construct(private array $reducers) {} public function build(Context $context, $result) { $state = $context->getState(); return isset($this->reducers[$state])) ? $this->reducers[$state]($context, $result) : $result ; } } ]); // Now we are ready to parse any code using the compiled grammar $parser->parse(' ..... ');