archived-doc-ru/reference/phpdbg/book.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 06f14554e7e5d9a47de0eff61578759fea2e23d9 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="book.phpdbg">
 <?phpdoc extension-membership="bundled" ?>
 <title>Интерактивный отладчик PHP</title>
 <titleabbrev>phpdbg</titleabbrev>

 <preface xml:id="intro.phpdbg">
  &reftitle.intro;
  <simpara>
   Поскольку phpdbg реализован в виде модуля SAPI, то он может полностью контролировать
   окружение без воздействия на функциональность и скорость выполнения вашего кода.
  </simpara>
  <para>
   Phpdbg претендует на то, чтобы считаться легковесным, мощным и простым в использовании
   отладчиком для PHP.
   Он предоставляет следующие возможности:
   <itemizedlist>
    <listitem>
     <simpara>Пошаговая отладка</simpara>
    </listitem>
    <listitem>
     <simpara>Гибкие точки прерывания (метод класса, функция, строка файла, адрес, опкод)</simpara>
    </listitem>
    <listitem>
     <simpara>Лёгкий доступ к PHP с помощью встроенной функции eval()</simpara>
    </listitem>
    <listitem>
     <simpara>Пользовательское API</simpara>
    </listitem>
    <listitem>
     <simpara>Независимость от SAPI - легко интегрируется</simpara>
    </listitem>
    <listitem>
     <simpara>Поддержка конфигурационных файлов PHP</simpara>
    </listitem>
    <listitem>
     <simpara>Определение собственных суперглобальных переменных JIT</simpara>
    </listitem>
    <listitem>
     <simpara>Опциональная поддержка ввода с клавиатуры - удобная работа через терминал</simpara>
    </listitem>
    <listitem>
     <simpara>Лёгок в использовании - читайте документацию :)</simpara>
    </listitem>
   </itemizedlist>
  </para>

  <table>
   <title>Опции командной строки</title>
   <tgroup cols="2">
    <thead>
     <row>
      <entry>Опция</entry>
      <entry>Пример аргумента</entry>
      <entry>Описание</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry>-c</entry>
      <entry>-c/my/php.ini</entry>
      <entry>
       Указывает php.ini, который надо загрузить
      </entry>
     </row>
     <row>
      <entry>-d</entry>
      <entry>-dmemory_limit=4G</entry>
      <entry>
       Установка соответствующей директивы php.ini
      </entry>
     </row>
     <row>
      <entry>-n</entry>
      <entry/>
      <entry>
       Запрет использования стандартного php.ini
      </entry>
     </row>
     <row>
      <entry>-q</entry>
      <entry/>
      <entry>
       Не показывать приветственный баннер
      </entry>
     </row>
     <row>
      <entry>-v</entry>
      <entry/>
      <entry>
       Разрешить вывод oplog
      </entry>
     </row>
     <row>
      <entry>-b</entry>
      <entry/>
      <entry>
       Запретить использование цветов
      </entry>
     </row>
     <row>
      <entry>-i</entry>
      <entry>-imy.init</entry>
      <entry>
       Задать файл .phpdbginit
      </entry>
     </row>
     <row>
      <entry>-I</entry>
      <entry/>
      <entry>
       Игнорировать стандартный .phpdbginit
      </entry>
     </row>
     <row>
      <entry>-O</entry>
      <entry>-Omy.oplog</entry>
      <entry>
       Задать файл для записи oplog
      </entry>
     </row>
     <row>
      <entry>-r</entry>
      <entry/>
      <entry>
       Запустить контекст исполнения
      </entry>
     </row>
     <row>
      <entry>-rr</entry>
      <entry/>
      <entry>
       Запустить контекст исполнения и выйти после запуска (не обращать внимание на точки останова)
      </entry>
     </row>
     <row>
      <entry>-e</entry>
      <entry/>
      <entry>
       Генерировать расширенную информацию для отладчика/профилировщика
      </entry>
     </row>
     <row>
      <entry>-E</entry>
      <entry/>
      <entry>
       Разрешить пошаговый eval. Будьте осторожны!
      </entry>
     </row>
     <row>
      <entry>-s</entry>
      <entry>-s=, -s=foo</entry>
      <entry>
       Прочитать код для исполнения из стандартного потока ввода с опциональным разделителем
      </entry>
     </row>
     <row>
      <entry>-S</entry>
      <entry>-Scli</entry>
      <entry>
       Переопределить имя SAPI. Будьте осторожны!
      </entry>
     </row>
     <row>
      <entry/>
      <entry/>
      <entry>
       <simpara>
       </simpara>
      </entry>
     </row>
     <row>
      <entry>-l</entry>
      <entry>-l4000</entry>
      <entry>
       Задать порт удалённой консоли
      </entry>
     </row>
     <row>
      <entry>-a</entry>
      <entry>-a192.168.0.3</entry>
      <entry>
       Задать адрес удалённой консоли
      </entry>
     </row>
     <row>
      <entry>-x</entry>
      <entry/>
      <entry>
       Включить вывод в формате xml (вместо стандартного текстового)
      </entry>
     </row>
     <row>
      <entry>-p</entry>
      <entry>-p, -p=func, -p*</entry>
      <entry>
       Вывести опкоды и выйти
      </entry>
     </row>
     <row>
      <entry>-h</entry>
      <entry/>
      <entry>
       Вывести справочный раздел
      </entry>
     </row>
     <row>
      <entry>-V</entry>
      <entry/>
      <entry>
       Напечатать номер версии
      </entry>
     </row>
     <row>
      <entry>--</entry>
      <entry>-- arg1 arg2</entry>
      <entry>
       Используется для разделения аргументов phpdbg и php $argv; любые $argv добавляйте после него
      </entry>
     </row>
    </tbody>
   </tgroup>
  </table>

 </preface>

 &reference.phpdbg.setup;
 &reference.phpdbg.constants;
 &reference.phpdbg.reference;

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