cvs: phpdoc /ru/appendices debugger.xml

tronic Fri Dec 21 20:54:53 2001 EDT Modified files: /phpdoc/ru/appendices debugger.xml Log: Minor translation fixups.

Index: phpdoc/ru/appendices/debugger.xml diff -u /dev/null phpdoc/ru/appendices/debugger.xml:1.4 --- /dev/null Fri Dec 21 20:54:53 2001 +++ phpdoc/ru/appendices/debugger.xml Fri Dec 21 20:54:53 2001 @@ -0,0 +1,277 @@ +<?xml version="1.0" encoding="windows-1251"?> +<!-- $Revision: 1.4 $ --> + <appendix id="debugger"> + <title>Îòëàæèâàíèå PHP 3</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. + Âñå ñîîáùåíèÿ îá îøèáêàõ îòñûëàþòñÿ ÷åðåç óñòàíîâëåííîå + TCP-ñîåäèíåíèå. Ýòà èíôîðìàöèÿ ïðåäíàçíà÷åíà äëÿ + "îòëàäî÷íîãî ñåðâåðà", êîòîðûé ìîæåò áûòü çàïóùåí â + <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> + Òåïåðü âñå ïðåäóïðåæäåíèÿ, çàìå÷àíèÿ è ò.ä. áóäóò ïðèíèìàòüñÿ + ñîêåòîì 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>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> + Äàòà â ôîðìàòå ISO 8601 + (<replaceable>ãããã</replaceable>-<replaceable>ìì</replaceable>-<replaceable>ää</replaceable>) + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><replaceable>time</replaceable></term> + <listitem> + <simpara>Âðåìÿ ñ óêàçàíèåì ìèêðîñåêóíä: + <replaceable>÷÷</replaceable>:<replaceable>ìì</replaceable>:<replaceable>ìêðñåê</replaceable> + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><replaceable>host</replaceable></term> + <listitem> + <simpara> + Èìÿ DNS èëè IP-àäðåñ ìàøèíû, ãäå ïðîèçîøëà îøèáêà âûïîëíåíèÿ + ñêðèïòà PHP 3. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><replaceable>pid</replaceable></term> + <listitem> + <simpara> + PID (èäåíòèôèêàòîð ïðîöåññà) ñêðèïòà íà ìàøèíå + <replaceable>host</replaceable>, ãäå ïðîèçîøëà îøèáêà ïðè + âûïîëíåíèè ñêðèïòà PHP 3. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><replaceable>type</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>data</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>file</replaceable>:<replaceable>line</replaceable></literal>. + Ïîñëå êàæäîé ñòðîêè <literal>function</literal> è + ñòðîêè <literal>message</literal> âñåãäà áóäåò + íàõîäèòüñÿ ñòðîêà <literal>location</literal>. + </entry> + </row> + <row> + <entry> + <literal>frames</literal></entry> <entry>Êîëè÷åñòâî "frames" + (êàäðîâ) â ïîñëåäóþùåì äàìïå ñòåêà. Íàïðèìåð, åñëè óêàçàíî ÷åòûðå + êàäðà, òî ñëåäóåò îæèäàòü èíôîðìàöèè î ÷åòûðåõ óðîâíÿõ + âûçûâàåìûõ ôóíêöèé. Åñëè ñòðîêà "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>(ëþáîé äðóãîé)</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 +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 +-->