php/archived-doc-es
1
0
Fork 0
mirror of https://github.com/php/doc-es.git synced 2026-03-23 23:12:09 +01:00
Code Issues Packages Projects Releases Wiki Activity

luasandbox : fix XML by converting para to simpara tags via script

Browse Source
This commit is contained in:
Gina Peter Banyard
2026-01-19 02:54:19 +00:00
parent f4823cc86e
commit fcb36140c3
33 changed files with 325 additions and 337 deletions
Download Patch File Download Diff File Expand all files Collapse all files

25
reference/luasandbox/book.xml
View File

@@ -1,45 +1,45 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 46a9cdd2dbef4ec89bf65fad9930e2feb78bbb98 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<book xml:id="book.luasandbox" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="book.luasandbox">
<?phpdoc extension-membership="pecl" ?>
<title>LuaSandbox</title>
<titleabbrev>LuaSandbox</titleabbrev>
<preface xml:id="intro.luasandbox">
&reftitle.intro;
<para>
<simpara>
LuaSandbox es una extensión para PHP 7 y PHP 8 que permite ejecutar de manera segura código Lua 5.1 no confiable desde PHP.
</para>
</simpara>
<para>
Las diferencias con respecto a la extensión <link linkend="book.lua">Lua</link> :
<itemizedlist>
<listitem>
<para>
<simpara>
LuaSandbox tiene soporte para límites de tiempo y memoria.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
LuaSandbox proporciona un entorno seguro por omisión para la ejecución de código no confiable.
Las funciones estándar de Lua han sido examinadas para la seguridad, y varias han sido corregidas en
consecuencia.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
LuaSandbox tiene una interfaz PHP más compleja, precisa y potente,
pero es menos práctica para los desarrolladores.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
LuaSandbox solo soporta Lua 5.1. Es difícil cambiar esto, ya que
LuaSandbox utiliza bibliotecas estándar de Lua fuertemente modificadas, y
debido a la falta de compatibilidad ascendente entre las principales versiones de Lua.
LuaSandbox tiene como objetivo maximizar la compatibilidad ascendente con los scripts proporcionados
por el usuario.
</para>
</simpara>
</listitem>
</itemizedlist>
</para>
@@ -62,7 +62,6 @@
&reference.luasandbox.luasandboxtimeouterror;
</book>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

9
reference/luasandbox/configure.xml
View File

@@ -1,16 +1,15 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 990521c9ca64fe7d83016a613b850177d3a90776 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<section xml:id="luasandbox.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="luasandbox.installation">
&reftitle.install;
<para>
<simpara>
&pecl.info;
<link xlink:href="&url.pecl.package;luasandbox">&url.pecl.package;luasandbox</link>
</para>
</simpara>
</section>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

66
reference/luasandbox/differences.xml
View File

@@ -1,68 +1,68 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: cc1fd3979ee4c308ca9c086583c4d0e45549d3fe Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="reference.luasandbox.differences">
<title>Diferencias con Lua estándar</title>
<para>
<simpara>
LuaSandbox proporciona un entorno seguro que difiere en algunos aspectos de Lua 5.1 estándar.
</para>
</simpara>
<simplesect xml:id="reference.luasandbox.differences.unavailable">
<title>Funcionalidades no disponibles</title>
<itemizedlist>
<listitem>
<para>
<simpara>
Los paquetes <literal>dofile()</literal>, <literal>loadfile()</literal>, y <literal>io</literal>, ya que permiten acceso directo al sistema de ficheros. Si es necesario, el acceso al sistema de ficheros debe realizarse a través de funciones de retrollamada PHP.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
El paquete <literal>package</literal>, incluyendo <literal>require()</literal> y <literal>module()</literal>, ya que depende en gran medida del acceso directo al sistema de ficheros. Una reescritura pura de Lua como la utilizada en la extensión MediaWiki Scribunto puede ser utilizada en su lugar.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
<literal>load()</literal> y <literal>loadstring()</literal>, para permitir el análisis estático del código Lua.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
<literal>print()</literal>, ya que escribe en la salida estándar. Si es necesario, la salida debe realizarse a través de funciones de retrollamada PHP.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
La mayoría del paquete <literal>os</literal>, ya que permite la manipulación del proceso y la ejecución de otros procesos.
</para>
</simpara>
<itemizedlist>
<listitem>
<para>
<simpara>
<literal>os.clock()</literal>, <literal>os.date()</literal>, <literal>os.difftime()</literal>, y <literal>os.time()</literal> siguen estando disponibles.
</para>
</simpara>
</listitem>
</itemizedlist>
</listitem>
<listitem>
<para>
<simpara>
La mayoría del paquete <literal>debug</literal>, ya que permite la manipulación del estado Lua y de los metadatos de manera que puede romper el aislamiento.
</para>
</simpara>
<itemizedlist>
<listitem>
<para>
<simpara>
<literal>debug.traceback()</literal> sigue estando disponible.
</para>
</simpara>
</listitem>
</itemizedlist>
</listitem>
<listitem>
<para>
<simpara>
<literal>string.dump()</literal>, ya que puede exponer datos internos.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
El paquete <literal>collectgarbage()</literal>, <literal>gcinfo()</literal>, y <literal>coroutine</literal> no han sido examinados en cuanto a seguridad.
</para>
</simpara>
</listitem>
</itemizedlist>
</simplesect>
@@ -71,29 +71,29 @@
<title>Funcionalidades que han sido modificadas</title>
<itemizedlist>
<listitem>
<para>
<simpara>
<literal>pcall()</literal> y <literal>xpcall()</literal> no pueden capturar ciertos errores, en particular los errores de tiempo límite.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
<literal>tostring()</literal> no incluye las direcciones de puntero.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
<literal>string.match()</literal> ha sido parcheado para limitar la profundidad de recursión y para verificar periódicamente un tiempo límite.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
<literal>math.random()</literal> y <literal>math.randomseed()</literal> son reemplazados por versiones que no comparten el estado con <literal>rand()</literal> de PHP.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
Las meta métodos de Lua 5.2 <literal>__pairs</literal> y <literal>__ipairs</literal> son soportadas por <literal>pairs()</literal> y <literal>ipairs()</literal>.
</para>
</simpara>
</listitem>
</itemizedlist>
</simplesect>

6
reference/luasandbox/examples.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: cc1fd3979ee4c308ca9c086583c4d0e45549d3fe Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="luasandbox.examples">
&reftitle.examples;
@@ -7,9 +7,9 @@
<!-- Make sure each xml:id is unique -->
<section xml:id="luasandbox.examples-basic">
<title>Uso básico de LuaSandbox</title>
<para>
<simpara>
Una vez que se ha compilado PHP con soporte para LuaSandbox, se puede comenzar a utilizar LuaSandbox para ejecutar de manera segura el código Lua proporcionado por el usuario.
</para>
</simpara>
<example>
<title>Ejecutar código Lua</title>
<programlisting role="php" xml:id="luasandbox.examples.uniqueidhere">

23
reference/luasandbox/luasandbox.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4d17b7b4947e7819ff5036715dd706be87ae4def Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.luasandbox" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<reference xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="class.luasandbox" role="class">
<title>La clase LuaSandbox</title>
<titleabbrev>LuaSandbox</titleabbrev>
@@ -10,10 +10,10 @@
<!-- {{{ LuaSandbox intro -->
<section xml:id="luasandbox.intro">
&reftitle.intro;
<para>
<simpara>
La clase LuaSandbox crea un entorno Lua y permite la ejecución de
código Lua.
</para>
</simpara>
</section>
<!-- }}} -->
@@ -52,7 +52,7 @@
</fieldsynopsis>
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.luasandbox')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])" />
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.luasandbox')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"/>
</classsynopsis>
<!-- }}} -->
@@ -66,27 +66,27 @@
<varlistentry xml:id="luasandbox.constants.samples">
<term><constant>LuaSandbox::SAMPLES</constant></term>
<listitem>
<para>
<simpara>
Utilizado con <methodname>LuaSandbox::getProfilerFunctionReport</methodname> para devolver las duraciones en muestras.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="luasandbox.constants.seconds">
<term><constant>LuaSandbox::SECONDS</constant></term>
<listitem>
<para>
<simpara>
Utilizado con <methodname>LuaSandbox::getProfilerFunctionReport</methodname> para devolver las duraciones en segundos.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="luasandbox.constants.percent">
<term><constant>LuaSandbox::PERCENT</constant></term>
<listitem>
<para>
<simpara>
Utilizado con <methodname>LuaSandbox::getProfilerFunctionReport</methodname> para devolver las duraciones en porcentajes del total.
</para>
</simpara>
</listitem>
</varlistentry>
@@ -99,7 +99,6 @@
&reference.luasandbox.entities.luasandbox;
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

30
reference/luasandbox/luasandbox/callfunction.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: cc1fd3979ee4c308ca9c086583c4d0e45549d3fe Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="luasandbox.callfunction">
<refnamediv>
@@ -14,20 +14,20 @@
<methodparam><type>string</type><parameter>name</parameter></methodparam>
<methodparam rep="repeat"><type>mixed</type><parameter>args</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Llama a una función en una variable global Lua.
</para>
<para>
</simpara>
<simpara>
Si el nombre contiene caracteres ".", la función se localiza a través
de accesos recursivos a la tabla, como si el nombre fuera una expresión Lua.
</para>
<para>
</simpara>
<simpara>
Si la variable no existe, o no es una función, se devolverá false y se emitirá un aviso.
</para>
<para>
</simpara>
<simpara>
Para más información sobre la llamada de funciones Lua y los valores de retorno,
ver <methodname>LuaSandboxFunction::call</methodname>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -36,17 +36,17 @@
<varlistentry>
<term><parameter>name</parameter></term>
<listitem>
<para>
<simpara>
Nombre de la variable Lua.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>args</parameter></term>
<listitem>
<para>
<simpara>
Argumentos de la función.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -54,9 +54,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve un <type>array</type> de los valores devueltos por la función Lua, que puede estar vacío, &return.falseforfailure;.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

10
reference/luasandbox/luasandbox/disableprofiler.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: cc1fd3979ee4c308ca9c086583c4d0e45549d3fe Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="luasandbox.disableprofiler">
<refnamediv>
@@ -13,9 +13,9 @@
<modifier>public</modifier> <type>void</type><methodname>LuaSandbox::disableProfiler</methodname>
<void/>
</methodsynopsis>
<para>
<simpara>
Desactiva el perfilador.
</para>
</simpara>
</refsect1>
@@ -26,9 +26,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.void;
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

18
reference/luasandbox/luasandbox/enableprofiler.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: cc1fd3979ee4c308ca9c086583c4d0e45549d3fe Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="luasandbox.enableprofiler">
<refnamediv>
@@ -13,12 +13,12 @@
<modifier>public</modifier> <type>bool</type><methodname>LuaSandbox::enableProfiler</methodname>
<methodparam choice="opt"><type>float</type><parameter>period</parameter><initializer>0.02</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Activa el perfilador. El perfilado comenzará cuando se ingrese código Lua.
</para>
<para>
</simpara>
<simpara>
El perfilador muestrea periódicamente el entorno Lua para registrar la función en ejecución. Las pruebas indican que, al menos en Linux, un período inferior a 1ms resultará en un número elevado de desbordamientos, pero sin problemas de rendimiento.
</para>
</simpara>
</refsect1>
@@ -28,9 +28,9 @@
<varlistentry>
<term><parameter>period</parameter></term>
<listitem>
<para>
<simpara>
Muestreo en segundos.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -38,9 +38,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve un bool indicando si el perfilador está activado.
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

18
reference/luasandbox/luasandbox/getcpuusage.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: cc1fd3979ee4c308ca9c086583c4d0e45549d3fe Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="luasandbox.getcpuusage">
<refnamediv>
@@ -13,12 +13,12 @@
<modifier>public</modifier> <type>float</type><methodname>LuaSandbox::getCPUUsage</methodname>
<void/>
</methodsynopsis>
<para>
<simpara>
Recupera el uso actual del tiempo de CPU del entorno Lua.
</para>
<para>
</simpara>
<simpara>
Esto incluye el tiempo pasado en las funciones de retrollamada PHP.
</para>
</simpara>
</refsect1>
@@ -29,14 +29,14 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve el uso actual del tiempo de CPU en segundos.
</para>
</simpara>
<note>
<para>
<simpara>
En Windows, esta función siempre devuelve cero. En los sistemas operativos que no soportan <constant>CLOCK_THREAD_CPUTIME_ID</constant>,
como FreeBSD y Mac OS X, esta función devolverá el tiempo transcurrido en el reloj, no el tiempo de CPU.
</para>
</simpara>
</note>
</refsect1>

10
reference/luasandbox/luasandbox/getmemoryusage.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: cc1fd3979ee4c308ca9c086583c4d0e45549d3fe Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="luasandbox.getmemoryusage">
<refnamediv>
@@ -13,9 +13,9 @@
<modifier>public</modifier> <type>int</type><methodname>LuaSandbox::getMemoryUsage</methodname>
<void/>
</methodsynopsis>
<para>
<simpara>
Recupera el uso actual de la memoria del entorno Lua.
</para>
</simpara>
</refsect1>
@@ -26,9 +26,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve el uso actual de la memoria en bytes.
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

10
reference/luasandbox/luasandbox/getpeakmemoryusage.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: cc1fd3979ee4c308ca9c086583c4d0e45549d3fe Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="luasandbox.getpeakmemoryusage">
<refnamediv>
@@ -13,9 +13,9 @@
<modifier>public</modifier> <type>int</type><methodname>LuaSandbox::getPeakMemoryUsage</methodname>
<void/>
</methodsynopsis>
<para>
<simpara>
Recupera el pico de uso de memoria del entorno Lua.
</para>
</simpara>
</refsect1>
@@ -26,9 +26,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve el pico de uso de memoria en bytes.
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

28
reference/luasandbox/luasandbox/getprofilerfunctionreport.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: cc1fd3979ee4c308ca9c086583c4d0e45549d3fe Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="luasandbox.getprofilerfunctionreport">
<refnamediv>
@@ -13,27 +13,27 @@
<modifier>public</modifier> <type>array</type><methodname>LuaSandbox::getProfilerFunctionReport</methodname>
<methodparam choice="opt"><type>int</type><parameter>units</parameter><initializer>LuaSandbox::SECONDS</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Para una instancia de perfilado previamente iniciada por
<methodname>LuaSandbox::enableProfiler</methodname>, recupera un
informe del costo de cada función.
</para>
<para>
</simpara>
<simpara>
La medición del costo se determina por el argumento
<varname>$units</varname>:
</para>
</simpara>
<variablelist>
<varlistentry>
<term><constant>LuaSandbox::SAMPLES</constant></term>
<listitem><para>Medición en número de muestras.</para></listitem>
<listitem><simpara>Medición en número de muestras.</simpara></listitem>
</varlistentry>
<varlistentry>
<term><constant>LuaSandbox::SECONDS</constant></term>
<listitem><para>Medición en segundos de tiempo CPU.</para></listitem>
<listitem><simpara>Medición en segundos de tiempo CPU.</simpara></listitem>
</varlistentry>
<varlistentry>
<term><constant>LuaSandbox::PERCENT</constant></term>
<listitem><para>Medición en porcentaje de tiempo CPU.</para></listitem>
<listitem><simpara>Medición en porcentaje de tiempo CPU.</simpara></listitem>
</varlistentry>
</variablelist>
</refsect1>
@@ -44,9 +44,9 @@
<varlistentry>
<term><parameter>units</parameter></term>
<listitem>
<para>
<simpara>
La unidad de medida constante.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -54,18 +54,18 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve las mediciones del perfilador, ordenadas en orden descendente, en forma
de un array asociativo. Las claves son los nombres de las funciones Lua (con el fichero fuente y la línea
definidos entre corchetes angulares), los valores son las mediciones en <type>int</type>
o <type>float</type>.
</para>
</simpara>
<note>
<para>
<simpara>
En Windows, esta función siempre devuelve cero. En los sistemas operativos que no soportan <constant>CLOCK_THREAD_CPUTIME_ID</constant>,
como FreeBSD y Mac OS X, esta función devolverá el tiempo transcurrido
en el reloj, no el tiempo CPU.
</para>
</simpara>
</note>
</refsect1>

10
reference/luasandbox/luasandbox/getversioninfo.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: cc1fd3979ee4c308ca9c086583c4d0e45549d3fe Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="luasandbox.getversioninfo">
<refnamediv>
@@ -13,9 +13,9 @@
<modifier>public</modifier> <modifier>static</modifier> <type>array</type><methodname>LuaSandbox::getVersionInfo</methodname>
<void/>
</methodsynopsis>
<para>
<simpara>
Devuelve las versiones de LuaSandbox y Lua.
</para>
</simpara>
</refsect1>
@@ -26,9 +26,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve un array con dos claves:
</para>
</simpara>
<informaltable>
<tgroup cols="3">
<thead>

18
reference/luasandbox/luasandbox/loadbinary.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: cc1fd3979ee4c308ca9c086583c4d0e45549d3fe Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="luasandbox.loadbinary">
<refnamediv>
@@ -14,9 +14,9 @@
<methodparam><type>string</type><parameter>code</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>chunkName</parameter><initializer>''</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Carga los datos generados por <methodname>LuaSandboxFunction::dump</methodname>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -25,17 +25,17 @@
<varlistentry>
<term><parameter>code</parameter></term>
<listitem>
<para>
<simpara>
Los datos de <methodname>LuaSandboxFunction::dump</methodname>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>chunkName</parameter></term>
<listitem>
<para>
<simpara>
El nombre del fragmento para la función cargada.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -43,9 +43,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve una <classname>LuaSandboxFunction</classname>.
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

22
reference/luasandbox/luasandbox/loadstring.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: cc1fd3979ee4c308ca9c086583c4d0e45549d3fe Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="luasandbox.loadstring">
<refnamediv>
@@ -14,12 +14,12 @@
<methodparam><type>string</type><parameter>code</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>chunkName</parameter><initializer>''</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Carga código Lua en el entorno Lua.
</para>
<para>
</simpara>
<simpara>
Esto es equivalente a la función <literal>loadstring()</literal> de Lua estándar.
</para>
</simpara>
</refsect1>
@@ -29,17 +29,17 @@
<varlistentry>
<term><parameter>code</parameter></term>
<listitem>
<para>
<simpara>
El código Lua.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>chunkName</parameter></term>
<listitem>
<para>
<simpara>
El nombre del fragmento cargado, para su uso en los rastros de error.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -47,9 +47,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve una <classname>LuaSandboxFunction</classname> que, al ejecutarse, ejecutará el <varname>$code</varname> pasado.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

18
reference/luasandbox/luasandbox/pauseusagetimer.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: cc1fd3979ee4c308ca9c086583c4d0e45549d3fe Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="luasandbox.pauseusagetimer">
<refnamediv>
@@ -13,22 +13,22 @@
<modifier>public</modifier> <type>bool</type><methodname>LuaSandbox::pauseUsageTimer</methodname>
<void/>
</methodsynopsis>
<para>
<simpara>
Pausa el temporizador de uso de la CPU.
</para>
<para>
</simpara>
<simpara>
Esto solo tiene efecto cuando se llama desde una retrollamada de Lua. Cuando
la ejecución vuelve a Lua, el temporizador se reiniciará automáticamente.
Si se realiza una nueva llamada a Lua, el temporizador se reiniciará
durante la duración de esa llamada.
</para>
<para>
</simpara>
<simpara>
Si una retrollamada PHP llama nuevamente a Lua con el temporizador sin pausar, y
esa función Lua llama nuevamente a PHP, la segunda llamada PHP no podrá
pausar el temporizador. La lógica es que incluso si la segunda llamada PHP
evita contar el uso de la CPU contra el límite, la primera
llamada sigue contándolo.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -38,9 +38,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve un <type>bool</type> indicando si el temporizador está ahora en pausa.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

22
reference/luasandbox/luasandbox/registerlibrary.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: cc1fd3979ee4c308ca9c086583c4d0e45549d3fe Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="luasandbox.registerlibrary">
<refnamediv>
@@ -14,14 +14,14 @@
<methodparam><type>string</type><parameter>libname</parameter></methodparam>
<methodparam><type>array</type><parameter>functions</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Registra un conjunto de funciones PHP como una biblioteca Lua, de modo que Lua pueda
llamar al código PHP correspondiente.
</para>
<para>
</simpara>
<simpara>
Para más información sobre la llamada de funciones Lua y los valores de retorno,
ver <methodname>LuaSandboxFunction::call</methodname>.
</para>
</simpara>
</refsect1>
@@ -31,20 +31,20 @@
<varlistentry>
<term><parameter>libname</parameter></term>
<listitem>
<para>
<simpara>
El nombre de la biblioteca. En el estado Lua, la variable global de este
nombre se definirá en la tabla de funciones. Si la tabla ya existe,
las nuevas funciones se añadirán a ella.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>functions</parameter></term>
<listitem>
<para>
<simpara>
Un <type>array</type>, donde cada clave es un nombre de función, y cada valor es un
<type>callable</type> PHP correspondiente.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -52,9 +52,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.void;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

30
reference/luasandbox/luasandbox/setcpulimit.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: cc1fd3979ee4c308ca9c086583c4d0e45549d3fe Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="luasandbox.setcpulimit">
<refnamediv>
@@ -13,26 +13,26 @@
<modifier>public</modifier> <type>void</type><methodname>LuaSandbox::setCPULimit</methodname>
<methodparam><type class="union"><type>float</type><type>bool</type></type><parameter>limit</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Define la limitación de tiempo CPU para el entorno Lua.
</para>
<para>
</simpara>
<simpara>
Si el tiempo total de usuario y sistema utilizado por el entorno después
de la llamada a este método excede este límite, se lanza una excepción
<classname>LuaSandboxTimeoutError</classname>.
</para>
<para>
</simpara>
<simpara>
El tiempo utilizado en las funciones de retrollamada PHP se incluye en el límite.
</para>
<para>
</simpara>
<simpara>
Definir el tiempo límite a una función de retrollamada Lua en ejecución provoca
que el temporizador se reinicie, o se inicie si no estaba ya en ejecución.
</para>
</simpara>
<note>
<para>
<simpara>
En Windows, la limitación de tiempo CPU será ignorada. En los sistemas operativos
que no soportan <constant>CLOCK_THREAD_CPUTIME_ID</constant>, como FreeBSD y Mac OS X, el tiempo transcurrido en el muro, en lugar del tiempo CPU, será limitado.
</para>
</simpara>
</note>
</refsect1>
@@ -42,9 +42,9 @@
<varlistentry>
<term><parameter>limit</parameter></term>
<listitem>
<para>
<simpara>
El límite como <type>float</type> en segundos, o &false; para ningún límite.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -52,9 +52,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.void;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

18
reference/luasandbox/luasandbox/setmemorylimit.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: cc1fd3979ee4c308ca9c086583c4d0e45549d3fe Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="luasandbox.setmemorylimit">
<refnamediv>
@@ -13,13 +13,13 @@
<modifier>public</modifier> <type>void</type><methodname>LuaSandbox::setMemoryLimit</methodname>
<methodparam><type>int</type><parameter>limit</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Define el límite de memoria para el entorno Lua.
</para>
<para>
</simpara>
<simpara>
Si se supera este límite, se lanza una
excepción <classname>LuaSandboxMemoryError</classname>.
</para>
</simpara>
</refsect1>
@@ -29,9 +29,9 @@
<varlistentry>
<term><parameter>limit</parameter></term>
<listitem>
<para>
<simpara>
El límite de memoria en bytes.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -39,9 +39,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.void;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

10
reference/luasandbox/luasandbox/unpauseusagetimer.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: cc1fd3979ee4c308ca9c086583c4d0e45549d3fe Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="luasandbox.unpauseusagetimer">
<refnamediv>
@@ -13,9 +13,9 @@
<modifier>public</modifier> <type>void</type><methodname>LuaSandbox::unpauseUsageTimer</methodname>
<void/>
</methodsynopsis>
<para>
<simpara>
Reanuda el temporizador de uso pausado por <methodname>LuaSandbox::pauseUsageTimer</methodname>.
</para>
</simpara>
</refsect1>
@@ -26,9 +26,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.void;
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

26
reference/luasandbox/luasandbox/wrapphpfunction.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: cc1fd3979ee4c308ca9c086583c4d0e45549d3fe Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="luasandbox.wrapphpfunction">
<refnamediv>
@@ -13,23 +13,23 @@
<modifier>public</modifier> <type>LuaSandboxFunction</type><methodname>LuaSandbox::wrapPhpFunction</methodname>
<methodparam><type>callable</type><parameter>function</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Envuelve una función PHP en una <classname>LuaSandboxFunction</classname>, de modo
que pueda ser pasada a Lua como una función anónima.
</para>
<para>
</simpara>
<simpara>
La función debe devolver un array de valores (que puede estar vacío),
o &null; que es equivalente a devolver el array vacío.
</para>
<para>
</simpara>
<simpara>
Las excepciones serán lanzadas como errores en Lua, sin embargo, solo las
excepciones <classname>LuaSandboxRuntimeError</classname> pueden ser capturadas
dentro de Lua con <literal>pcall()</literal> o <literal>xpcall()</literal>.
</para>
<para>
</simpara>
<simpara>
Para más información sobre la llamada de funciones Lua y los valores de retorno,
ver <methodname>LuaSandboxFunction::call</methodname>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -38,9 +38,9 @@
<varlistentry>
<term><parameter>function</parameter></term>
<listitem>
<para>
<simpara>
La función de retrollamada a envolver.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -48,9 +48,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve un <classname>LuaSandboxFunction</classname>.
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

21
reference/luasandbox/luasandboxerror.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4d17b7b4947e7819ff5036715dd706be87ae4def Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.luasandboxerror" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<reference xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="class.luasandboxerror" role="class">
<title>La clase LuaSandboxError</title>
<titleabbrev>LuaSandboxError</titleabbrev>
@@ -10,9 +10,9 @@
<!-- {{{ LuaSandboxError intro -->
<section xml:id="luasandboxerror.intro">
&reftitle.intro;
<para>
<simpara>
La clase base para las excepciones LuaSandbox
</para>
</simpara>
</section>
<!-- }}} -->
@@ -62,7 +62,7 @@
</fieldsynopsis>
<classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('exception.synopsis')/descendant::db:fieldsynopsis)" />
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('exception.synopsis')/descendant::db:fieldsynopsis)"/>
<!--
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
@@ -70,7 +70,7 @@
-->
<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])" />
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"/>
</classsynopsis>
<!-- }}} -->
@@ -85,28 +85,28 @@
<varlistentry xml:id="luasandboxerror.constants.run">
<term><constant>LuaSandboxError::RUN</constant></term>
<listitem>
<para></para>
<simpara/>
</listitem>
</varlistentry>
<varlistentry xml:id="luasandboxerror.constants.syntax">
<term><constant>LuaSandboxError::SYNTAX</constant></term>
<listitem>
<para></para>
<simpara/>
</listitem>
</varlistentry>
<varlistentry xml:id="luasandboxerror.constants.mem">
<term><constant>LuaSandboxError::MEM</constant></term>
<listitem>
<para></para>
<simpara/>
</listitem>
</varlistentry>
<varlistentry xml:id="luasandboxerror.constants.err">
<term><constant>LuaSandboxError::ERR</constant></term>
<listitem>
<para></para>
<simpara/>
</listitem>
</varlistentry>
@@ -119,7 +119,6 @@
<!-- &reference.luasandbox.entities.luasandboxerror; -->
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

13
reference/luasandbox/luasandboxerrorerror.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4d17b7b4947e7819ff5036715dd706be87ae4def Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.luasandboxerrorerror" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<reference xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="class.luasandboxerrorerror" role="class">
<title>La clase LuaSandboxErrorError</title>
<titleabbrev>LuaSandboxErrorError</titleabbrev>
@@ -10,9 +10,9 @@
<!-- {{{ LuaSandboxErrorError intro -->
<section xml:id="luasandboxerrorerror.intro">
&reftitle.intro;
<para>
<simpara>
Excepción lanzada cuando Lua encuentra un error dentro de un gestor de errores.
</para>
</simpara>
</section>
<!-- }}} -->
@@ -37,7 +37,7 @@
<!-- }}} -->
<classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('exception.synopsis')/descendant::db:fieldsynopsis)" />
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('exception.synopsis')/descendant::db:fieldsynopsis)"/>
<!--
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
@@ -45,7 +45,7 @@
-->
<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])" />
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"/>
</classsynopsis>
<!-- }}} -->
@@ -57,7 +57,6 @@
<!-- &reference.luasandbox.entities.luasandboxerrorerror; -->
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

17
reference/luasandbox/luasandboxfatalerror.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4d17b7b4947e7819ff5036715dd706be87ae4def Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.luasandboxfatalerror" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<reference xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="class.luasandboxfatalerror" role="class">
<title>La clase LuaSandboxFatalError</title>
<titleabbrev>LuaSandboxFatalError</titleabbrev>
@@ -10,13 +10,13 @@
<!-- {{{ LuaSandboxFatalError intro -->
<section xml:id="luasandboxfatalerror.intro">
&reftitle.intro;
<para>
<simpara>
Las excepciones LuaSandbox que no pueden ser atrapadas.
</para>
<para>
</simpara>
<simpara>
Estas excepciones no pueden ser atrapadas en Lua utilizando
<literal>pcall()</literal> o <literal>xpcall()</literal>.
</para>
</simpara>
</section>
<!-- }}} -->
@@ -41,7 +41,7 @@
<!-- }}} -->
<classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('exception.synopsis')/descendant::db:fieldsynopsis)" />
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('exception.synopsis')/descendant::db:fieldsynopsis)"/>
<!--
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
@@ -49,7 +49,7 @@
-->
<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])" />
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"/>
</classsynopsis>
<!-- }}} -->
@@ -61,7 +61,6 @@
<!-- &reference.luasandbox.entities.luasandboxfatalerror; -->
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

15
reference/luasandbox/luasandboxfunction.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4d17b7b4947e7819ff5036715dd706be87ae4def Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.luasandboxfunction" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<reference xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="class.luasandboxfunction" role="class">
<title>La clase LuaSandboxFunction</title>
<titleabbrev>LuaSandboxFunction</titleabbrev>
@@ -10,16 +10,16 @@
<!-- {{{ LuaSandboxFunction intro -->
<section xml:id="luasandboxfunction.intro">
&reftitle.intro;
<para>
<simpara>
Representa una función Lua, permitiendo llamarla desde PHP.
</para>
<para>
</simpara>
<simpara>
Una LuaSandboxFunction puede ser obtenida como valor de retorno desde Lua, como argumento
pasado a una retrollamada desde Lua, o utilizando
<methodname>LuaSandbox::wrapPhpFunction</methodname>,
<methodname>LuaSandbox::loadString</methodname>, o
<methodname>LuaSandbox::loadBinary</methodname>.
</para>
</simpara>
</section>
<!-- }}} -->
@@ -39,7 +39,7 @@
<!-- }}} -->
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.luasandboxfunction')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])" />
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.luasandboxfunction')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"/>
</classsynopsis>
<!-- }}} -->
@@ -50,7 +50,6 @@
&reference.luasandbox.entities.luasandboxfunction;
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

72
reference/luasandbox/luasandboxfunction/call.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: cc1fd3979ee4c308ca9c086583c4d0e45549d3fe Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="luasandboxfunction.call">
<refnamediv>
@@ -13,82 +13,82 @@
<modifier>public</modifier> <type class="union"><type>array</type><type>bool</type></type><methodname>LuaSandboxFunction::call</methodname>
<methodparam rep="repeat"><type>string</type><parameter>args</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Llama a una función Lua.
</para>
<para>
</simpara>
<simpara>
Los errores considerados como culpa del código PHP harán que la función devuelva el valor &false; y emita <constant>E_WARNING</constant>, por ejemplo, un tipo <type>resource</type> utilizado como argumento. Los errores Lua lanzarán una excepción <classname>LuaSandboxRuntimeError</classname>.
</para>
<para>
</simpara>
<simpara>
Los tipos PHP y Lua se convierten de la siguiente manera:
</para>
</simpara>
<itemizedlist>
<listitem>
<para>Los &null; de PHP son Lua <literal>nil</literal>, y viceversa.</para>
<simpara>Los &null; de PHP son Lua <literal>nil</literal>, y viceversa.</simpara>
</listitem>
<listitem>
<para>
<simpara>
Los <type>int</type>s de PHP y <type>float</type>s se convierten en números Lua. El infinito y <constant>NAN</constant> son soportados.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
Los números Lua sin parte fraccionaria entre aproximadamente <literal>-2**53</literal> y <literal>2**53</literal> se convierten en <type>int</type>s PHP, los demás se convierten en <type>float</type>s PHP.
</para>
</simpara>
</listitem>
<listitem>
<para>Los <type>bool</type>s de PHP son booleanos Lua, y viceversa.</para>
<simpara>Los <type>bool</type>s de PHP son booleanos Lua, y viceversa.</simpara>
</listitem>
<listitem>
<para>Los <type>string</type>s de PHP son cadenas Lua, y viceversa.</para>
<simpara>Los <type>string</type>s de PHP son cadenas Lua, y viceversa.</simpara>
</listitem>
<listitem>
<para>
<simpara>
Las funciones Lua son objetos PHP <classname>LuaSandboxFunction</classname>, y viceversa. Los <type>callable</type>s PHP generales no son soportados.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
Los <type>array</type>s de PHP se convierten en tablas Lua, y viceversa.
</para>
</simpara>
<itemizedlist>
<listitem>
<para>
<simpara>
Se debe tener en cuenta que Lua indexa típicamente los arrays a partir de 1, mientras que PHP indexa los arrays a partir de 0. No se hace ningún ajuste para estas diferentes convenciones.
</para>
</simpara>
</listitem>
<listitem>
<para>Los arrays auto-referenciales no son soportados en ambos sentidos.</para>
<simpara>Los arrays auto-referenciales no son soportados en ambos sentidos.</simpara>
</listitem>
<listitem>
<para>Las referencias PHP son desreferenciadas.</para>
<simpara>Las referencias PHP son desreferenciadas.</simpara>
</listitem>
<listitem>
<para>
<simpara>
Los <literal>__pairs</literal> y <literal>__ipairs</literal> de Lua son tratados. <literal>__index</literal> es ignorado.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
Al convertir de PHP a Lua, las claves enteras entre <literal>-2**53</literal> y <literal>2**53</literal> se representan como números Lua. Todas las demás claves se representan como cadenas Lua.
</para>
</simpara>
</listitem>
<listitem>
<para>
<simpara>
Al convertir de Lua a PHP, las claves distintas de las cadenas y los números enteros resultarán en un error, así como las colisiones al convertir números en cadenas o viceversa (ya que PHP considera cosas como <literal>$a[0]</literal> y <literal>$a["0"]</literal> como equivalentes).
</para>
</simpara>
</listitem>
</itemizedlist>
</listitem>
<listitem>
<para>
<simpara>
Todos los demás tipos no son soportados y resultarán en un error/excepción, incluyendo los <type>object</type>s PHP generales y los tipos userdata y thread Lua.
</para>
</simpara>
</listitem>
</itemizedlist>
<para>
<simpara>
Las funciones Lua devuelven intrínsecamente una lista de resultados. Por lo tanto, en caso de éxito, este método devuelve un <type>array</type> que contiene todos los valores devueltos por Lua, con claves <type>int</type> comenzando en cero. Lua puede no devolver ningún resultado, en cuyo caso se devuelve un array vacío.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -97,9 +97,9 @@
<varlistentry>
<term><parameter>args</parameter></term>
<listitem>
<para>
<simpara>
Los argumentos pasados a la función.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -107,9 +107,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve un <type>array</type> de los valores devueltos por la función, que puede estar vacío, &return.falseforfailure;.
</para>
</simpara>
</refsect1>
</refentry>

11
reference/luasandbox/luasandboxfunction/construct.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 990521c9ca64fe7d83016a613b850177d3a90776 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="luasandboxfunction.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="luasandboxfunction.construct">
<refnamediv>
<refname>LuaSandboxFunction::__construct</refname>
<refpurpose>No utilizado</refpurpose>
@@ -11,15 +11,15 @@
&reftitle.description;
<constructorsynopsis>
<modifier>final</modifier> <modifier>private</modifier> <methodname>LuaSandboxFunction::__construct</methodname>
<void />
<void/>
</constructorsynopsis>
<para>
<simpara>
Los <classname>LuaSandboxFunction</classname> se obtienen como valor de retorno de Lua,
como argumento pasado a una retrollamada desde Lua, o utilizando
<methodname>LuaSandbox::wrapPhpFunction</methodname>,
<methodname>LuaSandbox::loadString</methodname>, o
<methodname>LuaSandbox::loadBinary</methodname>. No pueden ser construidos directamente.
</para>
</simpara>
</refsect1>
@@ -29,7 +29,6 @@
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

15
reference/luasandbox/luasandboxfunction/dump.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 990521c9ca64fe7d83016a613b850177d3a90776 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="luasandboxfunction.dump" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="luasandboxfunction.dump">
<refnamediv>
<refname>LuaSandboxFunction::dump</refname>
<refpurpose>Muestra la función como un blob binario</refpurpose>
@@ -11,11 +11,11 @@
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier> <type>string</type><methodname>LuaSandboxFunction::dump</methodname>
<void />
<void/>
</methodsynopsis>
<para>
<simpara>
Muestra la función como un blob binario.
</para>
</simpara>
</refsect1>
@@ -26,13 +26,12 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve un string que puede ser pasado a <methodname>LuaSandbox::loadBinary</methodname>.
</para>
</simpara>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

6
reference/luasandbox/luasandboxmemoryerror.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: cc1fd3979ee4c308ca9c086583c4d0e45549d3fe Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<reference xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="class.luasandboxmemoryerror" role="class">
<title>La clase LuaSandboxMemoryError</title>
@@ -10,9 +10,9 @@
<!-- {{{ LuaSandboxMemoryError intro -->
<section xml:id="luasandboxmemoryerror.intro">
&reftitle.intro;
<para>
<simpara>
Excepción lanzada cuando Lua no puede asignar memoria.
</para>
</simpara>
</section>
<!-- }}} -->

17
reference/luasandbox/luasandboxruntimeerror.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4d17b7b4947e7819ff5036715dd706be87ae4def Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.luasandboxruntimeerror" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<reference xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="class.luasandboxruntimeerror" role="class">
<title>La clase LuaSandboxRuntimeError</title>
<titleabbrev>LuaSandboxRuntimeError</titleabbrev>
@@ -10,13 +10,13 @@
<!-- {{{ LuaSandboxRuntimeError intro -->
<section xml:id="luasandboxruntimeerror.intro">
&reftitle.intro;
<para>
<simpara>
Las excepciones de ejecución LuaSandbox que pueden ser capturadas.
</para>
<para>
</simpara>
<simpara>
Estas excepciones pueden ser capturadas en Lua utilizando
<literal>pcall()</literal> o <literal>xpcall()</literal>.
</para>
</simpara>
</section>
<!-- }}} -->
@@ -41,7 +41,7 @@
<!-- }}} -->
<classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('exception.synopsis')/descendant::db:fieldsynopsis)" />
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('exception.synopsis')/descendant::db:fieldsynopsis)"/>
<!--
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
@@ -49,7 +49,7 @@
-->
<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])" />
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"/>
</classsynopsis>
<!-- }}} -->
@@ -61,7 +61,6 @@
<!-- &reference.luasandbox.entities.luasandboxruntimeerror; -->
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

13
reference/luasandbox/luasandboxsyntaxerror.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4d17b7b4947e7819ff5036715dd706be87ae4def Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.luasandboxsyntaxerror" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<reference xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="class.luasandboxsyntaxerror" role="class">
<title>La clase LuaSandboxSyntaxError</title>
<titleabbrev>LuaSandboxSyntaxError</titleabbrev>
@@ -10,9 +10,9 @@
<!-- {{{ LuaSandboxSyntaxError intro -->
<section xml:id="luasandboxsyntaxerror.intro">
&reftitle.intro;
<para>
<simpara>
Excepción lanzada cuando el código Lua no puede ser analizado.
</para>
</simpara>
</section>
<!-- }}} -->
@@ -37,7 +37,7 @@
<!-- }}} -->
<classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('exception.synopsis')/descendant::db:fieldsynopsis)" />
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('exception.synopsis')/descendant::db:fieldsynopsis)"/>
<!--
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
@@ -45,7 +45,7 @@
-->
<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])" />
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])"/>
</classsynopsis>
<!-- }}} -->
@@ -57,7 +57,6 @@
<!-- &reference.luasandbox.entities.luasandboxsyntaxerror; -->
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

6
reference/luasandbox/luasandboxtimeouterror.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: cc1fd3979ee4c308ca9c086583c4d0e45549d3fe Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<reference xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="class.luasandboxtimeouterror" role="class">
<title>La clase LuaSandboxTimeoutError</title>
@@ -10,9 +10,9 @@
<!-- {{{ LuaSandboxTimeoutError intro -->
<section xml:id="luasandboxtimeouterror.intro">
&reftitle.intro;
<para>
<simpara>
Excepción lanzada cuando se supera el límite de tiempo de CPU configurado.
</para>
</simpara>
</section>
<!-- }}} -->

29
reference/luasandbox/setup.xml
View File

@@ -1,37 +1,37 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 48ce43fe79fa0c9f31f187ea8ec995b4cb13037e Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<chapter xml:id="luasandbox.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="luasandbox.setup">
&reftitle.setup;
<section xml:id="luasandbox.requirements">
&reftitle.required;
<para>
<simpara>
Para utilizar esta extensión, Lua 5.1 debe estar instalado, disponible en la <link xlink:href="&url.lua;">página de inicio de Lua</link>.
</para>
<para>
</simpara>
<simpara>
Para utilizar las funcionalidades de temporizador, LuaSandbox debe estar instalado en
Linux.
</para>
<para>
</simpara>
<simpara>
Si se utiliza FreeBSD o Mac OS X, solo se soporta el tiempo real (reloj de pared), las funciones que pretenden devolver el tiempo de CPU devolverán
en realidad el tiempo del reloj de pared.
</para>
<para>
</simpara>
<simpara>
Si se utiliza Windows, ninguna función de temporizador será soportada. Los límites de tiempo
serán inoperantes.
</para>
</simpara>
</section>
<section xml:id="luasandbox.installation">
&reftitle.install;
<para>
<simpara>
&pecl.moved;
</para>
<para>
</simpara>
<simpara>
&pecl.info;
<link xlink:href="&url.pecl.package;luasandbox">&url.pecl.package;luasandbox</link>.
</para>
</simpara>
<para>
Si el sistema operativo es Debian 10 o más reciente, o Ubuntu 18.04 o más reciente, entonces
LuaSandbox debería ser típicamente instalado desde el paquete
@@ -45,7 +45,6 @@ sudo apt-get install php-luasandbox
</section>
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml