archived-doc-ru/reference/luasandbox/differences.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 9c40251a81d8f369c184e83fd142c4cc656a7261 Maintainer: sergey 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>Отличия от стандартного Lua</title>

 <simpara>
  LuaSandbox предоставляет изолированную среду, которая в некоторых отношениях отличается от стандартной Lua 5.1.
 </simpara>

 <simplesect xml:id="reference.luasandbox.differences.unavailable">
  <title>Функции, которые недоступны</title>
  <itemizedlist>
   <listitem>
    <simpara>
     <literal>dofile()</literal>, <literal>loadfile()</literal> и пакет <literal>io</literal>, поскольку они разрешают прямой доступ к файловой системе.
     При необходимости доступ к файловой системе должен осуществляться через callback-функции PHP.
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     Пакет <literal>package</literal>, включая <literal>require()</literal> и <literal>module()</literal>, так как он сильно зависит от прямого доступа к файловой системе.
     Вместо него можно использовать перезапись на чистом Lua, такую как та, что используется в модуле MediaWiki Scribunto.
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <literal>load()</literal> и <literal>loadstring()</literal>, для статического анализа кода Lua.
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <literal>print()</literal>, поскольку функция выводит в стандартный вывод. При необходимости вывод должен выполняться через callback-функции PHP.
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     Большая часть пакета <literal>os</literal>, поскольку он позволяет управлять процессом и выполнять другие процессы.
    </simpara>
    <itemizedlist>
     <listitem>
      <simpara>
       <literal>os.clock()</literal>, <literal>os.date()</literal>, <literal>os.difftime()</literal> и <literal>os.time()</literal> остаются доступными.
      </simpara>
     </listitem>
    </itemizedlist>
   </listitem>
   <listitem>
    <simpara>
     Большая часть пакета <literal>debug</literal>, поскольку он позволяет манипулировать состоянием Lua и метаданными способами, которые могут нарушить песочницу.
    </simpara>
    <itemizedlist>
     <listitem>
      <simpara>
       <literal>debug.traceback()</literal> остаётся доступным.
       </simpara>
     </listitem>
    </itemizedlist>
   </listitem>
   <listitem>
    <simpara>
     <literal>string.dump()</literal>, так как это может раскрыть внутренние данные.
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <literal>collectgarbage()</literal>, <literal>gcinfo()</literal> и пакет <literal>coroutine</literal> не были проверены на безопасность.
    </simpara>
   </listitem>
  </itemizedlist>
 </simplesect>

 <simplesect xml:id="reference.luasandbox.differences.modified">
  <title>Изменённые функции</title>
  <itemizedlist>
   <listitem>
    <simpara>
     <literal>pcall()</literal> и <literal>xpcall()</literal> не может отловить определённые ошибки, особенно ошибки времени ожидания.
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <literal>tostring()</literal> не включает адреса указателей.
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <literal>string.match()</literal> была исправлена для ограничения глубины рекурсии и периодической проверки времени ожидания.
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <literal>math.random()</literal> и <literal>math.randomseed()</literal> заменяются версиями, которые не разделяют состояние с функцией PHP <literal>rand()</literal>.
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     Метаметоды <literal>__pairs</literal> и <literal>__ipairs</literal> Lua 5.2 поддерживаются с помощью <literal>pairs()</literal> и <literal>ipairs()</literal>.
    </simpara>
   </listitem>
  </itemizedlist>
 </simplesect>

</chapter>
<!-- 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
-->