cvs: phpdoc /ru/appendices about.xml aliases.xml commandline.xml
| From: | Ivan Kovalenko | Date: | Fri, 21 Dec 2001 21:03:02 +0000 |
| Subject: | cvs: phpdoc /ru/appendices about.xml aliases.xml commandline.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969340231@lists.php.net to get a copy of this message | ||
tronic Fri Dec 21 16:03:02 2001 EDT
Added files:
/phpdoc/ru/appendices about.xml
Modified files:
/phpdoc/ru/appendices aliases.xml commandline.xml
Log:
Translation done.
Index: phpdoc/ru/appendices/aliases.xml diff -u phpdoc/ru/appendices/aliases.xml:1.2 phpdoc/ru/appendices/aliases.xml:1.3 --- phpdoc/ru/appendices/aliases.xml:1.2 Wed Dec 12 15:56:39 2001 +++ phpdoc/ru/appendices/aliases.xml Fri Dec 21 16:03:01 2001 @@ -1,18 +1,19 @@ <?xml version="1.0" encoding="windows-1251"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <appendix id="aliases"> - <title>Ñïèñîê ïñåâäîíèìîâ</title> + <title>Ñïèñîê ïñåâäîíèìîâ ôóíêöèé</title> <para> - Çäåñü ïðåäñòàâëåí ñïèñîê âñå ïñåâäîíèìîâ. Îáû÷íî èñïîëüçîâàíèå - ïñåâäîíèìîâ íå ðåêîìåíäóåòñÿ, ïîñêîëüêó îíè ìîãóò áûòü ïðèçíàíû - óñòàðåâøèìè èëè ïåðåèìåíîâàíû, ÷òî ïðèâåäåò ê íåâîçìîæíîñòè - ïîðòèðîâàíèÿ ñêðèïòà. Ýòîò ñïèñîê ïðåäíàçíà÷åí äëÿ æåëàþùèõ - ïðèâåñòè ñòàðûå ñêðèïòû â ñîîòâåòñòâèå ñ íîâûì ñèíòàêñèñîì. + Ýòî ñïèñîê ïñåâäîíèìîâ. Âñå ïñåâîäíèìû ïåðå÷èñëåíû çäåñü. Îáû÷íî + èñïîëüçîâàíèå ïñåâäîíèìîâ íå ðåêîìåíäóåòñÿ, ïîñêîëüêó îíè ìîãóò + áûòü ïðèçíàíû óñòàðåâøèìè èëè ïåðåèìåíîâàíû, ÷òî ïðèâåäåò ê + íåïîðòàáåëüíîñòè ñêðèïòà. Ýòîò ñïèñîê ïðèçâàí îêàçàòü ïîìîùü òåì, + êòî õî÷åò ïðèâåñòè ñâîè ñòàðûå ñêðèïòû â ñîîòâåòñòâèå ñ íîâûì + ñèíòàêñèñîì. </para> <para> - Îäíàêî, íåêîòîðûå ôóíêöèè èìåþò ïî äâà èìåíè, è ðàçíèöû â èõ - èñïîëüçîâàíèè íåò. (Íàïðèìåð, <function>is_int</function> è - <function>is_integer</function> îäèíàêîâû) + Îäíàêî, íåêîòîðûå ôóíêöèè ïðîñòî èìåþò äâà èìåíè, ïðè÷åì ìåæäó + íèìè íå ñóùåñòâóåò ðàçíèöû. (Íàïðèìåð, <function>is_int</function> è + <function>is_integer</function> àáñîëþòíî èäåíòè÷íû) </para> <para> Ýòîò ñïèñîê ñîîòâåòñòâóåò PHP 4.0.6. @@ -24,8 +25,8 @@ <thead> <row> <entry>Ïñåâäîíèì</entry> - <entry>Óïðàâëÿþùàÿ ôóíêöèÿ</entry> - <entry>Èñïîëüçóåìîå ðàñøèðåíèå</entry> + <entry>Ñîîòâ. ôóíêöèÿ</entry> + <entry>Èñïîëüç. ðàñøèðåíèå</entry> </row> </thead> <tbody> @@ -97,7 +98,7 @@ <row> <entry>chop</entry> <entry><function>rtrim</function></entry> - <entry>Base syntax</entry> + <entry>Áàçîâûé ñèíòàêñèñ</entry> </row> <row> <entry>close</entry> @@ -202,7 +203,7 @@ <row> <entry>die</entry> <entry><function>exit</function></entry> - <entry><link linkend="ref.misc">Ðàçíîîáðàçíûå ôóíêöèè</link></entry> + <entry><link linkend="ref.misc">Ôóíêöèè ðàçíîîáðàçíîãî íàçíà÷åíèÿ</link></entry> </row> <row> <entry>dir</entry> @@ -372,42 +373,42 @@ <row> <entry>i18n_convert</entry> <entry><function>mb_convert_encoding</function></entry> - <entry><link linkend="ref.mbstring">Ñòðîêè Multi-bytes</link></entry> + <entry><link linkend="ref.mbstring">Ìóëüòèáàéòîâûå ñòðîêè</link></entry> </row> <row> <entry>i18n_discover_encoding</entry> <entry><function>mb_detect_encoding</function></entry> - <entry><link linkend="ref.mbstring">Ñòðîêè Multi-bytes</link></entry> + <entry><link linkend="ref.mbstring">Ìóëüòèáàéòîâûå ñòðîêè</link></entry> </row> <row> <entry>i18n_http_input</entry> <entry><function>mb_http_input</function></entry> - <entry><link linkend="ref.mbstring">Ñòðîêè Multi-bytes</link></entry> + <entry><link linkend="ref.mbstring">Ìóëüòèáàéòîâûå ñòðîêè</link></entry> </row> <row> <entry>i18n_http_output</entry> <entry><function>mb_http_output</function></entry> - <entry><link linkend="ref.mbstring">Ñòðîêè Multi-bytes</link></entry> + <entry><link linkend="ref.mbstring">Ìóëüòèáàéòîâûå ñòðîêè</link></entry> </row> <row> <entry>i18n_internal_encoding</entry> <entry><function>mb_internal_encoding</function></entry> - <entry><link linkend="ref.mbstring">Ñòðîêè Multi-bytes</link></entry> + <entry><link linkend="ref.mbstring">Ìóëüòèáàéòîâûå ñòðîêè</link></entry> </row> <row> <entry>i18n_ja_jp_hantozen</entry> <entry><function>mb_convert_kana</function></entry> - <entry><link linkend="ref.mbstring">Ñòðîêè Multi-bytes</link></entry> + <entry><link linkend="ref.mbstring">Ìóëüòèáàéòîâûå ñòðîêè</link></entry> </row> <row> <entry>i18n_mime_header_decode</entry> <entry><function>mb_decode_mimeheader</function></entry> - <entry><link linkend="ref.mbstring">Ñòðîêè Multi-bytes</link></entry> + <entry><link linkend="ref.mbstring">Ìóëüòèáàéòîâûå ñòðîêè</link></entry> </row> <row> <entry>i18n_mime_header_encode</entry> <entry><function>mb_encode_mimeheader</function></entry> - <entry><link linkend="ref.mbstring">Ñòðîêè Multi-bytes</link></entry> + <entry><link linkend="ref.mbstring">Ìóëüòèáàéòîâûå ñòðîêè</link></entry> </row> <row> <entry>imap_create</entry> @@ -527,27 +528,27 @@ <row> <entry>mbstrcut</entry> <entry><function>mb_strcut</function></entry> - <entry><link linkend="ref.mbstring">Ñòðîêè Multi-bytes</link></entry> + <entry><link linkend="ref.mbstring">Ìóëüòèáàéòîâûå ñòðîêè</link></entry> </row> <row> <entry>mbstrlen</entry> <entry><function>mb_strlen</function></entry> - <entry><link linkend="ref.mbstring">Ñòðîêè Multi-bytes</link></entry> + <entry><link linkend="ref.mbstring">Ìóëüòèáàéòîâûå ñòðîêè</link></entry> </row> <row> <entry>mbstrpos</entry> <entry><function>mb_strpos</function></entry> - <entry><link linkend="ref.mbstring">Ñòðîêè Multi-bytes</link></entry> + <entry><link linkend="ref.mbstring">Ìóëüòèáàéòîâûå ñòðîêè</link></entry> </row> <row> <entry>mbstrrpos</entry> <entry><function>mb_strrpos</function></entry> - <entry><link linkend="ref.mbstring">Ñòðîêè Multi-bytes</link></entry> + <entry><link linkend="ref.mbstring">Ìóëüòèáàéòîâûå ñòðîêè</link></entry> </row> <row> <entry>mbsubstr</entry> <entry><function>mb_substr</function></entry> - <entry><link linkend="ref.mbstring">Ñòðîêè Multi-bytes</link></entry> + <entry><link linkend="ref.mbstring">Ìóëüòèáàéòîâûå ñòðîêè</link></entry> </row> <row> <entry>ming_setcubicthreshold</entry> Index: phpdoc/ru/appendices/commandline.xml diff -u phpdoc/ru/appendices/commandline.xml:1.2 phpdoc/ru/appendices/commandline.xml:1.3 --- phpdoc/ru/appendices/commandline.xml:1.2 Wed Dec 12 15:56:41 2001 +++ phpdoc/ru/appendices/commandline.xml Fri Dec 21 16:03:01 2001 @@ -1,48 +1,48 @@ <?xml version="1.0" encoding="windows-1251"?> -<!-- $Revision: 1.2 $ --> -<!-- +<!-- $Revision: 1.3 $ --> +<!-- TODO: - + The command line options not in the list, but in the -h output below: - + -f, -e, -z, -l - + It would be best to document these, and collect more info about -c and -d! --> <appendix id="commandline"> <title>Èñïîëüçîâàíèå PHP èç êîìàíäíîé ñòðîêè</title> <para> - Ïàðàìåòðû êîìàíäíîé ñòðîêè äëÿ PHP ïîëåçíû, åñëè âàì - íóæíî îòëàäèòü èëè ïðîòåñòèðîâàòü íàñòðîéêè PHP, íî - òàêæå îíè ìîãóò áûòü óäîáíû è â òîì ñëó÷àå, åñëè âû - ðåøèòå èñïîëüçîâàòü PHP â äðóãèõ öåëÿõ, íåæåëè íàïèñàíèå - ñêðèïòîâ äëÿ web. - </para> - <para> - Çàìåòüòå, ÷òî âû âñåãäà ìîæåòå íàïðàâèòü âûâîä PHP - âî âíåøíèé ôàéë ñ èñïîëüçîâàíèåì ñèìâîëà >, òàê ÷òî - <literal>php -q test.php > test.html</literal> âûâåäåò - ðåçóëüòàòû âûïîëíåíèÿ ñêðèïòà <filename>test.php</filename> - áåç HTTP-çàãîëîâêîâ â ôàéë <filename>test.html</filename> - â òîì æå êàòàëîãå. - </para> - <para> - Âû ìîæåòå èñïîëüçîâàòü ïàðàìåòðû êîìàíäíîé ñòðîêè òîëüêî - â òîì ñëó÷àå, åñëè âàø PHP ÿâëÿåòñÿ ñàìîñòîÿòåëüíûì ïðèëîæåíèåì. - Åñëè âû ñîáðàëè ìîäóëüíóþ âåðñèþ äëÿ ñåðâåðà, ïðè÷åì - åñëè íà âàøåé ìàøèíå îòñóòñòâóåò CGI, âû íå ìîæåòå - èñïîëüçîâàòü ýòè ïàðàìåòðû. Äëÿ ïîëüçîâàòåëåé Windows - îäèí ôàéë <filename>php.exe</filename> ìîæåò èñïîëüçîâàòüñÿ - êàê â êà÷åñòâå ñàìîñòîÿòåëüíîãî ïðèëîæåíèÿ, òàê è â êà÷åñòâå - ñåðâåðíîãî ìîäóëÿ. - </para> - <para> - Ýòîò ñïèñîê ïàðàìåòðîâ êîìàíäíîé ñòðîêè ñîîòâåòñòâóåò PHP 4.0.6. - Âû ìîæåòå ïîëó÷èòü èõ äåéñòâèòåëüíûé ñïèñîê ñ êðàòêèìè îäíîñòðî÷íûìè - îïèñàíèÿìè, èñïîëüçóÿ ïàðàìåòð <literal>-h</literal>. Ðåçóëüòàò - âûïîëíåíèÿ êîìàíäû <literal>php -h</literal> ìîæåò áûòü ïðèáëèçèòåëüíî òàêèì: + Èñïîëüçîâàíèå PHP èç êîìàíäíîé ñòðîêè îáû÷íî ïðèìåíÿåòñÿ + â òåõ ñëó÷àÿõ, êîãäà âàì íóæíî îòëàäèòü èëè ïðîòåñòèðîâàòü + íàñòðîéêó PHP; òàêæå îíî èñïîëüçóåòñÿ, åñëè âàì íóæíî + èñïîëüçîâàòü PHP â äðóãèõ öåëÿõ, íåæåëè ñîçäàíèå âåá-ñêðèïòîâ. + </para> + <para> + Îáðàòèòå âíèìàíèå, ÷òî âû âñåãäà ìîæåòå ïåðåíàïðàâèòü + âûâîä ðåçóëüòàòîâ âûïîëíåíèÿ ñêðèïòà âî âíåøíèé ôàéë, + èñïîëüçóÿ ñèìâîë the >, íàïðèìåð, + <literal>php -q test.php > test.html</literal> ïåðåíàïðàâèò + âûâîä ðåçóëüòàòîâ âûïîëíåíèÿ ñêðèïòà <filename>test.php</filename> + áåç HTTP-çàãîëîâêîâ â ôàéë <filename>test.html</filename>, + íàõîäÿùèéñÿ â òåêóùåì êàòàëîãå. + </para> + <para> + Âû ìîæåòå èñïîëüçîâàòü PHP èç êîìàíäíîé ñòðîêè òîëüêî â òîì ñëó÷àå, + åñëè âû îáëàäàåòå PHP â ôîðìàòå èñïîëíÿåìîãî ôàéëà. Åñëè âû + ñîáðàëè PHP â âèäå ñåðâåðíîãî ìîäóëÿ è íà âàøåé ìàøèíå + íåäîñòóïíà CGI, èñïîëüçîâàòü PHP òàêèì îáðàçîì âû íå ñìîæåòå. + Äëÿ ïîëüçîâàòåëåé Windows êàê èñïîëíÿåìûé ôàéë, òàê è + ñåðâåðíûé ìîäóëü PHP íàõîäÿòñÿ â îäíîì ôàéëå ñ èìåíåì + <filename>php.exe</filename>. + </para> + <para> + Ñïèñîê ïàðàìåòðîâ êîìàíäíîé ñòðîêè ñîîòâåòñòâóåò PHP 4.0.6. + Âû ìîæåòå ïîëó÷èòü ñïèñîê ïàðàìåòðîâ âìåñòå ñ îäíîñòðî÷íûìè + îïèñàíèÿìè ñ ïîìîùüþ ïàðàìåòðà <literal>-h</literal> option. + Ðåçóëüòàò âûïîëíåíèÿ <literal>php -h</literal> ìîæåò âûãëÿäåòü + ïðèìåðíî òàê: <screen> <![CDATA[ Usage: php [-q] [-h] [-s [-v] [-i] [-f <file>] | {<file> [args...]} @@ -63,8 +63,8 @@ </screen> </para> <para> - Íèæå ïðèâåäåí ñïèñîê íàèáîëåå çíà÷èìûõ ïàðàìåòðîâ êîìàíäíîé - ñòðîêè ñ ïîäðîáíûìè îïèñàíèÿìè. + Çäåñü ìû ïðèâîäèì ñïèñîê íàèáîëåå âàæíûõ ïàðàìåòîâ êîìàíäíîé + ñòðîêè ñ äåòàëüíûìè ïîÿñíåíèÿìè. </para> <para> <table> @@ -81,79 +81,80 @@ <entry>-q</entry> <entry> Çàïðåùàåò âûâîä HTTP-çàãîëîâêîâ. Îáû÷íî PHP âûâîäèò - HTTP-çàãîëîâêè ïî âûçîâó ïðîãðàììû (íàïðèìåð, web-ñåðâåðà) - äëÿ ïîñëåäóþùåé ïåðåäà÷è èõ áðîóçåðó.  ñëó÷àå - ñîçäàíèÿ ïðèëîæåíèÿ, âûçûâàåìîãî èç êîìàíäíîé ñòðîêè, - íåîáõîäèìîñòü â ýòèõ çàãîëîâêàõ îòñóòñòâóåò. + HTTP-çàãîëîâêè äëÿ îáðàáîòêè èõ áðàóçåðîì. Âî âðåìÿ + ñîçäàíèÿ ñêðèïòîâ äëÿ êîìàíäíîé ñòðîêè ýòè çàãîëîâêè + áåñïîëåçíû. </entry> </row> <row> <entry>-s</entry> <entry> - Âûâîäèò èñõîäíûé êîä ñêðèïòà, âûäåëåííûé öâåòîì. - Ýòîò ïàðàìåòð ðàâíîçíà÷åí èñïîëüçîâàíèþ ôóíêöèè - <function>highlight_file</function> â ñêðèïòå PHP. + Âûâîäèò èñõîäíûé êîä çàäàííîãî ôàéëà ñ ïîäñâåòêîé + ñèíòàêñèñà. Ýòî ðàâíîçíà÷íî èñïîëüçîâàíèþ ôóíêöèè + <function>highlight_file</function> â PHP-ñêðèïòå. </entry> </row> <row> <entry>-v</entry> <entry> - Ïåðåäàâàÿ PHP ýòîò ïàðàìåòð, âû ìîæåòå óçíàòü - òåêóùóþ âåðñèþ PHP, íàïðèìåð, 4.0.6. + Çàïóñòèâ PHP ñ ýòèì ïàðàìåòðîì, âû ñìîæåòå + óçíàòü òåêóùóþ âåðñèþ PHP, íàïðèìåð, 4.0.6. </entry> </row> <row> <entry>-C</entry> <entry> - Îáû÷íî PHP èçìåíÿåò ðàáî÷èé êàòàëîã íà êàòàëîã - ñ âûïîëíÿåìûìè ñêðïòàìè. Ýòî äàåò âîçìîæíîñòü, - íàïðèìåð, îòêðûòèÿ ôàéëîâ, ðàñïîëîæåííûõ â îäíîì - êàòàëîãå ñî ñêðèïòîì, ïóòåì óêàçàíèÿ òîëüêî èõ - èìåíè. Åñëè âû õîòèòå îòêëþ÷èòü ýòó âîçìîæíîñòü ñìåíû - êàòàëîãîâ, èñïîëüçóéòå ýòîò ïàðàìåòð. - this option. + Îáû÷íî PHP èçìåíÿåò òåêóùèé êàòàëîã íà êàòàëîã, + â êîòîðîì íàõîäèòñÿ âûïîëíÿåìûé ñêðèïò. Ýòî äåëàåò + âîçìîæíûì, íàïðèìåð, îòêðûòèå ôàéëîâ èç ñêðèïòà + â òîì æå êàòàëîãå, ñ óêàçàíèåì òîëüêî èìåíè ôàéëà. + Åñëè âû õîòèòå îòêëþ÷èòü ýòó âîçìîæíîñòü, èñïîëüçóéòå + óêàçàííûé ïàðàìåòð. </entry> </row> <row> <entry>-c</entry> <entry> Èñïîëüçóÿ ýòîò ïàðàìåòð, âû ìîæåòå óêàçàòü àëüòåðíàòèâíûé - ïóòü ê ôàéëó <filename>php.ini</filename> ñ òåì, ÷òîáû - PHP îáðàùàëñÿ ê êîíôèãóðàöèîííîìó ôàéëó â óêàçàííîì âàìè - êàòàëîãå âìåñòî êàòàëîãà ïî óìîë÷àíèþ. + ïóòü ê ôàéëó <filename>php.ini</filename>, ÷òîáû PHP + èñêàë êîíôèãóðàöèîííûå ôàéëû â óêàçàííîì êàòàëîãå âìåñòî + êàòàëîãà ïî óìîë÷àíèþ. </entry> </row> <row> <entry>-d</entry> <entry> - Ñ ïîìîùüþ ýòîãî ïàðàìåòðà âû ìîæåòå èçìåíÿòü - îòäåëüíûå íàñòðîéêè â ôàéëå <filename>php.ini</filename> + Ñ ïîìîùüþ ýòîãî ïàðàìåòðà âû ìîæåòå + óñòàíîâèòü îòäåëüíûå íàñòðîéêè <filename>php.ini</filename> âî âðåìÿ âûïîëíåíèÿ ñêðèïòà. </entry> </row> <row> <entry>-m</entry> <entry> - Ñ óêàçàíèåì ýòîãî ïàðàìåòðà PHP âûâîäèò èíôîðìàöèþ - î âñòðîåííûõ (è çàãðóæåííûõ) ìîäóëÿõ PHP è Zend, - èõ âåðñèè è êîðîòêîå çàìå÷àíèå î ïðèíàäëåæíîñòè - àâòîðñêèõ ïðàâ íà Zend. + Using this option, PHP prints out the built in + (and loaded) PHP and Zend modules, the PHP + and Zend version numbers, and a short Zend + copyright notice. </entry> </row> <row> <entry>-i</entry> <entry> - Ýòîò ïàðàìåòð âûçûâàåò ôóíêöèþ <function>phpinfo</function> - è âûâîäèò ðåçóëüòàò åå âûïîëíåíèÿ. Åñëè PHP íå ðàáîòàåò òàê, - êàê íóæíî, âûïîëíèòå <literal>php -i</literal> è ïîñìîòðèòå, - íå ëè â âûâåäåííîé èíôîðìàöèè ñîîáùåíèé îá îøèáêàõ. + This command line option calls + <function>phpinfo</function>, and prints + out the results. If PHP is not working well, + it is advisable to make a <literal>php -i</literal> + and see if any error messages are printed out + before or in place of the information tables. </entry> </row> <row> <entry>-h</entry> <entry> - Ñ ïîìîùüþ ýòîãî ïàðàìåòðà âû ìîæåòå ïîëó÷èòü ñïèñîê - äîñòóïíûõ ïàðàìåòðîâ ñ èõ êðàòêèìè îäíîñòðî÷íûìè îïèñàíèÿìè. + With this option, you can get information about + the actual list of command line options and some + one line descriptions about what they do. </entry> </row> </tbody> @@ -161,21 +162,20 @@ </table> </para> <para> - PHP â âèäå ñàìîñòîÿòåëüíîãî ïðèëîæåíèÿ ìîæåò èñïîëüçîâàòüñÿ - äëÿ çàïóñêà ñêðèïòîâ PHP ñîâåðøåííî íåçàâèñèìî îò web-ñåðâåðà. - Åñëè âû ðàáîòàåòå ñ ïëàòôîðìîé Unix, âû äîëæíû äîáàâèòü - ñïåöèàëüíóþ ñòðîêó â íà÷àëî ñêðèïòà è ïîìåòèòü åãî êàê èñïîëíÿåìûé, - ÷òîáû äàòü ñèñòåìå çíàòü, êàêàÿ ïðîãðàììà îòâåòñòâåííà çà - âûïîëíåíèå ñêðèïòà. Íà ïëàòôîðìå Windows, âû ìîæåòå óñòàíîâèòü - ñâÿçü ìåæäó <literal>php.exe -q</literal> è <literal>.php</literal> ôàéëàìè - ïóòåì äâîéíîãî ùåë÷êà íà íèõ, ëèáî âû ìîæåòå ñîçäàòü bat-ôàéë äëÿ - çàïóñêà ñêðèïòà ñ ïîìîùüþ PHP. Ïåðâàÿ ñòðîêà, äîáàâëÿåìàÿ - â ñêðèïò íà ïëàòôîðìàõ Unix, èãíîðèðóåòñÿ PHP íà Windows-ïëàòôîðìàõ, - òàêèì îáðàçîì, âû ìîæåòå ñîçäàâàòü êðîññïëàòôîðìåííûå ïðèëîæåíèÿ. - Ïðèìåð ïðîãðàììû PHP, âûïîëíÿåìîé èç êîìàíäíîé ñòðîêè, ïðèâåäåí íèæå. + The PHP executable can be used to run PHP scripts absolutely + independent from the web server. If you are on a Unix system, + you should add a special first line to your PHP script, and + make it executable, so the system will know, what program + should run the script. On a Windows platform you can associate + <literal>php.exe -q</literal> with the double click option of + the <literal>.php</literal> files, or you can make a batch file + to run the script through PHP. The first line added to the + script to work on Unix won't hurt on Windows, so you can write + cross platform programs this way. A simple example of writing + a command line PHP program can be found below. </para> <example> - <title>Ñêðèïò, ïðåäíàçíà÷åííûé äëÿ çàïóñêà èç êîìàíäíîé ñòðîêè (script.php)</title> + <title>Script intended to be run from command line (script.php)</title> <programlisting role="php"> <![CDATA[ #!/usr/bin/php -q @@ -184,14 +184,14 @@ if ($argc != 2 || in_array($argv[1], array('--help', '-help', '-h', '-?'))) { ?> -Ýòî ñêðèïò PHP, âûïîëíÿåìûé èç êîìàíäíîé ñòðîêè, èñïîëüçóþùèé îäèí ïàðàìåòð. +This is a command line PHP script with one option. - Èñïîëüçîâàíèå: - <?php echo $argv[0]; ?> <ïàðàìåòð> + Usage: + <?php echo $argv[0]; ?> <option> - <ïàðàìåòð> ìîæåò ïðèíèìàòü ëþáîå çíà÷åíèå. - Ñ ïàðàìåòðîì --help, -help, -h, èëè -? âû ìîæåòå - ïîëó÷èòü ñïðàâêó. + <option> can be some word you would like + to print out. With the --help, -help, -h, + or -? options, you can get this help. <?php } else { @@ -202,44 +202,42 @@ </programlisting> </example> <para> -  âûøåïðèâåäåííîì ñêðèïòå áûëà èñïîëüçîâàíà ñïåöèàëüíàÿ ïåðâàÿ ñòðîêà - ñ öåëüþ óêàçàíèÿ, ÷òî ýòîò ôàéë äîëæåí áûòü çàïóùåí ñ ïîìîùüþ PHP - áåç âûâîäà HTTP-çàãîëîâêîâ. Ñóùåñòâóþò äâå ïåðåìåííûõ, êîòîðûå - âû ìîæåòå èñïîëüçîâàòü â ïðîöåññå íàïèñàíèÿ ïðèëîæåíèé PHP, âûïîëíÿåìûõ - èç êîìàíäíîé ñòðîêè: <varname>$argc</varname> è <varname>$argv</varname>. -  ïåðâîé ñîäåðæèòñÿ êîëè÷åñòâî ïåðåäàííûõ ïðèëîæåíèþ àðãóìåíòîâ ïëþñ - îäèí (èìÿ âûïîëíÿåìîãî ñêðèïòà). Âòîðàÿ ïåðåìåííàÿ ÿâëÿåòñÿ ìàññèâîì, - ñîäåðæàùèì ñîáñòâåííî àðãóìåíòû, íà÷èíàÿ ñ èìåíè ñêðèïòà ñ íóëåâûì - èíäåêñîì (<varname>$argv[0]</varname>). - </para> - <para> -  âûøåïðèâåäåííîé ïðîãðàììå ïðîâåðÿëîñü óñëîâèå îòëè÷èÿ êîëè÷åñòâà - ïåðåäàííûõ àðãóìåíòîâ îò åäèíèöû. Òàêæå, åñëè ïåðåäàííûé àðãóìåíò - áûë ðàâåí <literal>--help</literal>, <literal>-help</literal>, - <literal>-h</literal> èëè <literal>-?</literal>, ïðîãðàììà âûäàâàëà - ñïðàâî÷íîå ñîîáùåíèå. Åñëè ïðîãðàììå ïåðåäàâàëñÿ êàêîé-ëèáî äðóãîé - àðãóìåíò, îí îòîáðàæàëñÿ íà óñòðîéñòâå âûâîäà. - </para> - <para> - Åñëè âû õîòèòå çàïóñòèòü âûøåïðèâåäåííûé ñêðèïò íà Unix, âû - äîëæíû ïîìåòèòü åãî êàê èñïîëíèìûé è âûçâàòü åãî êàê - <literal>script.php echothis</literal> èëè - <literal>script.php -h</literal>.  Windows âû ìîæåòå ñîçäàòü - bat-ôàéë äëÿ âûïîëíåíèÿ ýòîãî ñêðèïòà: + In the script above, we used the special first line to indicate, + that this file should be run by PHP and should not print out HTTP + headers. There are two variables you can use while writing command + line applications with PHP: <varname>$argc</varname> and + <varname>$argv</varname>. The first is the number of arguments plus + one (the name of the script running). The second is an array + containing the arguments, starting with the script name as number + zero (<varname>$argv[0]</varname>). + </para> + <para> + In the program above we checked if there are less or more than one + arguments. Also if the argument was <literal>--help</literal>, + <literal>-help</literal>, <literal>-h</literal> or <literal>-?</literal>, + we printed out the help message, printing the script name dynamically. + If we received some other argument we echoed that out. + </para> + <para> + If you would like to run the above script on Unix, you need to + make it executable, and simply call it as + <literal>script.php echothis</literal> or + <literal>script.php -h</literal>. On Windows, you can make a + batch file for this task: </para> <example> - <title>Bat-ôàéë äëÿ çàïóñêà ñêðèïòà PHP èç êîìàíäíîé ñòðîêè (script.bat)</title> + <title>Batch file to run a command line PHP script (script.bat)</title> <programlisting role="winbat"> @c:\php\php.exe -q script.php %1 %2 %3 %4 </programlisting> </example> <para> - Ó÷èòûâàÿ, ÷òî âû íàçâàëè âûøåïðèâåäåííóþ ïðîãðàììó êàê - <filename>script.php</filename> è èñïîëíÿåìûé ôàéë - <filename>php.exe</filename> èìååò ïîëíîå èìÿ - <filename>c:\php\php.exe</filename>, ýòîò bat-ôàéë - âûïîëíèò ñêðèïò ñ äîïîëíèòåëüíûìè ïàðàìåòðàìè: - <literal>script.bat echothis</literal> èëè + Assuming, you named the above program as + <filename>script.php</filename>, and you have your + <filename>php.exe</filename> in + <filename>c:\php\php.exe</filename> this batch file + will run it for you with your added options: + <literal>script.bat echothis</literal> or <literal>script.bat -h</literal>. </para> </appendix> Index: phpdoc/ru/appendices/about.xml +++ phpdoc/ru/appendices/about.xml <?xml version="1.0" encoding="windows-1251"?> <!-- $Revision: 1.1 $ --> <!-- TODO: add manual conventions section (eg. how to read function usage parts, what is fixed width, what is bold, what is linked add some tips about combining the versions (online- offline), and using "http://anymirror.php.net/funcname" --> <appendix id="about"> <title>Î ðóêîâîäñòâå</title> <sect1 id="about.formats"> <title>Ôîðìàòû</title> <para> Ðóêîâîäñòâî ïî PHP ïîñòàâëÿåòñÿ â íåñêîëüêèõ ôîðìàòàõ. Ýòè ôîðìàòû ìîãóò áûòü ðàçãðóïïèðîâàíû â äâå êàòåãîðèè: ôîðìàòû, äîñòóïíûå äëÿ îíëàéí-ïðîñìîòðà è ïàêåòû äëÿ ñêà÷êè. </para> <note> <para> Íåêîòîðûå èçäàòåëè ïðåäëàãàþò ïå÷àòíûå âåðñèè ýòîãî ðóêîâîäñòâà. Ìû íå ðåêîìåíäóåì èñïîëüçîâàòü èõ, ïîñêîëüêó îíè î÷åíü ñêîðî óñòàðåâàþò. </para> </note> <para> Âû ìîæåòå ïðîñìàòðèâàòü ðóêîâîäñòâî â îíëàéíå ïî àäðåñó <ulink url="&url.php;"> &url.php;</ulink> è íà ìíîãî÷èñëåííûõ ñàéòàõ-çåðêàëàõ. Âûáèðàéòå áëèæàéøèé ê âàì ñàéò-çåðêàëî. Âû ìîæåòå ïðîñìàòðèâàòü ðóêîâîäñòâî êàê â îáû÷íîì (äîñòóïíîì äëÿ ðàñïå÷àòêè) HTML-ôîðìàòå, òàê è â HTML-ôîðìàòå, êîòîðûé ïðèäàåò ðóêîâîäñòâó îáëèê âåá-ñàéòà PHP. </para> <para> Ïðåèìóùåñòâîì îíëàéí-ðóêîâîäñòâà íàä áîëüøèíñòâîì îôôëàéí-ôîðìàòîâ ÿâëÿåòñÿ èíòåãðàöèÿ ñ <link linkend="about.notes">çàìåòêàìè, îñòàâëÿåìûìè ïîëüçîâàòåëÿìè</link>. Î÷åâèäíûì ìèíóñîì ÿâëÿåòñÿ òî, ÷òî âû äîëæíû îñòàâàòüñÿ â îíëàéíå äëÿ ïðîñìîòðà îíëàéí-ôîðìàòîâ. </para> <para> Ñóùåñòâóåò íåñêîëüêî îôôëàéí-ôîðìàòîâ ðóêîâîäñòâà; ïðèåìëåìîñòü äëÿ âàñ îäíîãî èç òàêèõ ôîðìàòîâ çàâèñèò îò èñïîëüçóåìîé âàìè îïåðàöèîííîé ñèñòåìû è âàøåãî ñîáñòâåííîãî ïðåäïî÷òåíèÿ. ×òîáû ïîëó÷èòü áîëåå ïîäðîáíóþ èíôîðìàöèþ î òîì, êàê ðóêîâîäñòâî ãåíåðèðóåòñÿ â òàêîì êîëè÷åñòâå ôîðìàòîâ, ïðî÷èòàéòå ãëàâó ïðèëîæåíèÿ <link linkend="about.generate">'Êàê ìû ãåíåðèðóåì ôîðìàòû'</link>. </para> <para> Íàèáîëåå êðîññ-ïëàòôîðìåííûìè ôîðìàòàìè ðóêîâîäñòâà ÿâëÿþòñÿ HTML-âåðñèè è òåêñòîâûå âåðñèè. Ðóêîâîäñòâî â HTML-ôîðìàòå ïîñòàâëÿåòñÿ êàê â âèäå îäíîãî HTML-ôàéëà, òàê è â âèäå ïàêåòà ôàéëîâ, ñîîòâåòñòâóþùèõ êàæäîé ãëàâå (íåñêîëüêî òûñÿ÷ ôàéëîâ). Ðóêîâîäñòâî â HTML- è òåêñòîâîì ôîðìàòàõ ïîñòàâëÿåòñÿ â ñæàòûõ tar ôàéëàõ (ñ èñïîëüçîâàíèåì êàê gzip, òàê è bzip2) è ZIP-àðõèâàõ. </para> <para> Äðóãèì ïîïóëÿðíûì êðîññ-ïëàòôîðìåííûõ ôîðìàòîì, è ôîðìàòîì, íàèáîëåå ïîäõîäÿùèì äëÿ ðàñïå÷àòêè, ÿâëÿåòñÿ PFD (òàêæå èçâåñòíûé êàê Adobe Acrobat). Íî ïåðåä òåì êàê âû ñêà÷àåòå ðóêîâîäñòâî â ýòîì ôîðìàòå è íàæìåòå êíîïêó 'Ïå÷àòü', èìåéòå â âèäó, ÷òî ðóêîâîäñòâî ñîñòàâëÿþò îêîëî 2000 ñòðàíèö, êîòîðûå ïîñòîÿííî îáíîâëÿþòñÿ. </para> <note> <para> Åñëè ó âàñ åùå íåò ïðîãðàììû, ñ ïîìîùüþ êîòîðîé âû ñìîãëè áû ïðîñìîòðåòü ôàéëû â ôîðìàòå PDF, âàì íóæíî áóäåò ñêà÷àòü <ulink url="&url.adobe.acrobat;">Adobe Acrobat Reader</ulink>. </para> </note> <para> Äëÿ âëàäåëüöåâ Palm-ñîâìåñòèìûõ êîìïüþòåðîâ áóäóò èäåàëüíû ôîðìàòû 'Palm document' è iSilo. Âû ìîæåòå ïðèíåñòè ñâîé Palmtop ñ ñîáîé íà ñâîþ åæåäíåäíåâíóþ âñòðå÷ó è èñïîëüçîâàòü ïðîãðàììó ïðîñìîòðà <ulink url="&url.palm.doc;">DOC</ulink> èëè <ulink url="&url.palm.isilo;">iSilo</ulink>, ÷òîáû 'ïðè÷åñàòü' ñâîè çíàíèÿ â îáëàñòè PHP èëè ïðîñòî èñïîëüçîâàòü åãî â êà÷åñòâå ñïðàâî÷íèêà. </para> <para> Äëÿ ïëàòôîðì Windows äîñòóïíà âåðñèÿ Windows HTML Help ðóêîâîäñòâà, èñïîëüçóþùàÿ ôîðìàò HTML äëÿ èñïîëüçîâàíèÿ ñ ïðèëîæåíèåì Windows HTML Help. Ýòà âåðñèÿ îáåñïå÷èâàåò ïîèñê ïî âñåìó îáúåìó òåêñòà, ïîëíûé èíäåêñ è ñèñòåìó çàêëàäîê. Ýòà âåðñèÿ äîêóìåíòàöèè èíòåãðèðóåòñÿ ñî ìíîãèìè ïîïóëÿðíûìè ñðåäàìè ðàçðàáîòêè PHP äëÿ Windows äëÿ îáåñïå÷åíèÿ ëåãêîãî äîñòóïà. </para> <note> <para> Ïðîåêò Visual Basic äëÿ Linux íàõîäèòñÿ â ñòàäèè ïëàíèðîâàíèÿ è áóäåò âêëþ÷àòü â ñåáÿ ðàçðàáîò÷èê è ñðåäñòâî ïðîñìîòðà CHM-ôàéëîâ äëÿ Linux. Îáðàòèòåñü íà èõ <ulink url="&url.vb4linux;">ñòðàíèöó íà SourceForge.net</ulink>, åñëè âû çàèíòåðåñîâàíû â òåêóùåì ñîñòîÿíèè ïðîåêòà. </para> </note> </sect1> <sect1 id="about.notes"> <title>Î çàìåòêàõ ïîëüçîâàòåëåé</title> <para> Çàìåòêè, îñòàâëÿåìûå ïîëüçîâàòåëÿìè, èãðàþò âàæíóþ ðîëü â ðàçðàáîòêå ýòîãî ðóêîâîäñòâà. Ïîçâîëÿÿ ÷èòàòåëÿì ðóêîâîäñòâà äåëèòüñÿ ïðèìåðàìè è ïîÿñíåíèÿìè íåïîñðåäñòâåííî ñ ïîìîùüþ èõ áðàóçåðîâ, ìû ïîëó÷àåì âîçìîæíîñòü îáúåäèíÿòü èõ ñâåäåíèÿ ñ òåêñòîì ðóêîâîäñòâà. È, ïîêà çàìåòêè íå îáúåäèíåíû, îíè ìîãóò áûòü ïðîñìîòðåíû êàê ñ ïîìîùüþ ôîðìû äëÿ ïîäà÷è çàìåòêè, òàê è â íåêîòîðûõ îôôëàéí-ôîðìàòàõ. </para> <note> <para> Çàìåòêè, îñòàâëÿåìûå ïîëüçîâàòåëÿìè, íå ìîäåðèðóþòñÿ ïåðåä òåì, êàê ïîÿâèòüñÿ â îíëàéíå, òàêèì îáðàçîì, êà÷åñòâî íàïèñàíèÿ ïðèìåðîâ è äàæå âåðíîñòü ÷üåãî-ëèáî ìíåíèÿ íå ìîãóò áûòü ãàðàíòèðîâàíû. (Êàê íå ìîæåò ãàðàíòèðîâàòüñÿ êà÷åñòâî è òî÷íîñòü ñàìîãî òåêñòà ðóêîâîäñòâà.) </para> </note> </sect1> <sect1 id="about.more"> <title>Êàê ïîëó÷èòü áîëåå ïîäðîáíûå ñâåäåíèÿ î PHP</title> <para> Ýòî ðóêîâîäñòâî íå ñòàâèò ñâîåé öåëüþ èíñòðóêòàæ ïî îáùåé òåîðèè ïðîãðàììèðîâàíèÿ. Åñëè âû ïðèñòóïàåòå ê ïðîãðàììèðîâàíèþ â ïåðâûé ðàç èëè ÿâëÿåòåñü ïðîñòî íà÷èíàþùèì, ïðîãðàììèðîâàíèå íà PHP ìîæåò ïîêàçàòüñÿ âàì ñëîæíûì, åñëè âû èñïîëüçóåòå ýòî ðóêîâîäñòâî. Ìîæåò áûòü, âàì íóæíî áóäåò íàéòè òåêñòû, â áîëüøåé ñòåïåíè îðèåíòèðîâàííûå íà íà÷èíàþùèõ. Ïî àäðåñó <ulink url="&url.php.books;">&url.php.books;</ulink> âû ñìîæåòå íàéòè ñïèñîê êíèã, ïîñâÿùåííûõ PHP. </para> <para> Ñóùåñòâóåò ìíîæåñòâî àêòèâíûõ ñïèñêîâ ðàññûëêè, ñëóæàùèõ äëÿ îáñóæäåíèÿ âñåõ àñïåêòîâ ïðîãðàììèðîâàíèÿ íà PHP. Åñëè âû çàñòðÿíåòå íà êàêîé-ëèáî ïðîáëåìå è íå ñìîæåòå íàéòè åå ðåøåíèÿ, âû âñåãäà ñìîæåòå ïîëó÷èòü ïîìîùü îò êîãî-ëèáî èç ïîäïèñ÷èêîâ ýòèõ ñïèñêîâ ðàññûëêè. Ïåðå÷åíü ñïèñêîâ ðàññûëêè âû ìîæåòå íàéòè ïî àäðåñó <ulink url="&url.php.support;">&url.php.support;</ulink>, òàêæå êàê è ññûëêè íà àðõèâû ñïèñîê ðàññûëêè è äðóãèå ðåñóðñû îíëàéí-ïîääåðæêè. Êðîìå òîãî, ïî àäðåñó <ulink url="&url.php.links;">&url.php.links;</ulink> íàõîäèòñÿ ñïèñîê âåá-ñàéòîâ, ïîñâÿùåííûõ ñòàòüÿì íà òåìó PHP, ôîðóìû è ñîáðàíèé êîäà. </para> </sect1> <sect1 id="about.howtohelp"> <title>Êàê ïîìî÷ü â óëó÷øåíèè äîêóìåíòàöèè</title> <para> Ñóùåñòâóþò äâà ñïîñîáà äëÿ òîãî, ÷òîáû âû ìîãëè ïîìî÷ü â óëó÷øåíèè ýòîé äîêóìåíòàöèè. </para> <para> Åñëè âû îáíàðóæèòå îøèáêè â ýòîì ðóêîâîäñòâå íà ëþáîì ÿçûêå, ïîæàëóéñòà, ñîîáùèòå î íèõ, èñïîëüçóÿ ñèñòåìó ñîîáùåíèÿ îá îøèáêàõ ïî àäðåñó <ulink url="&url.php.bugs;">&url.php.bugs;</ulink>. Êëàññèôèöèðóéòå îøèáêó êàê "Documentation Problem (Ïðîáëåìà ñ Äîêóìåíòàöèåé)". Òàêæå âû ìîæåòå îòïðàâëÿòü çàìå÷àíèÿ, îòíîñÿùèåñÿ ê ôîðìàòàì ïðåäñòàâëåíèÿ ðóêîâîäñòâà. </para> <note> <para> Ïîæàëóéñòà, íå èñïîëüçóéòå ñèñòåìó ñîîáùåíèÿ îá îøèáêàõ, åñëè âàì íóæíà ïîìîùü. Èñïîëüçóéòå ñïèñêè ðàññûëêè èëè ñàéòû îáùåñòâ, óïîìÿíóòûå âûøå. </para> </note> <para> Îñòàâëÿÿ çàìåòêè, âû ìîæåòå îáåñïå÷èòü äðóãèõ ÷èòàòåëåé ïðèìåðàìè è ïîÿñíåíèÿìè. Íî íå èñïîëüçóéòå ñèñòåìó àííîòàöèè äëÿ ñîîáùåíèé îá îøèáêàõ. Âû ìîæåòå ïîëó÷èòü áîëüøå ïîäðîáíîé èíôîðìàöèè î çàìåòêàõ, îçíàêîìèâøèñü ñ ãëàâîé <link linkend="about.notes">'Î ïîëüçîâàòåëüñêèõ çàìåòêàõ'</link> ýòîãî ïðèëîæåíèÿ. </para> </sect1> <sect1 id="about.generate"> <title>Êàê ìû ãåíåðèðóåì ôîðìàòû</title> <para> Ýòî ðóêîâîäñòâî íàïèñàíî íà <acronym>XML</acronym> ñ ïîìîùüþ <ulink url="&url.docbook.xml;">DocBook XML DTD</ulink>, ñ èñïîëüçîâàíèåì <ulink url="&url.dsssl;"><acronym>DSSSL</acronym></ulink> (Document Style and Semantics Specification Language) äëÿ ôîðìàòèðîâàíèÿ, è (ýêñïåðèìåíòàëüíî) <ulink url="&url.xslt;"><acronym>XSLT</acronym> </ulink> (Extensible Stylesheet Language Transformations) äëÿ îáñëóæèâàíèÿ è ôîðìàòèðîâàíèÿ. </para> <para> Èñïîëüçîâàíèå <acronym>XML</acronym> â êà÷åñòâå èñõîäíîãî ôîðìàòà ïðåäîñòàâëÿåò íàì âîçìîæíîñòü ãåíåðèðîâàòü ìíîæåñòâî ôîðìàòîâ èç îäíîãî èñõîäíîãî êîäà. Óòèëèòû, èñïîëüçóåìûå äëÿ ôîðìàòèðîâàíèÿ <acronym>HTML-</acronym> è <acronym>TeX-</acronym>âåðñèé: <ulink url="&url.jade;">Jade</ulink>, àâòîð - <ulink url="&url.jclark;">James Clark</ulink> è <ulink url="&url.dbstyle;">The Modular DocBook Stylesheets</ulink> àâòîð - <ulink url="&url.nwalsh;">Norman Walsh</ulink>. Äëÿ ãåíåðàöèè ðóêîâîäñòâà â ôîðìàòå Windows HTML Help ìû èñïîëüçóåì <ulink url="&url.winhelp;">Microsoft HTML Help Workshop</ulink>, è, êîíå÷íî, ñàì PHP äëÿ äîïîëíèòåëüíîãî ïðåîáðàçîâàíèÿ è ôîðìàòèðîâàíèÿ. </para> <para> Âû ìîæåòå ñêà÷àòü ðóêîâîäñòâî íà ðàçëè÷íûõ ÿçûêàõ è â ðàçëè÷íûõ ôîðìàòàõ, â òîì ÷èñëå òåêñòîâîì, <acronym>HTML</acronym>, <acronym>PDF</acronym>, PalmPilot DOC, PalmPilot iSilo è Windows HTML Help ïî àäðåñó <ulink url="&url.php.docs;">&url.php.docs;</ulink>. Ðóêîâîäñòâî àâòîìàòè÷åñêè îáíîâëÿåòñÿ ïî ìåðå îáíîâëåíèÿ èñõîäíîãî òåêñòà. </para> <para> Âû ìîæåòå ïîëó÷èòü äîïîëíèòåëüíóþ èíôîðìàöèþ ïî ñêà÷èâàíèþ èñõîäíîãî <acronym>XML</acronym>-êîäà ýòîé äîêóìåíòàöèè ïî àäðåñó <ulink url="&url.php.cvs;">&url.php.cvs;</ulink>. Äîêóìåíòàöèÿ ñîäåðæèòñÿ â ìîäóëå <literal>phpdoc</literal>. </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 -->
Index: phpdoc/ru/appendices/aliases.xml diff -u phpdoc/ru/appendices/aliases.xml:1.2 phpdoc/ru/appendices/aliases.xml:1.3 --- phpdoc/ru/appendices/aliases.xml:1.2 Wed Dec 12 15:56:39 2001 +++ phpdoc/ru/appendices/aliases.xml Fri Dec 21 16:03:01 2001 @@ -1,18 +1,19 @@ <?xml version="1.0" encoding="windows-1251"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <appendix id="aliases"> - <title>Ñïèñîê ïñåâäîíèìîâ</title> + <title>Ñïèñîê ïñåâäîíèìîâ ôóíêöèé</title> <para> - Çäåñü ïðåäñòàâëåí ñïèñîê âñå ïñåâäîíèìîâ. Îáû÷íî èñïîëüçîâàíèå - ïñåâäîíèìîâ íå ðåêîìåíäóåòñÿ, ïîñêîëüêó îíè ìîãóò áûòü ïðèçíàíû - óñòàðåâøèìè èëè ïåðåèìåíîâàíû, ÷òî ïðèâåäåò ê íåâîçìîæíîñòè - ïîðòèðîâàíèÿ ñêðèïòà. Ýòîò ñïèñîê ïðåäíàçíà÷åí äëÿ æåëàþùèõ - ïðèâåñòè ñòàðûå ñêðèïòû â ñîîòâåòñòâèå ñ íîâûì ñèíòàêñèñîì. + Ýòî ñïèñîê ïñåâäîíèìîâ. Âñå ïñåâîäíèìû ïåðå÷èñëåíû çäåñü. Îáû÷íî + èñïîëüçîâàíèå ïñåâäîíèìîâ íå ðåêîìåíäóåòñÿ, ïîñêîëüêó îíè ìîãóò + áûòü ïðèçíàíû óñòàðåâøèìè èëè ïåðåèìåíîâàíû, ÷òî ïðèâåäåò ê + íåïîðòàáåëüíîñòè ñêðèïòà. Ýòîò ñïèñîê ïðèçâàí îêàçàòü ïîìîùü òåì, + êòî õî÷åò ïðèâåñòè ñâîè ñòàðûå ñêðèïòû â ñîîòâåòñòâèå ñ íîâûì + ñèíòàêñèñîì. </para> <para> - Îäíàêî, íåêîòîðûå ôóíêöèè èìåþò ïî äâà èìåíè, è ðàçíèöû â èõ - èñïîëüçîâàíèè íåò. (Íàïðèìåð, <function>is_int</function> è - <function>is_integer</function> îäèíàêîâû) + Îäíàêî, íåêîòîðûå ôóíêöèè ïðîñòî èìåþò äâà èìåíè, ïðè÷åì ìåæäó + íèìè íå ñóùåñòâóåò ðàçíèöû. (Íàïðèìåð, <function>is_int</function> è + <function>is_integer</function> àáñîëþòíî èäåíòè÷íû) </para> <para> Ýòîò ñïèñîê ñîîòâåòñòâóåò PHP 4.0.6. @@ -24,8 +25,8 @@ <thead> <row> <entry>Ïñåâäîíèì</entry> - <entry>Óïðàâëÿþùàÿ ôóíêöèÿ</entry> - <entry>Èñïîëüçóåìîå ðàñøèðåíèå</entry> + <entry>Ñîîòâ. ôóíêöèÿ</entry> + <entry>Èñïîëüç. ðàñøèðåíèå</entry> </row> </thead> <tbody> @@ -97,7 +98,7 @@ <row> <entry>chop</entry> <entry><function>rtrim</function></entry> - <entry>Base syntax</entry> + <entry>Áàçîâûé ñèíòàêñèñ</entry> </row> <row> <entry>close</entry> @@ -202,7 +203,7 @@ <row> <entry>die</entry> <entry><function>exit</function></entry> - <entry><link linkend="ref.misc">Ðàçíîîáðàçíûå ôóíêöèè</link></entry> + <entry><link linkend="ref.misc">Ôóíêöèè ðàçíîîáðàçíîãî íàçíà÷åíèÿ</link></entry> </row> <row> <entry>dir</entry> @@ -372,42 +373,42 @@ <row> <entry>i18n_convert</entry> <entry><function>mb_convert_encoding</function></entry> - <entry><link linkend="ref.mbstring">Ñòðîêè Multi-bytes</link></entry> + <entry><link linkend="ref.mbstring">Ìóëüòèáàéòîâûå ñòðîêè</link></entry> </row> <row> <entry>i18n_discover_encoding</entry> <entry><function>mb_detect_encoding</function></entry> - <entry><link linkend="ref.mbstring">Ñòðîêè Multi-bytes</link></entry> + <entry><link linkend="ref.mbstring">Ìóëüòèáàéòîâûå ñòðîêè</link></entry> </row> <row> <entry>i18n_http_input</entry> <entry><function>mb_http_input</function></entry> - <entry><link linkend="ref.mbstring">Ñòðîêè Multi-bytes</link></entry> + <entry><link linkend="ref.mbstring">Ìóëüòèáàéòîâûå ñòðîêè</link></entry> </row> <row> <entry>i18n_http_output</entry> <entry><function>mb_http_output</function></entry> - <entry><link linkend="ref.mbstring">Ñòðîêè Multi-bytes</link></entry> + <entry><link linkend="ref.mbstring">Ìóëüòèáàéòîâûå ñòðîêè</link></entry> </row> <row> <entry>i18n_internal_encoding</entry> <entry><function>mb_internal_encoding</function></entry> - <entry><link linkend="ref.mbstring">Ñòðîêè Multi-bytes</link></entry> + <entry><link linkend="ref.mbstring">Ìóëüòèáàéòîâûå ñòðîêè</link></entry> </row> <row> <entry>i18n_ja_jp_hantozen</entry> <entry><function>mb_convert_kana</function></entry> - <entry><link linkend="ref.mbstring">Ñòðîêè Multi-bytes</link></entry> + <entry><link linkend="ref.mbstring">Ìóëüòèáàéòîâûå ñòðîêè</link></entry> </row> <row> <entry>i18n_mime_header_decode</entry> <entry><function>mb_decode_mimeheader</function></entry> - <entry><link linkend="ref.mbstring">Ñòðîêè Multi-bytes</link></entry> + <entry><link linkend="ref.mbstring">Ìóëüòèáàéòîâûå ñòðîêè</link></entry> </row> <row> <entry>i18n_mime_header_encode</entry> <entry><function>mb_encode_mimeheader</function></entry> - <entry><link linkend="ref.mbstring">Ñòðîêè Multi-bytes</link></entry> + <entry><link linkend="ref.mbstring">Ìóëüòèáàéòîâûå ñòðîêè</link></entry> </row> <row> <entry>imap_create</entry> @@ -527,27 +528,27 @@ <row> <entry>mbstrcut</entry> <entry><function>mb_strcut</function></entry> - <entry><link linkend="ref.mbstring">Ñòðîêè Multi-bytes</link></entry> + <entry><link linkend="ref.mbstring">Ìóëüòèáàéòîâûå ñòðîêè</link></entry> </row> <row> <entry>mbstrlen</entry> <entry><function>mb_strlen</function></entry> - <entry><link linkend="ref.mbstring">Ñòðîêè Multi-bytes</link></entry> + <entry><link linkend="ref.mbstring">Ìóëüòèáàéòîâûå ñòðîêè</link></entry> </row> <row> <entry>mbstrpos</entry> <entry><function>mb_strpos</function></entry> - <entry><link linkend="ref.mbstring">Ñòðîêè Multi-bytes</link></entry> + <entry><link linkend="ref.mbstring">Ìóëüòèáàéòîâûå ñòðîêè</link></entry> </row> <row> <entry>mbstrrpos</entry> <entry><function>mb_strrpos</function></entry> - <entry><link linkend="ref.mbstring">Ñòðîêè Multi-bytes</link></entry> + <entry><link linkend="ref.mbstring">Ìóëüòèáàéòîâûå ñòðîêè</link></entry> </row> <row> <entry>mbsubstr</entry> <entry><function>mb_substr</function></entry> - <entry><link linkend="ref.mbstring">Ñòðîêè Multi-bytes</link></entry> + <entry><link linkend="ref.mbstring">Ìóëüòèáàéòîâûå ñòðîêè</link></entry> </row> <row> <entry>ming_setcubicthreshold</entry> Index: phpdoc/ru/appendices/commandline.xml diff -u phpdoc/ru/appendices/commandline.xml:1.2 phpdoc/ru/appendices/commandline.xml:1.3 --- phpdoc/ru/appendices/commandline.xml:1.2 Wed Dec 12 15:56:41 2001 +++ phpdoc/ru/appendices/commandline.xml Fri Dec 21 16:03:01 2001 @@ -1,48 +1,48 @@ <?xml version="1.0" encoding="windows-1251"?> -<!-- $Revision: 1.2 $ --> -<!-- +<!-- $Revision: 1.3 $ --> +<!-- TODO: - + The command line options not in the list, but in the -h output below: - + -f, -e, -z, -l - + It would be best to document these, and collect more info about -c and -d! --> <appendix id="commandline"> <title>Èñïîëüçîâàíèå PHP èç êîìàíäíîé ñòðîêè</title> <para> - Ïàðàìåòðû êîìàíäíîé ñòðîêè äëÿ PHP ïîëåçíû, åñëè âàì - íóæíî îòëàäèòü èëè ïðîòåñòèðîâàòü íàñòðîéêè PHP, íî - òàêæå îíè ìîãóò áûòü óäîáíû è â òîì ñëó÷àå, åñëè âû - ðåøèòå èñïîëüçîâàòü PHP â äðóãèõ öåëÿõ, íåæåëè íàïèñàíèå - ñêðèïòîâ äëÿ web. - </para> - <para> - Çàìåòüòå, ÷òî âû âñåãäà ìîæåòå íàïðàâèòü âûâîä PHP - âî âíåøíèé ôàéë ñ èñïîëüçîâàíèåì ñèìâîëà >, òàê ÷òî - <literal>php -q test.php > test.html</literal> âûâåäåò - ðåçóëüòàòû âûïîëíåíèÿ ñêðèïòà <filename>test.php</filename> - áåç HTTP-çàãîëîâêîâ â ôàéë <filename>test.html</filename> - â òîì æå êàòàëîãå. - </para> - <para> - Âû ìîæåòå èñïîëüçîâàòü ïàðàìåòðû êîìàíäíîé ñòðîêè òîëüêî - â òîì ñëó÷àå, åñëè âàø PHP ÿâëÿåòñÿ ñàìîñòîÿòåëüíûì ïðèëîæåíèåì. - Åñëè âû ñîáðàëè ìîäóëüíóþ âåðñèþ äëÿ ñåðâåðà, ïðè÷åì - åñëè íà âàøåé ìàøèíå îòñóòñòâóåò CGI, âû íå ìîæåòå - èñïîëüçîâàòü ýòè ïàðàìåòðû. Äëÿ ïîëüçîâàòåëåé Windows - îäèí ôàéë <filename>php.exe</filename> ìîæåò èñïîëüçîâàòüñÿ - êàê â êà÷åñòâå ñàìîñòîÿòåëüíîãî ïðèëîæåíèÿ, òàê è â êà÷åñòâå - ñåðâåðíîãî ìîäóëÿ. - </para> - <para> - Ýòîò ñïèñîê ïàðàìåòðîâ êîìàíäíîé ñòðîêè ñîîòâåòñòâóåò PHP 4.0.6. - Âû ìîæåòå ïîëó÷èòü èõ äåéñòâèòåëüíûé ñïèñîê ñ êðàòêèìè îäíîñòðî÷íûìè - îïèñàíèÿìè, èñïîëüçóÿ ïàðàìåòð <literal>-h</literal>. Ðåçóëüòàò - âûïîëíåíèÿ êîìàíäû <literal>php -h</literal> ìîæåò áûòü ïðèáëèçèòåëüíî òàêèì: + Èñïîëüçîâàíèå PHP èç êîìàíäíîé ñòðîêè îáû÷íî ïðèìåíÿåòñÿ + â òåõ ñëó÷àÿõ, êîãäà âàì íóæíî îòëàäèòü èëè ïðîòåñòèðîâàòü + íàñòðîéêó PHP; òàêæå îíî èñïîëüçóåòñÿ, åñëè âàì íóæíî + èñïîëüçîâàòü PHP â äðóãèõ öåëÿõ, íåæåëè ñîçäàíèå âåá-ñêðèïòîâ. + </para> + <para> + Îáðàòèòå âíèìàíèå, ÷òî âû âñåãäà ìîæåòå ïåðåíàïðàâèòü + âûâîä ðåçóëüòàòîâ âûïîëíåíèÿ ñêðèïòà âî âíåøíèé ôàéë, + èñïîëüçóÿ ñèìâîë the >, íàïðèìåð, + <literal>php -q test.php > test.html</literal> ïåðåíàïðàâèò + âûâîä ðåçóëüòàòîâ âûïîëíåíèÿ ñêðèïòà <filename>test.php</filename> + áåç HTTP-çàãîëîâêîâ â ôàéë <filename>test.html</filename>, + íàõîäÿùèéñÿ â òåêóùåì êàòàëîãå. + </para> + <para> + Âû ìîæåòå èñïîëüçîâàòü PHP èç êîìàíäíîé ñòðîêè òîëüêî â òîì ñëó÷àå, + åñëè âû îáëàäàåòå PHP â ôîðìàòå èñïîëíÿåìîãî ôàéëà. Åñëè âû + ñîáðàëè PHP â âèäå ñåðâåðíîãî ìîäóëÿ è íà âàøåé ìàøèíå + íåäîñòóïíà CGI, èñïîëüçîâàòü PHP òàêèì îáðàçîì âû íå ñìîæåòå. + Äëÿ ïîëüçîâàòåëåé Windows êàê èñïîëíÿåìûé ôàéë, òàê è + ñåðâåðíûé ìîäóëü PHP íàõîäÿòñÿ â îäíîì ôàéëå ñ èìåíåì + <filename>php.exe</filename>. + </para> + <para> + Ñïèñîê ïàðàìåòðîâ êîìàíäíîé ñòðîêè ñîîòâåòñòâóåò PHP 4.0.6. + Âû ìîæåòå ïîëó÷èòü ñïèñîê ïàðàìåòðîâ âìåñòå ñ îäíîñòðî÷íûìè + îïèñàíèÿìè ñ ïîìîùüþ ïàðàìåòðà <literal>-h</literal> option. + Ðåçóëüòàò âûïîëíåíèÿ <literal>php -h</literal> ìîæåò âûãëÿäåòü + ïðèìåðíî òàê: <screen> <![CDATA[ Usage: php [-q] [-h] [-s [-v] [-i] [-f <file>] | {<file> [args...]} @@ -63,8 +63,8 @@ </screen> </para> <para> - Íèæå ïðèâåäåí ñïèñîê íàèáîëåå çíà÷èìûõ ïàðàìåòðîâ êîìàíäíîé - ñòðîêè ñ ïîäðîáíûìè îïèñàíèÿìè. + Çäåñü ìû ïðèâîäèì ñïèñîê íàèáîëåå âàæíûõ ïàðàìåòîâ êîìàíäíîé + ñòðîêè ñ äåòàëüíûìè ïîÿñíåíèÿìè. </para> <para> <table> @@ -81,79 +81,80 @@ <entry>-q</entry> <entry> Çàïðåùàåò âûâîä HTTP-çàãîëîâêîâ. Îáû÷íî PHP âûâîäèò - HTTP-çàãîëîâêè ïî âûçîâó ïðîãðàììû (íàïðèìåð, web-ñåðâåðà) - äëÿ ïîñëåäóþùåé ïåðåäà÷è èõ áðîóçåðó.  ñëó÷àå - ñîçäàíèÿ ïðèëîæåíèÿ, âûçûâàåìîãî èç êîìàíäíîé ñòðîêè, - íåîáõîäèìîñòü â ýòèõ çàãîëîâêàõ îòñóòñòâóåò. + HTTP-çàãîëîâêè äëÿ îáðàáîòêè èõ áðàóçåðîì. Âî âðåìÿ + ñîçäàíèÿ ñêðèïòîâ äëÿ êîìàíäíîé ñòðîêè ýòè çàãîëîâêè + áåñïîëåçíû. </entry> </row> <row> <entry>-s</entry> <entry> - Âûâîäèò èñõîäíûé êîä ñêðèïòà, âûäåëåííûé öâåòîì. - Ýòîò ïàðàìåòð ðàâíîçíà÷åí èñïîëüçîâàíèþ ôóíêöèè - <function>highlight_file</function> â ñêðèïòå PHP. + Âûâîäèò èñõîäíûé êîä çàäàííîãî ôàéëà ñ ïîäñâåòêîé + ñèíòàêñèñà. Ýòî ðàâíîçíà÷íî èñïîëüçîâàíèþ ôóíêöèè + <function>highlight_file</function> â PHP-ñêðèïòå. </entry> </row> <row> <entry>-v</entry> <entry> - Ïåðåäàâàÿ PHP ýòîò ïàðàìåòð, âû ìîæåòå óçíàòü - òåêóùóþ âåðñèþ PHP, íàïðèìåð, 4.0.6. + Çàïóñòèâ PHP ñ ýòèì ïàðàìåòðîì, âû ñìîæåòå + óçíàòü òåêóùóþ âåðñèþ PHP, íàïðèìåð, 4.0.6. </entry> </row> <row> <entry>-C</entry> <entry> - Îáû÷íî PHP èçìåíÿåò ðàáî÷èé êàòàëîã íà êàòàëîã - ñ âûïîëíÿåìûìè ñêðïòàìè. Ýòî äàåò âîçìîæíîñòü, - íàïðèìåð, îòêðûòèÿ ôàéëîâ, ðàñïîëîæåííûõ â îäíîì - êàòàëîãå ñî ñêðèïòîì, ïóòåì óêàçàíèÿ òîëüêî èõ - èìåíè. Åñëè âû õîòèòå îòêëþ÷èòü ýòó âîçìîæíîñòü ñìåíû - êàòàëîãîâ, èñïîëüçóéòå ýòîò ïàðàìåòð. - this option. + Îáû÷íî PHP èçìåíÿåò òåêóùèé êàòàëîã íà êàòàëîã, + â êîòîðîì íàõîäèòñÿ âûïîëíÿåìûé ñêðèïò. Ýòî äåëàåò + âîçìîæíûì, íàïðèìåð, îòêðûòèå ôàéëîâ èç ñêðèïòà + â òîì æå êàòàëîãå, ñ óêàçàíèåì òîëüêî èìåíè ôàéëà. + Åñëè âû õîòèòå îòêëþ÷èòü ýòó âîçìîæíîñòü, èñïîëüçóéòå + óêàçàííûé ïàðàìåòð. </entry> </row> <row> <entry>-c</entry> <entry> Èñïîëüçóÿ ýòîò ïàðàìåòð, âû ìîæåòå óêàçàòü àëüòåðíàòèâíûé - ïóòü ê ôàéëó <filename>php.ini</filename> ñ òåì, ÷òîáû - PHP îáðàùàëñÿ ê êîíôèãóðàöèîííîìó ôàéëó â óêàçàííîì âàìè - êàòàëîãå âìåñòî êàòàëîãà ïî óìîë÷àíèþ. + ïóòü ê ôàéëó <filename>php.ini</filename>, ÷òîáû PHP + èñêàë êîíôèãóðàöèîííûå ôàéëû â óêàçàííîì êàòàëîãå âìåñòî + êàòàëîãà ïî óìîë÷àíèþ. </entry> </row> <row> <entry>-d</entry> <entry> - Ñ ïîìîùüþ ýòîãî ïàðàìåòðà âû ìîæåòå èçìåíÿòü - îòäåëüíûå íàñòðîéêè â ôàéëå <filename>php.ini</filename> + Ñ ïîìîùüþ ýòîãî ïàðàìåòðà âû ìîæåòå + óñòàíîâèòü îòäåëüíûå íàñòðîéêè <filename>php.ini</filename> âî âðåìÿ âûïîëíåíèÿ ñêðèïòà. </entry> </row> <row> <entry>-m</entry> <entry> - Ñ óêàçàíèåì ýòîãî ïàðàìåòðà PHP âûâîäèò èíôîðìàöèþ - î âñòðîåííûõ (è çàãðóæåííûõ) ìîäóëÿõ PHP è Zend, - èõ âåðñèè è êîðîòêîå çàìå÷àíèå î ïðèíàäëåæíîñòè - àâòîðñêèõ ïðàâ íà Zend. + Using this option, PHP prints out the built in + (and loaded) PHP and Zend modules, the PHP + and Zend version numbers, and a short Zend + copyright notice. </entry> </row> <row> <entry>-i</entry> <entry> - Ýòîò ïàðàìåòð âûçûâàåò ôóíêöèþ <function>phpinfo</function> - è âûâîäèò ðåçóëüòàò åå âûïîëíåíèÿ. Åñëè PHP íå ðàáîòàåò òàê, - êàê íóæíî, âûïîëíèòå <literal>php -i</literal> è ïîñìîòðèòå, - íå ëè â âûâåäåííîé èíôîðìàöèè ñîîáùåíèé îá îøèáêàõ. + This command line option calls + <function>phpinfo</function>, and prints + out the results. If PHP is not working well, + it is advisable to make a <literal>php -i</literal> + and see if any error messages are printed out + before or in place of the information tables. </entry> </row> <row> <entry>-h</entry> <entry> - Ñ ïîìîùüþ ýòîãî ïàðàìåòðà âû ìîæåòå ïîëó÷èòü ñïèñîê - äîñòóïíûõ ïàðàìåòðîâ ñ èõ êðàòêèìè îäíîñòðî÷íûìè îïèñàíèÿìè. + With this option, you can get information about + the actual list of command line options and some + one line descriptions about what they do. </entry> </row> </tbody> @@ -161,21 +162,20 @@ </table> </para> <para> - PHP â âèäå ñàìîñòîÿòåëüíîãî ïðèëîæåíèÿ ìîæåò èñïîëüçîâàòüñÿ - äëÿ çàïóñêà ñêðèïòîâ PHP ñîâåðøåííî íåçàâèñèìî îò web-ñåðâåðà. - Åñëè âû ðàáîòàåòå ñ ïëàòôîðìîé Unix, âû äîëæíû äîáàâèòü - ñïåöèàëüíóþ ñòðîêó â íà÷àëî ñêðèïòà è ïîìåòèòü åãî êàê èñïîëíÿåìûé, - ÷òîáû äàòü ñèñòåìå çíàòü, êàêàÿ ïðîãðàììà îòâåòñòâåííà çà - âûïîëíåíèå ñêðèïòà. Íà ïëàòôîðìå Windows, âû ìîæåòå óñòàíîâèòü - ñâÿçü ìåæäó <literal>php.exe -q</literal> è <literal>.php</literal> ôàéëàìè - ïóòåì äâîéíîãî ùåë÷êà íà íèõ, ëèáî âû ìîæåòå ñîçäàòü bat-ôàéë äëÿ - çàïóñêà ñêðèïòà ñ ïîìîùüþ PHP. Ïåðâàÿ ñòðîêà, äîáàâëÿåìàÿ - â ñêðèïò íà ïëàòôîðìàõ Unix, èãíîðèðóåòñÿ PHP íà Windows-ïëàòôîðìàõ, - òàêèì îáðàçîì, âû ìîæåòå ñîçäàâàòü êðîññïëàòôîðìåííûå ïðèëîæåíèÿ. - Ïðèìåð ïðîãðàììû PHP, âûïîëíÿåìîé èç êîìàíäíîé ñòðîêè, ïðèâåäåí íèæå. + The PHP executable can be used to run PHP scripts absolutely + independent from the web server. If you are on a Unix system, + you should add a special first line to your PHP script, and + make it executable, so the system will know, what program + should run the script. On a Windows platform you can associate + <literal>php.exe -q</literal> with the double click option of + the <literal>.php</literal> files, or you can make a batch file + to run the script through PHP. The first line added to the + script to work on Unix won't hurt on Windows, so you can write + cross platform programs this way. A simple example of writing + a command line PHP program can be found below. </para> <example> - <title>Ñêðèïò, ïðåäíàçíà÷åííûé äëÿ çàïóñêà èç êîìàíäíîé ñòðîêè (script.php)</title> + <title>Script intended to be run from command line (script.php)</title> <programlisting role="php"> <![CDATA[ #!/usr/bin/php -q @@ -184,14 +184,14 @@ if ($argc != 2 || in_array($argv[1], array('--help', '-help', '-h', '-?'))) { ?> -Ýòî ñêðèïò PHP, âûïîëíÿåìûé èç êîìàíäíîé ñòðîêè, èñïîëüçóþùèé îäèí ïàðàìåòð. +This is a command line PHP script with one option. - Èñïîëüçîâàíèå: - <?php echo $argv[0]; ?> <ïàðàìåòð> + Usage: + <?php echo $argv[0]; ?> <option> - <ïàðàìåòð> ìîæåò ïðèíèìàòü ëþáîå çíà÷åíèå. - Ñ ïàðàìåòðîì --help, -help, -h, èëè -? âû ìîæåòå - ïîëó÷èòü ñïðàâêó. + <option> can be some word you would like + to print out. With the --help, -help, -h, + or -? options, you can get this help. <?php } else { @@ -202,44 +202,42 @@ </programlisting> </example> <para> -  âûøåïðèâåäåííîì ñêðèïòå áûëà èñïîëüçîâàíà ñïåöèàëüíàÿ ïåðâàÿ ñòðîêà - ñ öåëüþ óêàçàíèÿ, ÷òî ýòîò ôàéë äîëæåí áûòü çàïóùåí ñ ïîìîùüþ PHP - áåç âûâîäà HTTP-çàãîëîâêîâ. Ñóùåñòâóþò äâå ïåðåìåííûõ, êîòîðûå - âû ìîæåòå èñïîëüçîâàòü â ïðîöåññå íàïèñàíèÿ ïðèëîæåíèé PHP, âûïîëíÿåìûõ - èç êîìàíäíîé ñòðîêè: <varname>$argc</varname> è <varname>$argv</varname>. -  ïåðâîé ñîäåðæèòñÿ êîëè÷åñòâî ïåðåäàííûõ ïðèëîæåíèþ àðãóìåíòîâ ïëþñ - îäèí (èìÿ âûïîëíÿåìîãî ñêðèïòà). Âòîðàÿ ïåðåìåííàÿ ÿâëÿåòñÿ ìàññèâîì, - ñîäåðæàùèì ñîáñòâåííî àðãóìåíòû, íà÷èíàÿ ñ èìåíè ñêðèïòà ñ íóëåâûì - èíäåêñîì (<varname>$argv[0]</varname>). - </para> - <para> -  âûøåïðèâåäåííîé ïðîãðàììå ïðîâåðÿëîñü óñëîâèå îòëè÷èÿ êîëè÷åñòâà - ïåðåäàííûõ àðãóìåíòîâ îò åäèíèöû. Òàêæå, åñëè ïåðåäàííûé àðãóìåíò - áûë ðàâåí <literal>--help</literal>, <literal>-help</literal>, - <literal>-h</literal> èëè <literal>-?</literal>, ïðîãðàììà âûäàâàëà - ñïðàâî÷íîå ñîîáùåíèå. Åñëè ïðîãðàììå ïåðåäàâàëñÿ êàêîé-ëèáî äðóãîé - àðãóìåíò, îí îòîáðàæàëñÿ íà óñòðîéñòâå âûâîäà. - </para> - <para> - Åñëè âû õîòèòå çàïóñòèòü âûøåïðèâåäåííûé ñêðèïò íà Unix, âû - äîëæíû ïîìåòèòü åãî êàê èñïîëíèìûé è âûçâàòü åãî êàê - <literal>script.php echothis</literal> èëè - <literal>script.php -h</literal>.  Windows âû ìîæåòå ñîçäàòü - bat-ôàéë äëÿ âûïîëíåíèÿ ýòîãî ñêðèïòà: + In the script above, we used the special first line to indicate, + that this file should be run by PHP and should not print out HTTP + headers. There are two variables you can use while writing command + line applications with PHP: <varname>$argc</varname> and + <varname>$argv</varname>. The first is the number of arguments plus + one (the name of the script running). The second is an array + containing the arguments, starting with the script name as number + zero (<varname>$argv[0]</varname>). + </para> + <para> + In the program above we checked if there are less or more than one + arguments. Also if the argument was <literal>--help</literal>, + <literal>-help</literal>, <literal>-h</literal> or <literal>-?</literal>, + we printed out the help message, printing the script name dynamically. + If we received some other argument we echoed that out. + </para> + <para> + If you would like to run the above script on Unix, you need to + make it executable, and simply call it as + <literal>script.php echothis</literal> or + <literal>script.php -h</literal>. On Windows, you can make a + batch file for this task: </para> <example> - <title>Bat-ôàéë äëÿ çàïóñêà ñêðèïòà PHP èç êîìàíäíîé ñòðîêè (script.bat)</title> + <title>Batch file to run a command line PHP script (script.bat)</title> <programlisting role="winbat"> @c:\php\php.exe -q script.php %1 %2 %3 %4 </programlisting> </example> <para> - Ó÷èòûâàÿ, ÷òî âû íàçâàëè âûøåïðèâåäåííóþ ïðîãðàììó êàê - <filename>script.php</filename> è èñïîëíÿåìûé ôàéë - <filename>php.exe</filename> èìååò ïîëíîå èìÿ - <filename>c:\php\php.exe</filename>, ýòîò bat-ôàéë - âûïîëíèò ñêðèïò ñ äîïîëíèòåëüíûìè ïàðàìåòðàìè: - <literal>script.bat echothis</literal> èëè + Assuming, you named the above program as + <filename>script.php</filename>, and you have your + <filename>php.exe</filename> in + <filename>c:\php\php.exe</filename> this batch file + will run it for you with your added options: + <literal>script.bat echothis</literal> or <literal>script.bat -h</literal>. </para> </appendix> Index: phpdoc/ru/appendices/about.xml +++ phpdoc/ru/appendices/about.xml <?xml version="1.0" encoding="windows-1251"?> <!-- $Revision: 1.1 $ --> <!-- TODO: add manual conventions section (eg. how to read function usage parts, what is fixed width, what is bold, what is linked add some tips about combining the versions (online- offline), and using "http://anymirror.php.net/funcname" --> <appendix id="about"> <title>Î ðóêîâîäñòâå</title> <sect1 id="about.formats"> <title>Ôîðìàòû</title> <para> Ðóêîâîäñòâî ïî PHP ïîñòàâëÿåòñÿ â íåñêîëüêèõ ôîðìàòàõ. Ýòè ôîðìàòû ìîãóò áûòü ðàçãðóïïèðîâàíû â äâå êàòåãîðèè: ôîðìàòû, äîñòóïíûå äëÿ îíëàéí-ïðîñìîòðà è ïàêåòû äëÿ ñêà÷êè. </para> <note> <para> Íåêîòîðûå èçäàòåëè ïðåäëàãàþò ïå÷àòíûå âåðñèè ýòîãî ðóêîâîäñòâà. Ìû íå ðåêîìåíäóåì èñïîëüçîâàòü èõ, ïîñêîëüêó îíè î÷åíü ñêîðî óñòàðåâàþò. </para> </note> <para> Âû ìîæåòå ïðîñìàòðèâàòü ðóêîâîäñòâî â îíëàéíå ïî àäðåñó <ulink url="&url.php;"> &url.php;</ulink> è íà ìíîãî÷èñëåííûõ ñàéòàõ-çåðêàëàõ. Âûáèðàéòå áëèæàéøèé ê âàì ñàéò-çåðêàëî. Âû ìîæåòå ïðîñìàòðèâàòü ðóêîâîäñòâî êàê â îáû÷íîì (äîñòóïíîì äëÿ ðàñïå÷àòêè) HTML-ôîðìàòå, òàê è â HTML-ôîðìàòå, êîòîðûé ïðèäàåò ðóêîâîäñòâó îáëèê âåá-ñàéòà PHP. </para> <para> Ïðåèìóùåñòâîì îíëàéí-ðóêîâîäñòâà íàä áîëüøèíñòâîì îôôëàéí-ôîðìàòîâ ÿâëÿåòñÿ èíòåãðàöèÿ ñ <link linkend="about.notes">çàìåòêàìè, îñòàâëÿåìûìè ïîëüçîâàòåëÿìè</link>. Î÷åâèäíûì ìèíóñîì ÿâëÿåòñÿ òî, ÷òî âû äîëæíû îñòàâàòüñÿ â îíëàéíå äëÿ ïðîñìîòðà îíëàéí-ôîðìàòîâ. </para> <para> Ñóùåñòâóåò íåñêîëüêî îôôëàéí-ôîðìàòîâ ðóêîâîäñòâà; ïðèåìëåìîñòü äëÿ âàñ îäíîãî èç òàêèõ ôîðìàòîâ çàâèñèò îò èñïîëüçóåìîé âàìè îïåðàöèîííîé ñèñòåìû è âàøåãî ñîáñòâåííîãî ïðåäïî÷òåíèÿ. ×òîáû ïîëó÷èòü áîëåå ïîäðîáíóþ èíôîðìàöèþ î òîì, êàê ðóêîâîäñòâî ãåíåðèðóåòñÿ â òàêîì êîëè÷åñòâå ôîðìàòîâ, ïðî÷èòàéòå ãëàâó ïðèëîæåíèÿ <link linkend="about.generate">'Êàê ìû ãåíåðèðóåì ôîðìàòû'</link>. </para> <para> Íàèáîëåå êðîññ-ïëàòôîðìåííûìè ôîðìàòàìè ðóêîâîäñòâà ÿâëÿþòñÿ HTML-âåðñèè è òåêñòîâûå âåðñèè. Ðóêîâîäñòâî â HTML-ôîðìàòå ïîñòàâëÿåòñÿ êàê â âèäå îäíîãî HTML-ôàéëà, òàê è â âèäå ïàêåòà ôàéëîâ, ñîîòâåòñòâóþùèõ êàæäîé ãëàâå (íåñêîëüêî òûñÿ÷ ôàéëîâ). Ðóêîâîäñòâî â HTML- è òåêñòîâîì ôîðìàòàõ ïîñòàâëÿåòñÿ â ñæàòûõ tar ôàéëàõ (ñ èñïîëüçîâàíèåì êàê gzip, òàê è bzip2) è ZIP-àðõèâàõ. </para> <para> Äðóãèì ïîïóëÿðíûì êðîññ-ïëàòôîðìåííûõ ôîðìàòîì, è ôîðìàòîì, íàèáîëåå ïîäõîäÿùèì äëÿ ðàñïå÷àòêè, ÿâëÿåòñÿ PFD (òàêæå èçâåñòíûé êàê Adobe Acrobat). Íî ïåðåä òåì êàê âû ñêà÷àåòå ðóêîâîäñòâî â ýòîì ôîðìàòå è íàæìåòå êíîïêó 'Ïå÷àòü', èìåéòå â âèäó, ÷òî ðóêîâîäñòâî ñîñòàâëÿþò îêîëî 2000 ñòðàíèö, êîòîðûå ïîñòîÿííî îáíîâëÿþòñÿ. </para> <note> <para> Åñëè ó âàñ åùå íåò ïðîãðàììû, ñ ïîìîùüþ êîòîðîé âû ñìîãëè áû ïðîñìîòðåòü ôàéëû â ôîðìàòå PDF, âàì íóæíî áóäåò ñêà÷àòü <ulink url="&url.adobe.acrobat;">Adobe Acrobat Reader</ulink>. </para> </note> <para> Äëÿ âëàäåëüöåâ Palm-ñîâìåñòèìûõ êîìïüþòåðîâ áóäóò èäåàëüíû ôîðìàòû 'Palm document' è iSilo. Âû ìîæåòå ïðèíåñòè ñâîé Palmtop ñ ñîáîé íà ñâîþ åæåäíåäíåâíóþ âñòðå÷ó è èñïîëüçîâàòü ïðîãðàììó ïðîñìîòðà <ulink url="&url.palm.doc;">DOC</ulink> èëè <ulink url="&url.palm.isilo;">iSilo</ulink>, ÷òîáû 'ïðè÷åñàòü' ñâîè çíàíèÿ â îáëàñòè PHP èëè ïðîñòî èñïîëüçîâàòü åãî â êà÷åñòâå ñïðàâî÷íèêà. </para> <para> Äëÿ ïëàòôîðì Windows äîñòóïíà âåðñèÿ Windows HTML Help ðóêîâîäñòâà, èñïîëüçóþùàÿ ôîðìàò HTML äëÿ èñïîëüçîâàíèÿ ñ ïðèëîæåíèåì Windows HTML Help. Ýòà âåðñèÿ îáåñïå÷èâàåò ïîèñê ïî âñåìó îáúåìó òåêñòà, ïîëíûé èíäåêñ è ñèñòåìó çàêëàäîê. Ýòà âåðñèÿ äîêóìåíòàöèè èíòåãðèðóåòñÿ ñî ìíîãèìè ïîïóëÿðíûìè ñðåäàìè ðàçðàáîòêè PHP äëÿ Windows äëÿ îáåñïå÷åíèÿ ëåãêîãî äîñòóïà. </para> <note> <para> Ïðîåêò Visual Basic äëÿ Linux íàõîäèòñÿ â ñòàäèè ïëàíèðîâàíèÿ è áóäåò âêëþ÷àòü â ñåáÿ ðàçðàáîò÷èê è ñðåäñòâî ïðîñìîòðà CHM-ôàéëîâ äëÿ Linux. Îáðàòèòåñü íà èõ <ulink url="&url.vb4linux;">ñòðàíèöó íà SourceForge.net</ulink>, åñëè âû çàèíòåðåñîâàíû â òåêóùåì ñîñòîÿíèè ïðîåêòà. </para> </note> </sect1> <sect1 id="about.notes"> <title>Î çàìåòêàõ ïîëüçîâàòåëåé</title> <para> Çàìåòêè, îñòàâëÿåìûå ïîëüçîâàòåëÿìè, èãðàþò âàæíóþ ðîëü â ðàçðàáîòêå ýòîãî ðóêîâîäñòâà. Ïîçâîëÿÿ ÷èòàòåëÿì ðóêîâîäñòâà äåëèòüñÿ ïðèìåðàìè è ïîÿñíåíèÿìè íåïîñðåäñòâåííî ñ ïîìîùüþ èõ áðàóçåðîâ, ìû ïîëó÷àåì âîçìîæíîñòü îáúåäèíÿòü èõ ñâåäåíèÿ ñ òåêñòîì ðóêîâîäñòâà. È, ïîêà çàìåòêè íå îáúåäèíåíû, îíè ìîãóò áûòü ïðîñìîòðåíû êàê ñ ïîìîùüþ ôîðìû äëÿ ïîäà÷è çàìåòêè, òàê è â íåêîòîðûõ îôôëàéí-ôîðìàòàõ. </para> <note> <para> Çàìåòêè, îñòàâëÿåìûå ïîëüçîâàòåëÿìè, íå ìîäåðèðóþòñÿ ïåðåä òåì, êàê ïîÿâèòüñÿ â îíëàéíå, òàêèì îáðàçîì, êà÷åñòâî íàïèñàíèÿ ïðèìåðîâ è äàæå âåðíîñòü ÷üåãî-ëèáî ìíåíèÿ íå ìîãóò áûòü ãàðàíòèðîâàíû. (Êàê íå ìîæåò ãàðàíòèðîâàòüñÿ êà÷åñòâî è òî÷íîñòü ñàìîãî òåêñòà ðóêîâîäñòâà.) </para> </note> </sect1> <sect1 id="about.more"> <title>Êàê ïîëó÷èòü áîëåå ïîäðîáíûå ñâåäåíèÿ î PHP</title> <para> Ýòî ðóêîâîäñòâî íå ñòàâèò ñâîåé öåëüþ èíñòðóêòàæ ïî îáùåé òåîðèè ïðîãðàììèðîâàíèÿ. Åñëè âû ïðèñòóïàåòå ê ïðîãðàììèðîâàíèþ â ïåðâûé ðàç èëè ÿâëÿåòåñü ïðîñòî íà÷èíàþùèì, ïðîãðàììèðîâàíèå íà PHP ìîæåò ïîêàçàòüñÿ âàì ñëîæíûì, åñëè âû èñïîëüçóåòå ýòî ðóêîâîäñòâî. Ìîæåò áûòü, âàì íóæíî áóäåò íàéòè òåêñòû, â áîëüøåé ñòåïåíè îðèåíòèðîâàííûå íà íà÷èíàþùèõ. Ïî àäðåñó <ulink url="&url.php.books;">&url.php.books;</ulink> âû ñìîæåòå íàéòè ñïèñîê êíèã, ïîñâÿùåííûõ PHP. </para> <para> Ñóùåñòâóåò ìíîæåñòâî àêòèâíûõ ñïèñêîâ ðàññûëêè, ñëóæàùèõ äëÿ îáñóæäåíèÿ âñåõ àñïåêòîâ ïðîãðàììèðîâàíèÿ íà PHP. Åñëè âû çàñòðÿíåòå íà êàêîé-ëèáî ïðîáëåìå è íå ñìîæåòå íàéòè åå ðåøåíèÿ, âû âñåãäà ñìîæåòå ïîëó÷èòü ïîìîùü îò êîãî-ëèáî èç ïîäïèñ÷èêîâ ýòèõ ñïèñêîâ ðàññûëêè. Ïåðå÷åíü ñïèñêîâ ðàññûëêè âû ìîæåòå íàéòè ïî àäðåñó <ulink url="&url.php.support;">&url.php.support;</ulink>, òàêæå êàê è ññûëêè íà àðõèâû ñïèñîê ðàññûëêè è äðóãèå ðåñóðñû îíëàéí-ïîääåðæêè. Êðîìå òîãî, ïî àäðåñó <ulink url="&url.php.links;">&url.php.links;</ulink> íàõîäèòñÿ ñïèñîê âåá-ñàéòîâ, ïîñâÿùåííûõ ñòàòüÿì íà òåìó PHP, ôîðóìû è ñîáðàíèé êîäà. </para> </sect1> <sect1 id="about.howtohelp"> <title>Êàê ïîìî÷ü â óëó÷øåíèè äîêóìåíòàöèè</title> <para> Ñóùåñòâóþò äâà ñïîñîáà äëÿ òîãî, ÷òîáû âû ìîãëè ïîìî÷ü â óëó÷øåíèè ýòîé äîêóìåíòàöèè. </para> <para> Åñëè âû îáíàðóæèòå îøèáêè â ýòîì ðóêîâîäñòâå íà ëþáîì ÿçûêå, ïîæàëóéñòà, ñîîáùèòå î íèõ, èñïîëüçóÿ ñèñòåìó ñîîáùåíèÿ îá îøèáêàõ ïî àäðåñó <ulink url="&url.php.bugs;">&url.php.bugs;</ulink>. Êëàññèôèöèðóéòå îøèáêó êàê "Documentation Problem (Ïðîáëåìà ñ Äîêóìåíòàöèåé)". Òàêæå âû ìîæåòå îòïðàâëÿòü çàìå÷àíèÿ, îòíîñÿùèåñÿ ê ôîðìàòàì ïðåäñòàâëåíèÿ ðóêîâîäñòâà. </para> <note> <para> Ïîæàëóéñòà, íå èñïîëüçóéòå ñèñòåìó ñîîáùåíèÿ îá îøèáêàõ, åñëè âàì íóæíà ïîìîùü. Èñïîëüçóéòå ñïèñêè ðàññûëêè èëè ñàéòû îáùåñòâ, óïîìÿíóòûå âûøå. </para> </note> <para> Îñòàâëÿÿ çàìåòêè, âû ìîæåòå îáåñïå÷èòü äðóãèõ ÷èòàòåëåé ïðèìåðàìè è ïîÿñíåíèÿìè. Íî íå èñïîëüçóéòå ñèñòåìó àííîòàöèè äëÿ ñîîáùåíèé îá îøèáêàõ. Âû ìîæåòå ïîëó÷èòü áîëüøå ïîäðîáíîé èíôîðìàöèè î çàìåòêàõ, îçíàêîìèâøèñü ñ ãëàâîé <link linkend="about.notes">'Î ïîëüçîâàòåëüñêèõ çàìåòêàõ'</link> ýòîãî ïðèëîæåíèÿ. </para> </sect1> <sect1 id="about.generate"> <title>Êàê ìû ãåíåðèðóåì ôîðìàòû</title> <para> Ýòî ðóêîâîäñòâî íàïèñàíî íà <acronym>XML</acronym> ñ ïîìîùüþ <ulink url="&url.docbook.xml;">DocBook XML DTD</ulink>, ñ èñïîëüçîâàíèåì <ulink url="&url.dsssl;"><acronym>DSSSL</acronym></ulink> (Document Style and Semantics Specification Language) äëÿ ôîðìàòèðîâàíèÿ, è (ýêñïåðèìåíòàëüíî) <ulink url="&url.xslt;"><acronym>XSLT</acronym> </ulink> (Extensible Stylesheet Language Transformations) äëÿ îáñëóæèâàíèÿ è ôîðìàòèðîâàíèÿ. </para> <para> Èñïîëüçîâàíèå <acronym>XML</acronym> â êà÷åñòâå èñõîäíîãî ôîðìàòà ïðåäîñòàâëÿåò íàì âîçìîæíîñòü ãåíåðèðîâàòü ìíîæåñòâî ôîðìàòîâ èç îäíîãî èñõîäíîãî êîäà. Óòèëèòû, èñïîëüçóåìûå äëÿ ôîðìàòèðîâàíèÿ <acronym>HTML-</acronym> è <acronym>TeX-</acronym>âåðñèé: <ulink url="&url.jade;">Jade</ulink>, àâòîð - <ulink url="&url.jclark;">James Clark</ulink> è <ulink url="&url.dbstyle;">The Modular DocBook Stylesheets</ulink> àâòîð - <ulink url="&url.nwalsh;">Norman Walsh</ulink>. Äëÿ ãåíåðàöèè ðóêîâîäñòâà â ôîðìàòå Windows HTML Help ìû èñïîëüçóåì <ulink url="&url.winhelp;">Microsoft HTML Help Workshop</ulink>, è, êîíå÷íî, ñàì PHP äëÿ äîïîëíèòåëüíîãî ïðåîáðàçîâàíèÿ è ôîðìàòèðîâàíèÿ. </para> <para> Âû ìîæåòå ñêà÷àòü ðóêîâîäñòâî íà ðàçëè÷íûõ ÿçûêàõ è â ðàçëè÷íûõ ôîðìàòàõ, â òîì ÷èñëå òåêñòîâîì, <acronym>HTML</acronym>, <acronym>PDF</acronym>, PalmPilot DOC, PalmPilot iSilo è Windows HTML Help ïî àäðåñó <ulink url="&url.php.docs;">&url.php.docs;</ulink>. Ðóêîâîäñòâî àâòîìàòè÷åñêè îáíîâëÿåòñÿ ïî ìåðå îáíîâëåíèÿ èñõîäíîãî òåêñòà. </para> <para> Âû ìîæåòå ïîëó÷èòü äîïîëíèòåëüíóþ èíôîðìàöèþ ïî ñêà÷èâàíèþ èñõîäíîãî <acronym>XML</acronym>-êîäà ýòîé äîêóìåíòàöèè ïî àäðåñó <ulink url="&url.php.cvs;">&url.php.cvs;</ulink>. Äîêóìåíòàöèÿ ñîäåðæèòñÿ â ìîäóëå <literal>phpdoc</literal>. </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 -->