Download the PHP package smuuf/primi without Composer
On this page you can find all versions of the php package smuuf/primi. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package primi
Short Description A scripting language written in PHP & executable within PHP.
License MIT
Informations about the package primi
Primi
A scripting language written in PHP & interpreted in PHP.
Primi is meant for PHP developers who want to allow their clients to write their own custom logic. Primi allows you (the developer) to execute untrusted code (provided simply as a string) inside a sandbox, safely separated from its surroundings.
Code Climate | Packagist |
---|---|
Quick access
- Language reference (syntax help)
Rationale
Primi - as things sometimes go in life - began as an answer to a practical problem: I needed some general-purpose (ie. not too much domain-specific) scripting language that my other app's users could use to write their simple custom logic. I needed some universally usable and primitive scripting thing, with familiar syntax (PHP-like
x C-like
x JS-like
) and one that could be safely executed inside pure PHP environment (no external depedencies on v8js, v8 and whatnot - meaning Javascript is out of the game...).
Thus, Primi was (mostly as an experiment) created.
Installation
You can either use Primi as a in your own projects (b)
by installing it as a Composer dependency.
You'll want either one of these:
git clone https://github.com/smuuf/primi.git
(standalone use)composer require smuuf/primi
(using Primi as a library in your own project)
a) Standalone installation
- Clone this repo.
git clone https://github.com/smuuf/primi.git
- Install Composer dependencies.
composer install
- Run something with Primi CLI.
chmod +x ./primi && ./primi -s -c "a = 1 + 2 / 3;"
Convenient installation Oneliner™:
Extra stuff:
-
Register Primi's CLI executable for current user so typing
primi
will behave like a binary (otherwise you'd need to write./primi
and would have to be in the right directory):Note: This will add an alias in .bashrc for current user.
-
Run tests (tests are located inside
./tests/
directory): - Rebuild parser (when you modify Primi's grammar definitions, you will want to rebuild the parser to reflect the changes):
b) Using Primi as a library
- First, install Primi Composer package:
composer require smuuf/primi
- Then use it like this:
Running this code would output:
REPL mode
Primi provides a convenient "sandbox" REPL mode which is launched by executing ./primi
without any argument. You can use this for messing around with the language or to test any new stuff you might be trying to implement (e.g. your own Primi extensions written in PHP).
In this mode, all statements are executed when entered and the result value of the last expression is returned. REPL commands history is preserved between separate sessions (history is stored in ~/.primi_history
file).
Language reference
The basics of the language syntax and data types are found here: https://github.com/smuuf/primi/blob/master/docs/language_reference.md