Download the PHP package tysonandre/php-parser-to-php-ast without Composer
On this page you can find all versions of the php package tysonandre/php-parser-to-php-ast. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download tysonandre/php-parser-to-php-ast
More information about tysonandre/php-parser-to-php-ast
Files in tysonandre/php-parser-to-php-ast
Package php-parser-to-php-ast
Short Description A pure PHP substitute for nikic/php-ast, using nikic/php-parser. Can also be used to generate php-ast trees, even for files with some types of syntax errors.
License MIT
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 php-parser-to-php-ast
PHP-Parser to php-ast
This converts ASTs(Abstract Syntax Trees) from PHP-Parser to php-ast. It can be used as a PHP-only implementation of php-ast. It can alternatively be used as a best-effort parser for syntactically valid PHP code.
Also see https://github.com/TysonAndre/tolerant-php-parser-to-php-ast (in progress, may have better results)
Supported php-ast AST versions: 40, 45, 50
Current Status
No tests are failing
- Need to normalize namespaces (Mostly done)
- The test suite this is based off of covers common cases for Phan, but edge cases still remain. See https://github.com/TysonAndre/php-parser-to-php-ast/issues/4
- See https://github.com/nikic/php-ast/issues/78
Remaining work:
- Translate PhpParser exception to a
\ParseErrorinstance
Usage
Using it as a slow substitute for php-ast
Using it as an error-tolerant substitute for php-ast: (e.g. for use in IDEs)
- There are currently two modes: omitting errors and adding placeholders (e.g.
__INCOMPLETE_VARIABLE__). - Omitting errors only handles some common cases that come up while editing a file.
- Placeholders may change in the future.
- tests/ASTConverter/ErrorTolerantConversionTest.php
- If performance is an issue, cache previous results for a file's contents (in combination with the version used to generate the file
ASTConversion::ASTCONVERTER_VERSION)
Running unit tests
To run unit tests, you must install nikic/php-ast. A version supporting AST versions 40 and/or 50 should be installed (~0.1.5 is preferred)
- Then run
vendor/bin/phpunit
Possible Future Enhancements
- https://github.com/Microsoft/tolerant-php-parser/issues/113 See https://github.com/tysonandre/tolerant-php-parser-to-php-ast (The library to convert between AST formats is broken(not finished implementing) and inefficient, waiting for stable API for tolerant-php-parser)
