LuaSandboxFunction::call

Описание

Вызывает Lua-функцию.

Ошибки, вызванные PHP-кодом, приведут к тому, что функция вернёт false и будет вызвано предупреждение E_WARNING, например, когда тип ресурса (resource) используется в качестве аргумента. При возникновении ошибок Lua будет выброшено исключение LuaSandboxRuntimeError.

Типы PHP и Lua преобразуются следующим образом:

• null в PHP - это nil в Lua и наоборот.
• Целые числа (int) и числа с плавающей точкой (float) в PHP преобразуются в числа Lua. Поддерживаются бесконечность и NAN.
• Числа Lua без дробной части в диапазоне приблизительно от -2**53 и 2**53 преобразуются в целые числа (int) PHP, а другие - в числа PHP с плавающей точкой (float).
• Логические значения в PHP (bool) - это значения типа boolean в Lua и наоборот.
• Строки в PHP (string) - это значения типа string в Lua и наоборот.
• Функции Lua - это объекты PHP LuaSandboxFunction, и наоборот. Callback-функции PHP (callable) не поддерживаются.
• Массивы PHP (array) преобразуются в таблицы Lua и наоборот.
  • Обратите внимание, что Lua обычно индексирует массивы с 1, в то время как PHP индексирует массивы с 0. Никаких корректировок для этих различных соглашений не делается.
  • Массивы, ссылающиеся сами на себя, не поддерживаются ни в одном из направлений.
  • Ссылки PHP разыменовываются.
  • __pairs и __ipairs из Lua обрабатываются. __index игнорируется.
  • При преобразовании из PHP в Lua целочисленные ключи от -2**53 до 2**53 представляются как числа в Lua. Все остальные ключи представлены в виде строк Lua.
  • При преобразовании из Lua в PHP отличные от строк и чисел ключи приведут к возникновению ошибки, как и конфликты при преобразовании чисел в строки или наоборот (поскольку PHP считает такие конструкции, как $a[0] и $a["0"] эквивалентными).
• Все остальные типы не поддерживаются и вызовут ошибку/выбросят исключение, включая PHP-объекты (object), пользовательские данные Lua и типы потоков.

Функции Lua по своей сути возвращают список результатов. Таким образом, в случае успешного выполнения этот метод возвращает массив (array), содержащий все значения, возвращаемые Lua, с целочисленными ключами (int), начинающимися с нуля. Lua может не возвращать результатов, и в этом случае возвращается пустой массив.