Download the PHP package yosymfony/parser-utils without Composer
On this page you can find all versions of the php package yosymfony/parser-utils. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download yosymfony/parser-utils
More information about yosymfony/parser-utils
Files in yosymfony/parser-utils
Package parser-utils
Short Description Parser utilities
License MIT
Homepage http://github.com/yosymfony/toml
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package parser-utils
A library for writing recursive descent parsers in PHP.
requires
- PHP >= 7.1
Installation
The preferred installation method is composer:
An example
First, you need to create a lexer. This one will recognize tokens
Second, you need a parser for consuming the tokens provided by the lexer.
The AbstractParser class contains an abstract method called parseImplementation
that receives a TokenStream as an argument.
Now, you can see the results:
The BasicLexer class
The lexer has the responsibility of recognizing tokens. This one works line by
line. If you want to generate an special T_NEWLINE token for each line
of the input, call $lexer->generateNewlineTokens() before tokenizing. You can set the
name of this special token using the method setNewlineTokenName.
Additionally, there is another special token T_EOS that determines the end of the input
string. To enable this feature call $lexer->generateEosToken() before tokenizing.
You can set the name of this special token using the method setEosTokenName.
The TokenStream class
This class let you treat with the list of tokens returned by the lexer.
- moveNext: Moves the pointer one token forward. Returns a
Tokenobject ornullif there are not more tokens. e.g:$ts->moveNext(). - matchNext: Matches the next token and returns its value. This method moves
the pointer one token forward. It will throw an
SyntaxErrorExceptionexception if the next token does not match. e.g:$number = $ts->matchNext('T_NUMBER'). - isNext: Checks if the next token matches with the token name passed as argument.
e.g:
$ts->isNext('T_PLUS') // true or false. - skipWhile: Skips tokens while they match with the token name passed
as argument. This method moves the pointer "n" tokens forward until the
last one that match with the token name. e.g:
$ts->skipWhile('T_PLUS') -
skipWhileAny: Skips tokens while they match with one of the token names passed as argument. This method moves the pointer "n" tokens forward until the last one that match with one of the token names e.g:
$ts->skipWhileAny(['T_PLUS', 'T_MINUS']) - isNextSequence: Checks if the following tokens in the stream match with
the sequence of tokens. e.g:
$ts->isNextSequence(['T_NUMBER', 'T_PLUS', 'T_NUMBER']) // true or false. - isNextAny: Checks if one of the tokens passed as argument is the next token.
e.g:
$fs->isNextAny(['T_PLUS', 'T_SUB']) // true or false - hasPendingTokens: Has pending tokens? e.g:
$fs->hasPendingTokens() // true or false. - reset: Resets the stream to the beginning.
Tokens
Tokens are instances of Token class, a class than contains the following methods:
- getName: returns the name of the toke. e.g:
T_SUM. - getValue: returns the value of the token.
- getLine: returns the line in where the token is found.
Unit tests
You can run the unit tests with the following command:
License
This library is open-sourced software licensed under the MIT license.
