Download the PHP package rb/polygen-php without Composer
On this page you can find all versions of the php package rb/polygen-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download rb/polygen-php
More information about rb/polygen-php
Files in rb/polygen-php
Package polygen-php
Short Description A PHP implementation of Polygen - A random sentence generator.
License LGPL-3.0-only
Informations about the package polygen-php
Polygen-PHP
Polygen is a tool that parses text files containing a grammar definition and generates text according to that definition. Polygen-PHP does the same, but in PHP 5.6+ and is compatible with the same grammar files, so now you can use Polygen on your website even if it's on a shared hosting service.
For example, the following grammar file
might result in the following sentences being generated:
- this is a grammar and is rather dumb
- this is polygen and is quite remarkable
- this is a grammar and is very interesting
... and so on.
There are many more features in the language, check out the official Polygen documentation to learn everything about it.
Installation
You can install Polygen-PHP using composer: composer require rb/polygen-php
Usage instructions
Parse once, produce many (POPM)
It's not necessary to parse the source grammar every time a production is wanted: once a Polygen document is obtained, it
can be serialize()
d to a string and stored as a string constant. This way, the parsing can be done only once at
"compile time", then at runtime, it's sufficient to unserialize()
the string back to a Polygen document, and it can be
used as usual to obtain a production.
Command line usage
There is also a CLI tool that you can use. It's not refined at all, since it is intended for debugging only, but the
basics work.
If you require this package as a dependency of your project, Composer must have placed the CLI tool in your vendor/bin
folder, so you can run it with ./vendor/bin/polygen.php
.
A small usage will be printed if launched with no parameters (or with -h
or --help
parameters).
Known issues
Static checking
- I believe that the static infinite recursion check is broken, but I have not proved this yet. Just try to avoid grammars with circular references between declarations and everything will be fine.
- Only errors are reported by the static check, no warnings have been implemented.
Running tests
There are two test suites, Unit and Integration you can run both with vendor/bin/phpunit
.
All versions of polygen-php with dependencies
php Version ^5.6 || ^7.0
drupol/phpermutations Version ^1
savvot/random Version ^0.3
webmozart/assert Version ^1