cvs: phpdoc /it/appendices debugger.xml

cortesi Sat Apr 13 21:44:18 2002 EDT Modified files: /phpdoc/it/appendices debugger.xml Log: re-adding file with the already little translated text from removed version

Index: phpdoc/it/appendices/debugger.xml diff -u /dev/null phpdoc/it/appendices/debugger.xml:1.9 --- /dev/null Sat Apr 13 21:44:18 2002 +++ phpdoc/it/appendices/debugger.xml Sat Apr 13 21:44:18 2002 @@ -0,0 +1,280 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- EN-Revision: 1.20 Maintainer: perugini Status: working --> + <appendix id="debugger"> + <title>Debugging PHP</title> + + <sect1 id="debugger-about"> + <title>About the debugger</title> + <simpara> + PHP 3 includes support for a network-based debugger. + </simpara> + <simpara> + PHP 4 does not have an internal debugging facility. + You can use one of the external debuggers though. The + <ulink url="&url.zend.ide;">Zend IDE</ulink> includes + a debugger, and there are also some free debugger extensions + like DBG at <ulink url="&url.dbg;">&url.dbg;</ulink> or the + <ulink url="&url.apd;">Advanced PHP Debugger</ulink> (APD). + </simpara> + </sect1> + + <sect1 id="debugger-using"> + <title>Using the Debugger</title> + + <para> + Il debugger interno del PHP 3 è utile per tracciare errori non + visibili. Il debugger funziona tramite una connessione ad una porta + <acronym>TCP</acronym> che viene attivata ogni volta che viene eseguito il PHP 3. + Tutti i messaggi di errore generati da quella richiesta, vengono inviati + a questa connessione TCP. Questa modalità è pensata per i + "server di debugging" che possono essere eseguiti all'interno di un + <acronym>IDE</acronym> o di un editor programmabile (tipo Emacs). + </para> + <para> + Come configurare il debugger: + <orderedlist> + <listitem> + <simpara> + mpostare una porta TCP per il debugger nel <link + linkend="configuration.file">file di configurazione</link> (<link + linkend="ini.debugger.port">debugger.port</link>) e attivarla + (<link linkend="ini.debugger.enabled">debugger.enabled</link>). + </simpara> + </listitem> + <listitem> + <simpara> + Impostare un TCP listener sulla porta scelta (per esempio + <command>socket -l -s 1400</command> su UNIX). + </simpara> + </listitem> + <listitem> + <simpara> + Nel codice, eseguire + "debugger_on(<replaceable>host</replaceable>)", dove + <replaceable>host</replaceable> è l'indirizzo IP o il nome + dell'host su cui è in esecuzione il <acronym>TCP</acronym> listener. + </simpara> + </listitem> + </orderedlist> + Adesso, all warnings, notices etc. will show up on that listener + socket, <emphasis>even if you turned them off with + <function>error_reporting</function></emphasis>. + </para> + </sect1> + + <sect1 id="debugger-protocol"> + <title>Debugger Protocol</title> + <para> + The PHP 3 debugger protocol is line-based. Each line has a + <emphasis>type</emphasis>, and several lines compose a + <emphasis>message</emphasis>. Each message starts with a line of + the type <literal>start</literal> and terminates with a line of + the type <literal>end</literal>. PHP 3 may send lines for different + messages simultaneously. + </para> + <para> + A line has this format: + <informalexample> + <literallayout> +<replaceable>date</replaceable> <replaceable>time</replaceable> +<replaceable>host</replaceable>(<replaceable>pid</replaceable>) +<replaceable>type</replaceable>: +<replaceable>message-data</replaceable> + </literallayout> + </informalexample> + <variablelist> + <varlistentry> + <term><replaceable>date</replaceable></term> + <listitem> + <simpara> + Date in ISO 8601 format + (<replaceable>yyyy</replaceable>-<replaceable>mm</replaceable>-<replaceable>dd</replaceable>) + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><replaceable>time</replaceable></term> + <listitem> + <simpara>Time including microseconds: + <replaceable>hh</replaceable>:<replaceable>mm</replaceable>:<replaceable>uuuuuu</replaceable> + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><replaceable>host</replaceable></term> + <listitem> + <simpara> + DNS name or IP address of the host where the script error was + generated. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><replaceable>pid</replaceable></term> + <listitem> + <simpara> + PID (process id) on <replaceable>host</replaceable> of the + process with the PHP 3 script that generated this error. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><replaceable>type</replaceable></term> + <listitem> + <para> + Type of line. Tells the receiving program about what it + should treat the following data as: + <table> + <title>Debugger Line Types</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Name</entry> + <entry>Meaning</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>start</literal></entry> + <entry> + Tells the receiving program that a debugger message + starts here. The contents of + <replaceable>data</replaceable> will be the type of error + message, listed below. + </entry> + </row> + <row> + <entry><literal>message</literal></entry> + <entry>The PHP 3 error message.</entry> + </row> + <row> + <entry><literal>location</literal></entry> + <entry> + File name and line number where the error occurred. The + first <literal>location</literal> line will always + contain the top-level location. + <replaceable>data</replaceable> will contain + <literal><replaceable>file</replaceable>:<replaceable>line</replaceable></literal>. + There will always be a <literal>location</literal> line + after <literal>message</literal> and after every + <literal>function</literal>. + </entry> + </row> + <row> + <entry> + <literal>frames</literal></entry> <entry>Number of frames + in the following stack dump. If there are four frames, + expect information about four levels of called functions. + If no "frames" line is given, the depth should be assumed + to be 0 (the error occurred at top-level). + </entry> + </row> + <row> + <entry> + <literal>function</literal></entry> + <entry> + Name of function where the error occurred. Will be + repeated once for every level in the function call + stack. + </entry> + </row> + <row> + <entry><literal>end</literal></entry> + <entry> + Tells the receiving program that a debugger message ends + here. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><replaceable>data</replaceable></term> + <listitem> + <simpara>Line data.</simpara> + </listitem> + </varlistentry> + </variablelist> + + <table> + <title>Debugger Error Types</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Debugger</entry> + <entry>PHP 3 Internal</entry> + </row> + </thead> + <tbody> + <row> + <entry><errortype>warning</errortype></entry> + <entry><errortype>E_WARNING</errortype></entry> + </row> + <row> + <entry><errortype>error</errortype></entry> + <entry><errortype>E_ERROR</errortype></entry> + </row> + <row> + <entry><errortype>parse</errortype></entry> + <entry><errortype>E_PARSE</errortype></entry> + </row> + <row> + <entry><errortype>notice</errortype></entry> + <entry><errortype>E_NOTICE</errortype></entry> + </row> + <row> + <entry><errortype>core-error</errortype></entry> + <entry><errortype>E_CORE_ERROR</errortype></entry> + </row> + <row> + <entry><errortype>core-warning</errortype></entry> + <entry><errortype>E_CORE_WARNING</errortype></entry> + </row> + <row> + <entry><errortype>unknown</errortype></entry> + <entry>(any other)</entry> + </row> + </tbody> + </tgroup> + </table> + + <example> + <title>Example Debugger Message</title> + <literallayout> +1998-04-05 23:27:400966 lucifer.guardian.no(20481) start: notice +1998-04-05 23:27:400966 lucifer.guardian.no(20481) message: Uninitialized variable +1998-04-05 23:27:400966 lucifer.guardian.no(20481) location: (&null;):7 +1998-04-05 23:27:400966 lucifer.guardian.no(20481) frames: 1 +1998-04-05 23:27:400966 lucifer.guardian.no(20481) function: display +1998-04-05 23:27:400966 lucifer.guardian.no(20481) location: /home/ssb/public_html/test.php3:10 +1998-04-05 23:27:400966 lucifer.guardian.no(20481) end: notice + </literallayout> + </example> + </para> + </sect1> + + </appendix> + +<!-- 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:"../../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 +-->