cvs: phpdoc /ru/appendices debugger.xml

tronic Thu Nov 22 17:28:24 2001 EDT Added files: /phpdoc/ru/appendices debugger.xml Log: Translation done.

Index: phpdoc/ru/appendices/debugger.xml +++ phpdoc/ru/appendices/debugger.xml <?xml version="1.0" encoding="windows-1251"?> <!-- $Revision: 1.1 $ --> <appendix id="debugger"> <title>Îòëàä÷èê PHP</title> <sect1 id="debugger-about"> <title>Îá îòëàä÷èêå</title> <simpara> PHP 3 âêëþ÷àåò ïîääåðæêó ñåòåâîãî îòëàä÷èêà. </simpara> <simpara> PHP 4 ïîêà íå èìååò ïîäîáíîãî îòëàäî÷íîãî ñðåäñòâà. </simpara> </sect1> <sect1 id="debugger-using"> <title>Èñïîëüçîâàíèå îòëàä÷èêà</title> <para> Âíóòðåííèé îòëàä÷èê PHP 3 ïîëåçåí äëÿ îòñëåæèâàíèÿ òðóäíîóëîâèìûõ îøèáîê. Îòëàä÷èê ðàáîòàåò ïóòåì óñòàíîâëåíèÿ ñîåäèíåíèÿ ïî ïîðòó <acronym>TCP</acronym> êàæäûé ðàç ïðè çàïóñêå PHP 3. Âñå ñîîáùåíèÿ îá îøèáêàõ îòñûëàþòñÿ ïî óñòàíîâëåííîìó ñîåäèíåíèþ. Ýòà èíôîðìàöèÿ ïðåäíàçíà÷àåòñÿ äëÿ îòëàäî÷íîãî ñåðâåðà, êîòîðûé ìîæåò âûïîëíÿòüñÿ âíóòðè <acronym>IDE</acronym> èëè ïðîãðàììèðóåìîãî ðåäàêòîðà (òàêîãî, êàê Emacs). </para> <para> Êàê íàñòðîèòü îòëàä÷èê: <orderedlist> <listitem> <simpara> Óñòàíîâèòå çíà÷åíèå ïîðòà TCP îòëàä÷èêà â <link linkend="configuration.file">êîíôèãóðàöèîííîì ôàéëå</link> (<link linkend="ini.debugger.port">debugger.port</link>) è ðàçðåøèòå åãî èñïîëüçîâàíèå (<link linkend="ini.debugger.enabled">debugger.enabled</link>). </simpara> </listitem> <listitem> <simpara> Íàñòðîéòå íà ýòîò ïîðò TCP listener (íàïðèìåð, <command>socket -l -s 1400</command> â UNIX). </simpara> </listitem> <listitem> <simpara> Äîáàâüòå â âàø ñêðèïò "debugger_on(<replaceable>host</replaceable>)", ãäå <replaceable>host</replaceable> - àäðåñ IP èëè èìÿ õîñòà, âûïîëíÿþùåãî <acronym>TCP</acronym> listener. </simpara> </listitem> </orderedlist> Òåïåðü âñå ïðåäóïðåæäåíèÿ, çàìå÷àíèÿ è ò.ä. áóäóò âûâîäèòüñÿ ñðåäñòâàìè TCP listener, <emphasis>äàæå åñëè âû îòêëþ÷èëè ýòó âîçìîæíîñòü ñ èñïîëüçîâàíèå <function>error_reporting</function></emphasis>. </para> </sect1> <sect1 id="debugger-protocol"> <title>Ïðîòîêîë îòëàä÷èêà</title> <para> Ïðîòîêîë îòëàä÷èêà PHP 3 îñíîâàí íà ñòðîêîâûõ ñîîáùåíèÿõ. Êàæäàÿ ñòðîêà èìååò îïðåäåëåííûé <emphasis>òèï</emphasis>, à íåñêîëüêî ñòðîê ôîðìèðóþò <emphasis>ñîîáùåíèå</emphasis>. Êàæäîå ñîîáùåíèå íà÷èíàåòñÿ ñî ñòðîêè, èìåþùåé òèï <literal>start</literal> è çàêàí÷èâàåòñÿ ñòðîêîé, èìåþùåé òèï <literal>end</literal>. PHP 3 ìîæåò îäíîâðåìåííî ïîñûëàòü ñòðîêè äëÿ ðàçëè÷íûõ ñîîáùåíèé. </para> <para> Ñòðîêà èìååò òàêîé ôîðìàò: <informalexample> <literallayout> <replaceable>äàòà</replaceable> <replaceable>âðåìÿ</replaceable> <replaceable>õîñò</replaceable>(<replaceable>pid</replaceable>) <replaceable>òèï</replaceable>: <replaceable>ñîîáùåíèå</replaceable> </literallayout> </informalexample> <variablelist> <varlistentry> <term><replaceable>äàòà</replaceable></term> <listitem> <simpara> Äàòà â ôîðìàòå ISO 8601 (<replaceable>ãããã</replaceable>-<replaceable>ìì</replaceable>-<replaceable>ää</replaceable>) </simpara> </listitem> </varlistentry> <varlistentry> <term><replaceable>âðåìÿ</replaceable></term> <listitem> <simpara>Âðåìÿ (ñ òî÷íîñòüþ äî ìèëëèñåêóíä): <replaceable>÷÷</replaceable>:<replaceable>ìì</replaceable>:<replaceable>ìêñìêñ</replaceable> </simpara> </listitem> </varlistentry> <varlistentry> <term><replaceable>õîñò</replaceable></term> <listitem> <simpara> Èìÿ DNS èëè àäðåñ IP õîñòà, ãäå ïðîèçîøëà îøèáêà âî âðåìÿ âûïîëíåíèÿ ñêðèïòà. </simpara> </listitem> </varlistentry> <varlistentry> <term><replaceable>pid</replaceable></term> <listitem> <simpara> PID (èäåíòèôèêàòîð ïðîöåññà) íà <replaceable>õîñòå</replaceable>, ãäå PHP 3 ñãåíåðèðîâàë îøèáêó âî âðåìÿ âûïîëíåíèÿ ñêðèïòà. </simpara> </listitem> </varlistentry> <varlistentry> <term><replaceable>òèï</replaceable></term> <listitem> <para> Òèï ñòðîêè. Ñîîáùàåò ïðèíèìàþùåé ïðîãðàììå, êàê ñëåäóåò îáðàáàòûâàòü ïîñëåäóþùèå äàííûå: <table> <title>Òèïû ñòðîê îòëàä÷èêà</title> <tgroup cols="2"> <thead> <row> <entry>Òèï</entry> <entry>Çíà÷åíèå</entry> </row> </thead> <tbody> <row> <entry><literal>start</literal></entry> <entry> Ñîîáùàåò ïðèíèìàþùåé ïðîãðàììå î íà÷àëå ñîîáùåíèÿ îòëàä÷èêà. Ñîäåðæàíèå <replaceable>äàííûõ</replaceable> áóäåò èìåòü òèï ñîîáùåíèÿ îá îøèáêå, ïðèâåäåííîì íèæå. </entry> </row> <row> <entry><literal>message</literal></entry> <entry>Ñîîáùåíèå îá îøèáêå PHP 3.</entry> </row> <row> <entry><literal>location</literal></entry> <entry> Èìÿ ôàéëà è íîìåð ñòðîêè, ãäå ïðîèçîøëà îøèáêà. Ïåðâàÿ ñòðîêà <literal>location</literal> âñåãäà áóäåò óêàçûâàòü íà íóëåâîé óðîâåíü âëîæåííîñòè âûïîëíåíèÿ. <replaceable>data</replaceable> áóäåò ñîäåðæàòü <literal><replaceable>ôàéë</replaceable>:<replaceable>ñòðîêó</replaceable></literal>. Ïîñëå <literal>message</literal> è ïîñëå êàæäîé <literal>function</literal> âñåãäà áóäåò ñòðîêà <literal>location</literal>. </entry> </row> <row> <entry> <literal>frames</literal></entry> <entry>Êîëè÷åñòâî êàäðîâ â ïîñëåäóþùåì äàìïå ñòåêà. Åñëè ïåðå÷èñëåíî ÷åòûðå êàäðà, ñëåäóåò îæèäàòü èíôîðìàöèè î âûïîëíåííûõ ôóíêöèÿõ ñ ÷åòûðüìÿ óðîâíÿìè âëîæåííîñòè. Åñëè ñòðîêà "frames" îòñóòñòâóåò, ãëóáèíà âëîæåííîñòè äîëæíà ïðèíèìàòüñÿ çà íóëåâóþ (îøèáêà ïðîèçîøëà íà íóëåâîì óðîâíå âëîæåííîñòè âûïîëíåíèÿ). </entry> </row> <row> <entry> <literal>function</literal></entry> <entry> Èìÿ ôóíêöèè, â êîòîðîé ïðîèçîøëà îøèáêà. Áóäåò ïîâòîðÿòüñÿ òîëüêî îäíàæäû â êàæäîì óðîâíå âëîæåííîñòè â ñòåêå âûçîâà ôóíêöèè. </entry> </row> <row> <entry><literal>end</literal></entry> <entry> Ñîîáùàåò ïðèíèìàþùåé ïðîãðàììå, ÷òî ñîîáùåíèå îòëàä÷èêà çàêîí÷åíî. </entry> </row> </tbody> </tgroup> </table> </para> </listitem> </varlistentry> <varlistentry> <term><replaceable>data</replaceable></term> <listitem> <simpara>Ñòðîêîâûå äàííûå.</simpara> </listitem> </varlistentry> </variablelist> <table> <title>Òèïû îøèáîê îòëàä÷èêà</title> <tgroup cols="2"> <thead> <row> <entry> îòëàä÷èêå</entry> <entry> PHP 3</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>Ïðèìåð ñîîáùåíèÿ îòëàä÷èêà</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 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 -->