LuaSandbox::registerLibrary()函数—用法及示例

函数名称：LuaSandbox::registerLibrary()

适用版本：PHP 7.4.0 以上版本

函数说明：LuaSandbox::registerLibrary() 函数用于在 Lua 沙盒中注册一个 PHP 库，使得在 Lua 脚本中可以调用该 PHP 库中的函数。

用法：

LuaSandbox::registerLibrary(string $name, mixed $functions): void

参数：

• $name（必选）：字符串类型，表示要注册的 PHP 库的名称。
• $functions（必选）：混合类型，可接受一个数组或对象，用于定义要注册的 PHP 库中的函数。

示例：

// 创建一个 LuaSandbox 实例
$luaSandbox = new LuaSandbox();

// 定义一个 PHP 函数库
$mathLibrary = [
    'add' => function($a, $b) {
        return $a + $b;
    },
    'subtract' => function($a, $b) {
        return $a - $b;
    }
];

// 在 LuaSandbox 中注册该 PHP 函数库
$luaSandbox->registerLibrary('math', $mathLibrary);

// 在 Lua 脚本中调用注册的 PHP 函数
$luaScript = <<<EOF
result = math.add(5, 3)
print(result)  -- 输出：8
EOF;

$luaSandbox->runString($luaScript);

注意事项：

• $name 参数必须是一个字符串，用于在 Lua 脚本中引用该 PHP 函数库。
• $functions 参数可以是一个数组或对象，其中键表示函数名称，值表示对应的 PHP 函数。
• 注册的 PHP 函数库可以在 Lua 脚本中通过 $name.函数名 的方式进行调用。
• 注册的 PHP 函数必须是可调用的（例如匿名函数、类的静态方法等）。
• 注册的 PHP 函数库只能在同一个 LuaSandbox 实例中使用，不会对其他实例产生影响。