php-doc-en/reference/luasandbox/book.xml
2021-06-13 23:23:33 +01:00

87 lines
2.5 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<book xml:id="book.luasandbox" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<?phpdoc extension-membership="pecl" ?>
<title>LuaSandbox</title>
<titleabbrev>LuaSandbox</titleabbrev>
<preface xml:id="intro.luasandbox">
&reftitle.intro;
<para>
LuaSandbox is an extension for PHP 7 and PHP 8 to allow safely
running untrusted Lua 5.1 code from within PHP.
</para>
<para>
Differences compared to the <link linkend="book.lua">Lua</link> extension:
<itemizedlist>
<listitem>
<para>
LuaSandbox has support for time and memory limits.
</para>
</listitem>
<listitem>
<para>
LuaSandbox provides a default-safe environment for running untrusted code.
Stock Lua functions were reviewed for security, and several were patched
accordingly.
</para>
</listitem>
<listitem>
<para>
LuaSandbox has a PHP interface which is more complex, precise and powerful,
but it is less convenient for developers.
</para>
</listitem>
<listitem>
<para>
LuaSandbox supports only Lua 5.1. It is difficult to change this, because
LuaSandbox uses heavily modified Lua standard libraries, and
due to the lack of backwards compatibility between major Lua versions.
LuaSandbox aims to maximise backwards compatibility with user-supplied
scripts.
</para>
</listitem>
</itemizedlist>
</para>
</preface>
&reference.luasandbox.setup;
<!-- &reference.luasandbox.constants; -->
&reference.luasandbox.differences;
&reference.luasandbox.examples;
<!-- &reference.luasandbox.reference; -->
&reference.luasandbox.luasandbox;
&reference.luasandbox.luasandboxfunction;
&reference.luasandbox.luasandboxerror;
&reference.luasandbox.luasandboxerrorerror;
&reference.luasandbox.luasandboxfatalerror;
&reference.luasandbox.luasandboxmemoryerror;
&reference.luasandbox.luasandboxruntimeerror;
&reference.luasandbox.luasandboxsyntaxerror;
&reference.luasandbox.luasandboxtimeouterror;
</book>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->