bingo-soft/script

Scripting API implemented in PHP

1.3.1 2023-08-11 08:52 UTC

Requires

• php: ^7.4 || ^8.0
• bingo-soft/el: ^1.1
• bingo-soft/juel: ^1.2
• bingo-soft/util: ^1.3

Requires (Dev)

• doctrine/coding-standard: *
• phpunit/phpunit: *
• squizlabs/php_codesniffer: *

MIT

• Bingo-Soft

• php
• expression
• scripting
• el
• lua
• juel

README

Scripting API

Scripting API implemented in PHP

Installation

Install library, using Composer:

composer require bingo-soft/script

Example 1 (using Juel engine)

$manager = new ScriptEngineManager();
$engine = $manager->getEngineByName("juel");
echo $engine->eval('${1 + 2}'); //prints 3

Example 2 (using Juel engine)

$manager = new ScriptEngineManager();
$engine = $manager->getEngineByName("juel");

$simple = new class () {
    public $propFloat = 1.23;

    public function foo(): int
    {
        return 11;
    }

    public function bar(): int
    {
        return 23;
    }
};
$engine->put("simple", $simple);

echo $engine->eval('${simple.propFloat + 2}'); //prints 3.23
echo $engine->eval('${simple.bar() + simple.foo()}'); //prints 34

Example 3. Calculate factorial using Lua module

$manager = new ScriptEngineManager();
$engine = $manager->getEngineByName("lua");
$engine->put('a', 5);

echo  $engine->eval(<<<CODE
                factorial = function ( n )
                    if n == 1 then return 1
                    else return n * factorial( n - 1 )
                    end
                end
                return factorial(a)
                CODE
            ); //prints 120

Running tests

./vendor/bin/phpunit ./tests

Dependencies

Lua script engine depends on PHP Lua module. The library is tested against 2.0.7 version.