cvs: phpdoc-ru /features commandline.xml remote-files.xml

From: Date: Fri, 09 Apr 2004 12:47:59 +0000
Subject: cvs: phpdoc-ru /features commandline.xml remote-files.xml
Groups: php.doc.ru 
Request: Send a blank email to doc-ru+get-297@lists.php.net to get a copy of this message
tony2001 Fri Apr 9 08:47:59 2004 EDT Added files: /phpdoc-ru/features commandline.xml remote-files.xml Log: add files translated by young

http://cvs.php.net/co.php/phpdoc-ru/features/commandline.xml?r=1.1&p=1 Index: phpdoc-ru/features/commandline.xml +++ phpdoc-ru/features/commandline.xml <?xml version="1.0" encoding="windows-1251"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.31 Maintainer: young Status: ready --> <chapter id="features.commandline"> <title>Èñïîëüçîâàíèå PHP â êîìàíäíîé ñòðîêå</title> <!-- NEW DOCUMENTATION STARTS --> <para> Íà÷èíàÿ ñ âåðñèè 4.3.0, <literal>PHP</literal> ïîääåðæèâàåò íîâûé âèä <literal>SAPI</literal> (èíòåðôåéñ ðàçðàáîòêè ñåðâåðíûõ ïðèëîæåíèé) ïîä íàçâàíèåì <literal>CLI</literal>, ÷òî îçíà÷àåò <emphasis> èíòåðôåéñ êîìàíäíîé ñòðîêè</emphasis>. Êàê âèäíî èç íàçâàíèÿ, ýòîò âèä SAPI ïðåäíàçíà÷åí äëÿ ðàçðàáîòêè êîíñîëüíûõ (èëè äàæå äåñêòîïíûõ) ïðèëîæåíèé íà <literal>PHP</literal>. Èìååòñÿ íåñêîëüêî íåñóùåñòâåííûõ ðàçëè÷èé ìåæäó <literal>CLI SAPI</literal> è äðóãèìè âèäàìè <literal>SAPI</literal>, êîòîðûå áóäóò ðàññìîòðåíû â ýòîé ãëàâå. Áóäåò ïîëåçíî çàìåòèòü, ÷òî <literal>CLI</literal> è <literal>CGI</literal> - ðàçëè÷íûå <literal>SAPI</literal>-èíòåðôåéñû, õîòÿ â èõ ïîâåäåíèè ìíîãî îáùåãî. </para> <para> Âïåðâûå â êà÷åñòâå ýêñïåðèìåíòà <literal>CLI SAPI</literal> áûë âêëþ÷åí â ðåëèç <literal>PHP 4.2.0</literal>, è ïðè çàïóñêå ñêðèïòà <literal>./configure</literal> íåîáõîäèìî áûëî ÿâíî óêàçûâàòü îïöèþ <literal>--enable-cli</literal>. Íà÷èíàÿ ñ <literal>PHP 4.3.0</literal>, <literal>CLI SAPI</literal> íå ÿâëÿåòñÿ ýêñïåðèìåíòàëüíûì, è îïöèÿ ñáîðêè <literal>--enable-cli</literal> ïðèñóòñòâóåò ïî óìîë÷àíèþ. Âû ìîæåòå îòêëþ÷èòü <literal>CLI SAPI</literal> ïðè ïîìîùè îïöèè <literal>--disable-cli</literal>. </para> <para> ×òî êàñàåòñÿ PHP 4.3.0, èìÿ, ðàñïîëîæåíèå è ñóùåñòâîâàíèå áèíàðíûõ ìîäóëåé CLI/CGI çàâèñèò îò òîãî, êàê èìåííî óñòàíîâëåí PHP. Ïî óìîë÷àíèþ ïðè âûïîëíåíèè <literal>make</literal> ñîçäàåòñÿ êàê CGI, òàê è CLI ìîäóëü, â êàòàëîãàõ <literal>sapi/cgi/php</literal> è <literal>sapi/cli/php</literal> ñîîòâåòñòâåííî, âíóòðè äèðåêòîðèè ñ èñõîäíûìè êîäàìè PHP. Cëåäóåò çàìåòèòü, ÷òî îáà ôàéëà èìåþò îäèíàêîâîå íàçâàíèå: <literal>php</literal>. ×òî ïðîèçîéäåò ïðè âûïîëíåíèè <literal>make install</literal>, çàâèñèò îò òîãî, êàêèå îïöèè âû óêàçàëè íà ñòàäèè êîíôèãóðèðîâàíèÿ.  ñëó÷àå, åñëè âû îòäàëè ïðåäïî÷òåíèå òàêîìó ìîäóëþ SAPI êàê apxs, ëèáî óêàçàëè îïöèþ <literal> --disable-cgi</literal>, ìîäóëü CLI áóäåò ñêîïèðîâàí â <literal>{PREFIX}/bin/php</literal> ïðè âûïîëíåíèè <literal>make install</literal>, â ïðîòèâíîì ñëó÷àå áóäåò ñêîïèðîâàí CGI-ìîäóëü. Íàïðèìåð, åñëè ïðè çàïóñêå ñêðèïòà <literal>./configure</literal> âû óêàçàëè îïöèþ <literal>--with--apxs</literal>, CLI-âåðñèÿ áóäåò ñêîïèðîâàíà â <literal>{PREFIX}/bin/php</literal> ïðè âûïîëíåíèè <literal>make install</literal>. Åñëè âû õîòèòå ïåðåêðûòü óñòàíîâëåííûé CGI-ìîäóëü, èñïîëüçóéòå <literal>make install-cli</literal> ïîñëå âûïîëíåíèÿ <literal>make install</literal>.  êà÷åñòâå àëüòåðíàòèâû âû ìîãëè áû óêàçàòü îïöèþ <literal>--disable-cgi </literal> ïðè âûïîëíåíèè ñêðèïòà <literal>./configure</literal>. </para> <para> <note> <para> Ïîñêîëüêó îáå îïöèè, <literal>--enable-cli</literal> è <literal> --enable-cgi</literal>, ïðèñóòñòâóþò ïî óìîë÷àíèþ, îäíîãî ïðèñóòñòâèÿ ñòðîêè <literal>--enable-cli</literal> ïðè âûïîëíåíèè ñêðèïòà <literal>./configure</literal> íåäîñòàòî÷íî äëÿ òîãî, ÷òîáû CLI-âåðñèÿ áûëà óñòàíîâëåíà â <literal> {PREFIX}/bin/php</literal> ïðè âûïîëíåíèè <literal>make install</literal>. </para> </note> </para> <para> Äèñòðèáóòèâû äëÿ Windows ìåæäó âåðñèÿìè PHP 4.2.0 è PHP 4.2.3 âêëþ÷àþò â ñåáÿ CLI-ìîäóëü êàê <filename>php-cli.exe</filename>, ðàñïîëîæåííûé â òîé æå äèðåêòîðèè, ÷òî è CGI-ìîäóëü <filename>php.exe</filename>. Íà÷èíàÿ ñ PHP 4.3.0 äèñòðèáóòèâ äëÿ Windows âëþ÷àåò â ñåáÿ CLI-ìîäóëü <filename>php.exe</filename>, ðàñïîëîæåííûé â îòäåëüíîé äèðåêòîðèè <literal>cli</literal>, ïîëíîå èìÿ - <literal>cli/php.exe</literal>. Íà÷èíàÿ ñ PHP 5, CLI-ìîäóëü ðàñïîëîæåí â îñíîâíîé äèðåêòîðèè è íàçûâàåòñÿ <filename>php.exe</filename>. CGI-ìîäóëü òàêæå âêëþ÷åí â äèñòðèáóòèâ ïîä íàçâàíèåì <filename>php-cgi.exe</filename>. </para> <para> Íà÷èíàÿ ñ PHP 5, â äèñòðèáóòèâ äëÿ Windows âõîäèò íîâûé ôàéë <filename>php-win.exe</filename>. Îí ïîëíîñòüþ ýêâèâàëåíòåí CLI, çà èñêëþ÷åíèåì òîãî, ÷òî php-win àáñîëþòíî íè÷åãî íå âûâîäèò, ÷òî ïðèâîäèò ê îòñòóòñòâèþ êîíñîëè (îêíî DOS íå ïîÿâëÿåòñÿ íà ýêðàíå). Ýòî ïîâåäåíèå ïîõîæå íà php-gtk. Ïðè ñáîðêå èç èñõîäíûõ êîäîâ âàì íåîáõîäèìî óêàçàòü îïöèþ <literal>--enable-cli-win32</literal>. </para> <para> <note> <title>Êàêîé èç âàðèàíòîâ SAPI óñòàíîâëåí?</title> <para> Âûïîëíèòå èç êîìàíäíîé ñòðîêè <literal>php -v</literal> äëÿ ïîëó÷åíèÿ èíôîðìàöèè î òîì, êàêîé èç äâóõ ìîäóëåé <literal>php</literal> óñòàíîâëåí: CGI èëè CLI. Òàêæå âû ìîæåòå èñïîëüçîâàòü äëÿ ýòîãî ôóíêöèþ <function>php_sapi_name</function> èëè êîíñòàíòó <constant> PHP_SAPI</constant>. </para> </note> </para> <para> <note> <para> Ñîîòâåòñòâóþùàÿ ñòðàíèöà ðóêîâîäñòâà Unix áûëà äîáàâëåíà â PHP 4.3.2. Âû ìîæåòå óâèäåòü åå, âûïîëíèâ â êîíñîëè <literal>man php</literal>. </para> </note> </para> <para> Îñíîâíûå îòëè÷èÿ <literal>CLI SAPI</literal> îò îñòàëüíûõ ðåàëèçàöèé <literal>SAPI</literal>: <itemizedlist> <listitem> <para>  îòëè÷èå îò <literal>CGI SAPI</literal> çàãîëîâêè íå ïèøóòñÿ â ïîòîê âûâîäà. </para> <para> Íåñìîòðÿ íà òî, ÷òî â <literal>CGI SAPI</literal> åñòü ñïîñîá ïîäàâèòü HTTP-çàãîëîâêè, â <literal>CLI SAPI</literal> íåò âîçìîæíîñòè èõ âêëþ÷èòü. </para> <para> CLI ïî óìîë÷àíèþ çàïóñêàåòñÿ â ðåæèìå ñ ïîäàâëåíèåì ñîîáùåíèé, òåì íå ìåíåå, êëþ÷è <literal>-q</literal> è <literal>--no-header</literal> ñîõðàíåíû äëÿ îáðàòíîé ñîâìåñòèìîñòè, ÷òî ïîçâîëÿåò èñïîëüçîâàòü íàïèñàííûå ðàíåå CGI-ñêðèïòû. </para> <para> Òåêóùàÿ äèðåêòîðèÿ íå èçìåíÿåòñÿ íà ðàáî÷óþ äèðåêòîðèþ ñêðèïòà. (Êëþ÷è <literal>-C</literal> è <literal>--no-chdir</literal> ñîõðàíåíû äëÿ îáðàòíîé ñîâìåñòèìîñòè) </para> <para> Ñîîáùåíèÿ îá îøèáêàõ âûäàþòñÿ â òåêñòîâîì ðåæèìå (áåç HTML-ôîðìàòèðîâàíèÿ). </para> </listitem> <listitem> <para> Íåêîòîðûå íàñòðîéêè &php.ini; ïåðåîïðåäåëåíû â <literal>CLI SAPI</literal>, ïîñêîëüêó îíè íå èìåþò îñîáîãî ñìûñëà ïðè ðàáîòå â êîìàíäíîé ñòðîêå: </para> <para> <table> <title>Ïåðåîïðåäåëÿåìûå äèðåêòèâû &php.ini;</title> <tgroup cols="3"> <thead> <row> <entry>Äèðåêòèâà</entry> <entry>Çíà÷åíèå ïî óìîë÷àíèþ â <literal>CLI SAPI</literal></entry> <entry>Êîììåíòàðèé</entry> </row> </thead> <tbody> <row> <entry><link linkend="ini.html-errors">html_errors</link></entry> <entry>&false;</entry> <entry> Áûâàåò äîñòàòî÷íî ñëîæíî ïðî÷èòàòü â êîíñîëè ñîîáùåíèå îá îøèáêå, êîãäà îíî íàïîëíåíî áåññìûñëåííûìè <literal>HTML</literal>-òåãàìè, ïîýòîìó çíà÷åíèå ïî óìîë÷àíèþ äàííîé îïöèè âñåãäà &false;. </entry> </row> <row> <entry><link linkend="ini.implicit-flush">implicit_flush</link></entry> <entry>&true;</entry> <entry> Æåëàòåëüíî, ÷òîáû ëþáîé âûâîä <function>print</function>, <function>echo</function>, à òàêæå àíàëîãè÷íûõ ôóíêöèé íåìåäëåíî îòïðàâëÿëñÿ â ñòàíäàðòíûé ïîòîê âûâîäà, à íå ïîïàäàë â áóôåð. Õîòÿ âû âñå åùå ìîæåòå èñïîëüçîâàòü <link linkend="ref.outcontrol">áóôåðèçàöèþ âûâîäà</link>, åñëè õîòèòå çàäåðæàòü âûâîä èëè ìàíèïóëèðîâàòü èì. </entry> </row> <row> <entry><link linkend="ini.max-execution-time">max_execution_time</link></entry> <entry>0 (áåç îãðàíè÷åíèé)</entry> <entry> Èç-çà íåîãðàíè÷åííûõ âîçìîæíîñòåé èñïîëüçîâàíèÿ <literal>PHP</literal> â êîìàíäíîé ñòðîêå ìàêñèìàëüíîå âðåìÿ âûïîëíåíèÿ ñêðèïòà íå îãðàíè÷åíî.  òî âðåìÿ, êàê ïðèëîæåíèÿ, íàïèñàííûå äëÿ âåá, âûïîëíÿþòñÿ äîñòàòî÷íî áûñòðî, êîíñîëüíûå ïðèëîæåíèÿ ìîãóò âûïîëíÿòüñÿ â òå÷åíèè äëèòåëüíîãî âðåìåíè. </entry> </row> <row> <entry><link linkend="ini.register-argc-argv">register_argc_argv</link></entry> <entry>&true;</entry> <entry> <para> Áëàãîäàðÿ çíà÷åíèþ &true; â <literal>CLI SAPI</literal> âàì âñåãäà äîñòóïíû ïåðåìåííûå <emphasis>argc</emphasis> (êîëè÷åñòâî àðãóìåíòîâ ïðè çàïóñêå ïðèëîæåíèÿ) è <emphasis>argv</emphasis> (ìàññèâ òåêóùèõ àðãóìåíòîâ). </para> <para> Íà÷èíàÿ ñ PHP 4.3.0, ïðè èñïîëüçîâàíèè <literal>CLI SAPI</literal> ïåðåìåííûå <varname>$argc</varname> è and <varname>$argv</varname> çàðåãèñòðèðîâàíû è çàïîëíåíû ñîîòâåòñòâóþùèìè çíà÷åíèÿìè.  áîëåå ðàííèõ âåðñèÿõ ñîçäàíèå ýòèõ ïåðåìåííûõ, òàê æå, êàê è äëÿ <literal>CGI</literal> èëè ìîäóëÿ âåá-ñåðâåðà, òðåáóåò çíà÷åíèå <emphasis>on</emphasis> äèðåêòèâû <link linkend="ini.register-globals">register_globals</link>. Íåçàâèñèìî îò âåðñèè PHP èëè ñòàòóñà îïöèè register_global îíè âñåãäà äîñòóïíû êàê ýëåìåíòû ìàññèâà <link linkend="reserved.variables.server">$_SERVER</link> èëè <varname>$HTTP_SERVER_VARS</varname>. Íàïðèìåð: <varname>$_SERVER['argv']</varname> </para> </entry> </row> </tbody> </tgroup> </table> </para> <note> <para> Ýòè äèðåêòèâû íå ìîãóò áûòü èíèöèàëèçèðîâàíû äðóãèìè çíà÷åíèÿìè èç êîíôèãóðàöèîííîãî ôàéëà &php.ini; èëè ëþáîãî äðóãîãî (â ñëó÷àå, åñëè îí óêàçàí). Ýòî ÿâëÿåòñÿ îãðàíè÷åíèåì, ïîñêîëüêó óêàçàííûå âûøå çíà÷åíèÿ ïî óìîë÷àíèþ ïðèìåíÿþòñÿ ïîñëå îáðàáîòêè êîíôèãóðàöèîííûõ ôàéëîâ. Òåì íå ìåíåå, ýòè çíà÷åíèÿ ìîãóò áûòü èçìåíåíû âî âðåìÿ ðàáîòû ñêðèïòà (õîòÿ ýòî íå èìååò îñîáîãî ñìûñëà äëÿ óêàçàííûõ äèðåêòèâ, íàïðèìåð, äëÿ <link linkend="ini.register-argc-argv">register_argc_argv</link>). </para> </note> </listitem> <listitem> <para> Îáëåã÷åíà ðàáîòà ñ êîíñîëüþ, áëàãîäàðÿ ñëåäóþùèì îïðåäåëåííûì êîíñòàíòàì: <table> <title>Ñïåöèôè÷åñêèå CLI-êîíñòàíòû</title> <tgroup cols="2"> <thead> <row> <entry>Êîíñòàíòà</entry> <entry>Îïèñàíèå</entry> </row> </thead> <tbody> <row> <entry><constant>STDIN</constant></entry> <entry> Óæå îòêðûòûé ïîòîê <literal>stdin</literal>. Êîíñòàíòà õðàíèò ðåçóëüòàò <programlisting role="php"> <![CDATA[ <?php $stdin = fopen('php://stdin', 'r'); ?> ]]> </programlisting> </entry> </row> <row> <entry><constant>STDOUT</constant></entry> <entry> Óæå îòêðûòûé ïîòîê <literal>stdout</literal>. Êîíñòàíòà õðàíèò ðåçóëüòàò <programlisting role="php"> <![CDATA[ <?php $stdout = fopen('php://stdout', 'w'); ?> ]]> </programlisting> </entry> </row> <row> <entry><constant>STDERR</constant></entry> <entry> Óæå îòêðûòûé ïîòîê <literal>stderr</literal>. Êîíñòàíòà õðàíèò ðåçóëüòàò <programlisting role="php"> <![CDATA[ <?php $stderr = fopen('php://stderr', 'w'); ?> ]]> </programlisting> </entry> </row> </tbody> </tgroup> </table> </para> <para> Èìåÿ âñå ýòî, âû íå äîëæíû ñàìîñòîÿòåëüíî îòêðûâàòü, íàïðèìåð, ïîòîê äëÿ <literal>stderr</literal>, à ïðîñòî èñïîëüçóéòå êîíñòàíòó âìåñòî äåñêðèïòîðà ïîòîêà: <programlisting role="shell"> <![CDATA[ php -r 'fwrite(STDERR, "stderr\n");' ]]> </programlisting> Òàêæå âàì íå íàäî çàêðûâàòü ýòè ïîòîêè, <literal>PHP</literal> àâòîìàòè÷åñêè çàêðûâàåò èõ ïîñëå çàâåðøåíèÿ ñêðèïòà. </para> </listitem> <listitem> <para> <literal>CLI SAPI</literal> <emphasis role="strong">íå</emphasis> èçìåíÿåò òåêóùóþ äèðåêòîðèþ íà äèðåêòîðèþ èñïîëíÿåìîãî ñêðèïòà! </para> <para> Ïðèìåð, äåìîíñòðèðóþùèé îòëè÷èå <literal>CGI SAPI</literal>: <programlisting role="php"> <![CDATA[ <?php // Ïðîñòåéøèé òåñòîâûé ñêðèïò ïîä íàçâàíèåì test.php echo getcwd(), "\n"; ?> ]]> </programlisting> </para> <para>  ñëó÷àå, åñëè èñïîëüçóåòñÿ <literal>CGI</literal> âåðñèÿ, ðåçóëüòàò ðàáîòû áóäåò ñëåäóþùèì: <screen> <![CDATA[ $ pwd /tmp $ php -q another_directory/test.php /tmp/another_directory ]]> </screen> Ýòî íàãëÿäíî äåìîíñòðèðóåò òîò ôàêò, ÷òî <literal>PHP</literal> èçìåíÿåò òåêóùóþ äèðåêòîðèþ íà äèðåêòîðèþ èñïîëíÿåìîãî ñêðèïòà. </para> <para> Èñïîëüçîâàíèå <literal>CLI SAPI</literal> äàåò äðóãîé ðåçóëüòàò: <screen> <![CDATA[ $ pwd /tmp $ php -f another_directory/test.php /tmp ]]> </screen> Ýòî ïîçâîëÿåò ïèñàòü áîëåå ãèáêèå êîíñîëüíûå ñêðèïòû íà <literal>PHP</literal>. </para> <note> <para> <literal>CGI SAPI</literal> ïîçâîëÿåò ïîëó÷èòü àíàëîãè÷íîå <literal>CLI SAPI</literal> ïîâåäåíèå â ñëó÷àå èñïîëüçîâàíèÿ êëþ÷à <literal>-C</literal> ïðè çàïóñêå èç êîìàíäíîé ñòðîêè. </para> </note> </listitem> </itemizedlist> </para> <para> Ñïèñîê îïöèé, äîñòóïíûé ïðè çàïóñêå <literal>PHP</literal> èç êîìàíäíîé ñòðîêè, ìîæåò áûòü ïîëó÷åí â ëþáîé ìîìåíò ïóòåì çàïóñêà <literal>PHP</literal> ñ êëþ÷îì <literal>-h</literal>: <screen> <![CDATA[ Usage: php [options] [-f] <file> [args...] php [options] -r <code> [args...] php [options] [-- args...] -s Îòîáðàæàåò èñõîäíûé êîä ñ öâåòíîé ïîäñâåòêîé -w Îòîáðàæàåò èñõîäíûé òåêñò áåç êîììåíòàðèåâ è ïðîáåëîâ -f <file> Èñïîëíÿåò <file> -v Âûâîäèò èíôîðìàöèþ î âåðñèè PHP -c <path>|<file> Èùåò ôàéë php.ini â óêàçàííîé äèðåêòîðèè -a Èíòåðàêòèâíûé çàïóñê -d foo[=bar] Óñòàíîâèòü êîíôèãóðàöèîííóþ îïöèþ foo çíà÷åíèåì 'bar' -e Ãåíåðàöèÿ äîïîëíèòåëüíîé èíôîðìàöèè äëÿ îòëàä÷èêà è ïðîôàéëåðà -z <file> Çàãðóçèòü Zend-ðàñøèðåíèå <file>. -l Ïðîâåðèòü ñèíòàêñèñ -m Ïîêàçàòü ïîäêëþ÷åííûå ìîäóëè -i Âûâîäèò èíôîðìàöèþ î PHP -r <code> Çàïóñòèòü PHP-êîä áåç èñïîëüçîâàíèÿ <?..?> -h Òåêóùàÿ ñïðàâêà args... Àðãóìåíòû, ïåðåäàâàåìûå ñêðèïòó. Èñïîëüçóéòå -- args â ñëó÷àå, åñëè ïåðâûé àðãóìåíò íà÷èíàåòñÿ ñ '-' èëè ñàì ñêðèïò ÷èòàåòñÿ èç ïîòîêà STDIN. ]]> </screen> </para> <para> <literal>CLI SAPI</literal> èìååò òðè ðàçëè÷íûõ ñïîñîáà ïîëó÷åíèÿ <literal>PHP</literal>-êîäà, êîòîðûé íåîáõîäèìî âûïîëíèòü: <orderedlist> <listitem> <para> Óêàçàòü <literal>PHP</literal> íà èñïîëíåíèå êîíêðåòíîãî ôàéëà. </para> <para> <screen> <![CDATA[ php my_script.php php -f my_script.php ]]> </screen> Îáà ñïîñîáà (ñ èëè áåç èñïîëüçîâàíèÿ êëþ÷à <literal>-f</literal>) èñïîëíÿþò óêàçàííûé ôàéë <filename>my_script.php</filename>. Âû ìîæåòå âûáðàòü ëþáîé ôàéë - âàøè <literal>PHP</literal>-ñêðèïòû íå îáÿçàíû çàêàí÷èâàòüñÿ íà <filename>.php</filename>, à ìîãóò èìåòü ëþáîå èìÿ è ðàñøèðåíèå. </para> </listitem> <listitem> <para> Óêàçàòü <literal>PHP</literal>-êîä äëÿ âûïîëíåíèÿ íåïîñðåäñòâåííî â êîìàíäíîé ñòðîêå. </para> <para> <screen> <![CDATA[ php -r 'print_r(get_defined_constants());' ]]> </screen> Îñîáîãî âíèìàíèÿ òðåáóåò ïîäñòàíîâêà ïåðåìåííûõ îêðóæåíèÿ è èñïîëüçîâàíèå êàâû÷åê. </para> <note> <para> Ïîñìîòðèòå âíèìàòåëüíî íà ïðèìåð: â íåì íåò íà÷àëüíûõ è êîíå÷íûõ òåãîâ! Ïðè èñïîëüçîâàíèè êëþ÷à <literal>-r</literal> îíè íå íóæíû. Èñïîëüçîâàíèå èõ â äàííîì ïðèìåðå ïðèâåäåò ê ñèíòàêñè÷åñêîé îøèáêå. </para> </note> </listitem> <listitem> <para> Ïðåäîñòàâèòü <literal>PHP</literal>-êîä äëÿ âûïîëíåíèÿ ïîñðåäñòâîì ñòàíäàðòíîãî ïîòîêà <literal>stdin</literal>. </para> <para> Ýòî ïîçâîëÿåò äèíàìè÷åñêè ñîçäàâàòü <literal>PHP</literal>-êîä è ïåðåàäðåñîâûâàòü åãî èñïîëíÿåìîìó ìîäóëþ, êàê ïîêàçàíî â ñëåäóþùåì (âûìûøëåííîì) ïðèìåðå: <screen> <![CDATA[ $ some_application | some_filter | php | sort -u >final_output.txt ]]> </screen> </para> </listitem> </orderedlist> Âû íå ìîæåòå êîìáèíèðîâàòü ýòè òðè ñïîñîáà âûïîëíåíèÿ êîäà. </para> <para> Êàê è â ëþáîì êîíñîëüíîì ïðèëîæåíèè, íå òîëüêî <literal>PHP</literal>, íî è ñàì ñêðèïò ìîæåò ïðèíèìàòü àðãóìåíòû êîìàíäíîé ñòðîêè. Êîëè÷åñòâî ïåðåäàâàåìûõ àðãóìåíòîâ â <literal>PHP</literal> íå îãðàíè÷åíî (õîòÿ êîíñîëü èìååò íåêîòîðîå îãðàíè÷åíèå íà êîëè÷åñòâî ïåðåäàâàåìûõ ñèìâîëîâ, íî íà ïðàêòèêå âû íå äîëæíû ñ ýòèì ñòîëêíóòüñÿ). Âñå àðãóìåíòû, ïåðåäàííûå âàøåìó ñêðèïòó, äîñòóïíû â âèäå ãëîáàëüíîãî ìàññèâà <literal>$argv</literal>. Íóëåâîé ýëåìåíò ñîäåðæèò èìÿ ñêðèïòà (êîòîðîå ÿâëÿåòñÿ ñèìâîëîì <literal>-</literal> â ñëó÷àå, åñëè <literal>PHP</literal>-êîä ÷èòàåòñÿ èç ïîòîêà stdin èëè óêàçàí â êîìàíäíîé ñòðîêå ïðè ïîìîùè êëþ÷à <literal>-r</literal>). Âòîðàÿ îïðåäåëÿåìàÿ ãëîáàëüíàÿ ïåðåìåííàÿ <literal>$argc</literal> ñîäåðæèò êîëè÷åñòâî ýëåìåíòîâ ìàññèâà <literal>$argv</literal> (à <emphasis role="strong">íå</emphasis> êîëè÷åñòâî àðãóìåíòîâ, ïåðåäàâàåìûõ ïðè çàïóñêå). </para> <para> Äî òåõ ïîð, ïîêà ïåðåäàâàåìûå àðãóìåíòû íå íà÷èíàþòñÿ ñ ñèìâîëà <literal>-</literal>, íè÷åãî îñîáåííîãî ïðåäïðèíèìàòü íå íàäî. Íî ïðè óêàçàíèè àðãóìåíòà, êîòîðûé íà÷èíàåòñÿ ñ ñèìâîëà <literal>-</literal>, ìîæåò âîçíèêíóòü ïðîáëåìà, òàê êàê <literal>PHP</literal> ïîïûòàåòñÿ îáðàáîòàòü èõ ñàìîñòîÿòåëüíî. ×òîáû ïðåäîòâðàòèòü ýòî, èñïîëüçóéòå <literal>--</literal> â êà÷åñòâå ðàçäåëèòåëÿ ñïèñêà àðãóìåíòîâ. Âñå ïîñëåäóþùèå çà òàêèì ðàçäåëèòåëåì àðãóìåíòû áóäóò ïåðåäàíû âàøåìó ñêðèïòó áåç èçìåíåíèé. </para> <para> <screen> <![CDATA[ # Ïðèâåäåííûé ïðèìåð íå âûïîëíèò óêàçàííûé êîä, à âûäàñò ñïðàâêó îá èñïîëüçîâàíèè PHP $ php -r 'var_dump($argv);' -h Usage: php [options] [-f] <file> [args...] [...] # Àðãóìåíò '-h' áóäåò ïåðåäàí ñêðèïòó, ñïðàâêà íàïå÷àòàíà íå áóäåò $ php -r 'var_dump($argv);' -- -h array(2) { [0]=> string(1) "-" [1]=> string(2) "-h" } ]]> </screen> </para> <para> Îäíàêî, ñóùåñòâóåò åùå îäèí ñïîñîá èñïîëüçîâàíèÿ <literal>PHP</literal> äëÿ íàïèñàíèÿ êîíñîëüíûõ ñêðèïòîâ. Âû ìîæåòå íàïèñàòü ñêðèïò, ïåðâàÿ ñòðîêà êîòîðîãî íà÷èíàåòñÿ ñ <literal>#!/usr/bin/php</literal>. Ñëåäóþùèå ñòðîêè ñîäåðæàò îáûêíîâåííûé <literal>PHP</literal>-êîä, îáðàìëåííûé îòêðûâàþùèìè è çàâåðøàþùèìè <literal>PHP</literal>-òåãàìè. Òàêæå íåîáõîäèìî óñòàíîâèòü ïðàâà íà âûïîëíåíèå (êàê ïðàâèëî, ýòî <literal>chmod +x test</literal>), ÷òîáû âàø ñêðèïò ìîã çàïóñêàòüñÿ, êàê îáûêíîâåííûé êîíñîëüíûé (èëè perl) ñêðèïò: <programlisting role="php"> <![CDATA[ #!/usr/bin/php <?php var_dump($argv); ?> ]]> </programlisting> Ïðåäïîëîæèâ, ÷òî íàø ñêðèïò íàçûâàåòñÿ <filename>test</filename> è ðàñïîëîæåí â òåêóùåé äèðåêòîðèè, ìû ìîæåì âûïîëíèòü ñëåäóþùåå: <screen> <![CDATA[ $ chmod 755 test $ ./test -h -- foo array(4) { [0]=> string(6) "./test" [1]=> string(2) "-h" [2]=> string(2) "--" [3]=> string(3) "foo" } ]]> </screen> Êàê âèäíî èç ïðèìåðà, ïðè ïåðåäà÷å ïàðàìåòðîâ êîìàíäíîé ñòðîêè, íà÷èíàþùèõñÿ ñ ñèìâîëà <literal>-</literal>, íèêàêèõ îñîáûõ äåéñòâèé ïðåäïðèíèìàòü íå íàäî. </para> <para> Ïîëíûå íàçâàíèÿ îïöèé äîñòóïíû, íà÷èíàÿ ñ PHP 4.3.3. <table> <title>Îïöèè, äîñòóïíûå èç êîìàíäíîé ñòðîêè</title> <tgroup cols="2"> <thead> <row> <entry>Îïöèÿ</entry> <entry>Ïîëíîå íàçâàíèå</entry> <entry>Îïèñàíèå</entry> </row> </thead> <tbody> <row> <entry>-s</entry> <entry>--syntax-highlight</entry> <entry> <para> Îòîáðàæàåò èñõîäíûé êîä ñ öâåòíîé ïîäñâåòêîé </para> <para> Ýòà îïöèÿ èñïîëüçóåò âíóòðåííèé ìåõàíèçì ðàçáîðà ôàéëà, ãåíåðèðóåò ïîäñâå÷åííóþ <literal>HTML</literal>-âåðñèþ è çàïèñûâàåò åå â ñòàíäàðòíûé âûâîä. Ñëåäóåò çàìåòèòü, ÷òî ãåíåðèðóåòñÿ òîëüêî áëîê <literal>&lt;code&gt; [...] &lt;/code&gt;</literal> ñ <literal>HTML</literal>-òåãàìè, áåç <literal>HTML</literal>-çàãîëîâêîâ. </para> <note> <para> Ýòà îïöèÿ íå ñîâìåñòèìà ñ îïöèåé <literal>-r</literal>. </para> </note> </entry> </row> <row> <entry>-s</entry> <entry>--syntax-highlighting</entry> <entry> <para> Àëèàñ äëÿ <literal>--syntax-highlight</literal>. </para> </entry> </row> <row> <entry>-w</entry> <entry>--strip</entry> <entry> <para> Îòîáðàæàåò èñõîäíûé òåêñò áåç êîììåíòàðèåâ è ïðîáåëüíûõ ñèìâîëîâ. </para> <note> <para> Ýòà îïöèÿ íå ñîâìåñòèìà ñ îïöèåé <literal>-r</literal>. </para> </note> </entry> </row> <row> <entry>-f</entry> <entry>--file</entry> <entry> <para> Èñïîëíÿåò óêàçàííûé ôàéë. Îïöèÿ <literal>-f</literal> ÿâëÿåòñÿ íå îáÿçàòåëüíîé è ìîæåò îòñóòñòâîâàòü. Äîñòàòî÷íî ïðîñòî óêàçàòü èìÿ ôàéëà. </para> </entry> </row> <row> <entry>-v</entry> <entry>--version</entry> <entry> <para> Âûâîäèò èíôîðìàöèþ î âåðñèè PHP, PHP SAPI è Zend, íàïðèìåð: <screen> <![CDATA[ $ php -v PHP 4.3.0 (cli), Copyright (c) 1997-2002 The PHP Group Zend Engine v1.3.0, Copyright (c) 1998-2002 Zend Technologies ]]> </screen> </para> </entry> </row> <row> <entry>-c</entry> <entry>--php-ini</entry> <entry> <para> Ïðè ïîìîùè ýòîé îïöèè ìîæíî óêàçàòü ñïåöèôè÷åñêóþ äèðåêòîðèþ äëÿ êîíôèãóðàöèîííîãî ôàéëà &php.ini; ëèáî íåïîñðåäñòâåííî óêàçàòü íà ñàì <literal>INI</literal>-ôàéë (íàçâàíèå êîòîðîãî ìîæåò îòëè÷àòüñÿ îò ñòàíäàðòíîãî &php.ini;), íàïðèìåð: <screen> <![CDATA[ $ php -c /custom/directory/ my_script.php $ php -c /custom/directory/custom-file.ini my_script.php ]]> </screen> </para> </entry> </row> <row> <entry>-n</entry> <entry>--no-php-ini</entry> <entry> <para> Óêàçûâàåò íà íåîáõîäèìîñòü èãíîðèðîâàòü êîíôèãóðàöèîííûé ôàéë &php.ini;, äîñòóïåí, íà÷èíàÿ ñ PHP 4.3.0. </para> </entry> </row> <row> <entry>-d</entry> <entry>--define</entry> <entry> <para> Ýòà îïöèÿ ïîçâîëÿåò óñòàíàâëèâàòü ñïåöèàëüíîå çíà÷åíèå äëÿ êàæäîé èç êîíôèãóðàöèîííûõ ïåðåìåííûõ, äîñòóïíûõ â &php.ini;. Ñèíòàêñèñ âûãëÿäèò ñëåäóþùèì îáðàçîì: <screen> <![CDATA[ -d configuration_directive[=value] ]]> </screen> </para> <para> Ïðèìåðû (ïåðåâîäû ñòðîê èñïîëüçîâàíû, ÷òîáû ñäåëàòü òåêñò áîëåå ÷èòàåìûì): <screen> <![CDATA[ # Åñëè îïóùåíî çíà÷åíèå, òî ñîîòâåòñòâóþùåé îïöèè áóäåò ïðèñâîåíî çíà÷åíèå "1" $ php -d max_execution_time -r '$foo = ini_get("max_execution_time"); var_dump($foo);' string(1) "1" # Óêàçàíèå ïóñòîãî çíà÷åíèÿ èíèöèàëèçèðóåò ñîîòâåòñòâóþùóþ îïöèþ çíà÷åíèåì "" php -d max_execution_time= -r '$foo = ini_get("max_execution_time"); var_dump($foo);' string(0) "" # Êîíôèãóðàöèîííàÿ ïåðåìåííàÿ áóäåò óñòàíîâëåíà ëþáûì çíà÷åíèåì, óêàçàííûì ïîñëå ñèìâîëà '=' $ php -d max_execution_time=20 -r '$foo = ini_get("max_execution_time"); var_dump($foo);' string(2) "20" $ php -d max_execution_time=doesntmakesense -r '$foo = ini_get("max_execution_time"); var_dump($foo);' string(15) "doesntmakesense" ]]> </screen> </para> </entry> </row> <row> <entry>-a</entry> <entry>--interactive</entry> <entry> <para> Çàïóñêàåò PHP â èíòåðàêòèâíîì ðåæèìå. <!-- mfischer, 20020510: Couldn't come up with a decent useful description of the current implementation of the interactive mode. --> </para> </entry> </row> <row> <entry>-e</entry> <entry>--profile-info</entry> <entry> <para> Ãåíåðèðóåò äîïîëíèòåëüíóþ èíôîðìàöèþ äëÿ îòëàä÷èêà è ïðîôàéëåðà. <!-- mfischer, 20020510: Anyone who can provide more information what it really does (even if it's only for developers) ? --> </para> </entry> </row> <row> <entry>-z</entry> <entry>--zend-extension</entry> <entry> <para> Ïîäãðóæàåò äîïîëíèòåëüíûé ìîäóëü Zend.  ñëó÷àå, åñëè óêàçàíî òîëüêî èìÿ ôàéëà, PHP èùåò ìîäóëü â òåêóùåì ïóòè ê áèáëèîòåêàì ïî óìîë÷àíèþ (â Linux-ñèñòåìàõ îí îáû÷íî óêàçàí â <filename>/etc/ld.so.conf</filename>).  ñëó÷àå, åñëè óêàçàíî èìÿ ôàéëà è ïîëíûé ïóòü ê íåìó, ïîèñê â ñèñòåìíûõ áèáëèîòåêàõ íå ïðîèçâîäèòñÿ. Óêàçàíèå îòíîñèòåëüíîãî ïóòè ê ìîäóëþ ïðèâåäåò ê ïîèñêó ôàéëà ïî óêàçàííîìó ïóòè îòíîñèòåëüíî òåêóùåé äèðåêòîðèè. </para> </entry> </row> <row> <entry>-l</entry> <entry>--syntax-check</entry> <entry> <para> Ýòà îïöèÿ ïðåäîñòàâëÿåò óäîáíûé ñïîñîá äëÿ ïðîâåðêè çàäàííîãî <literal>PHP</literal>-êîäà íà íàëè÷èå ñèíòàêñè÷åñêèõ îøèáîê.  ñëó÷àå óñïåøíîé ïðîâåðêè áóäåò íàïå÷àòàíà ñëåäóþùàÿ ôðàçà: "<literal>No syntax errors detected in &lt;filename&gt;</literal>",- è êîä âîçâðàòà áóäåò ðàâåí <literal>0</literal>. À â ñëó÷àå íåóäà÷è - òåêñò "<literal>Errors parsing &lt;filename&gt;</literal>" âìåñòå ñ âíóòðåííèìè ñîîáùåíèÿìè ðàçáîðùèêà è êîä âîçâðàòà <literal>255</literal>. </para> <para> Ïðîâåðêà èñõîäíîãî êîäà ïðè ïîìîùè äàííîé îïöèè íå íàõîäèò ôàòàëüíûõ îøèáîê (íàïðèìåð, òàêèõ êàê âûçîâ íåîïðåäåëåííûõ ôóíêöèé). Èñïîëüçóéòå îïöèþ <literal>-f</literal>, åñëè âû õîòèòå ïðîâåðèòü êîä íà íàëè÷èå ôàòàëüíûõ îøèáîê. </para> <note> <para> Ýòà îïöèÿ íå ñîâìåñòèìà ñ îïöèåé <literal>-r</literal>. </para> </note> </entry> </row> <row> <entry>-m</entry> <entry>--modules</entry> <entry> <para> Ïðè èñïîëüçîâàíèè ýòîé îïöèè PHP íàïå÷àòàåò ñïèñîê âñòðîåííûõ (à òàêæå ïîäãðóæåííûõ) ìîäóëåé Zend è PHP. <screen> <![CDATA[ $ php -m [PHP Modules] xml tokenizer standard session posix pcre overload mysql mbstring ctype [Zend Modules] ]]> </screen> </para> </entry> </row> <row> <entry>-i</entry> <entry>--info</entry> <entry> Èñïîëüçîâàíèå ýòîé îïöèè ïðèâîäèò ê âûçîâó ôóíêöèè <function>phpinfo</function> è è âûâîäó ðåçóëüòèðóþùåé èíôîðìàöèè.  ñëó÷àå, åñëè <literal>PHP</literal> ðàáîòàåò íåêîððåêòíî, áóäåò âåñüìà ëîãè÷íî âûïîëíèòü <literal>php -i</literal> è ïîñìîòðåòü, âûâîäÿòñÿ ëè ñîîáùåíèÿ îá îøèáêå äî èíôîðìàöèîííûõ òàáëèö èëè äàæå âìåñòî íèõ. Ó÷òèòå, ÷òî âåñü âûâîä áóäåò â ôîðìàòå <literal>HTML</literal> è, êàê ñëåäñòâèå, ìîæåò âûãëÿäåòü íå÷èòàáåëüíî. </entry> </row> <row> <entry>-r</entry> <entry>--run</entry> <entry> <para> Ýòà îïöèÿ ïîçâîëÿåò âûïîëíÿòü <literal>PHP</literal>-êîä, óêàçàííûé íåïîñðåäñòâåííî â êîìàíäíîé ñòðîêå. Îòêðûâàþùèå è çàâåðøàþùèå <literal>PHP</literal>-òåãè (<literal>&lt;?php</literal> è <literal>?&gt;</literal>) <emphasis role="strong">íå íóæíû</emphasis> è, áîëåå òîãî, ïðèâîäÿò ê ñèíòàêñè÷åñêîé îøèáêå. </para> <note> <para> Ïðè èñïîëüçîâàíèè ýòîãî êëþ÷à ñëåäóåò áûòü î÷åíü îñòîðîæíûì è èçáåãàòü íåäîðàçóìåíèé, ñâÿçàííûõ ñ àâòîìàòè÷åñêîé ïîäñòàíîâêîé ïåðåìåííûõ îêðóæåíèÿ. </para> <para> Âîò ïðèìåð, ïðèâîäÿùèé ê ñèíòàêñè÷åñêîé îøèáêå: <screen> <![CDATA[ $ php -r "$foo = get_defined_constants();" Command line code(1) : Parse error - parse error, unexpected '=' ]]> </screen> Ïðîáëåìà çàêëþ÷àåòñÿ â òîì, ÷òî sh/bash âûïîëíÿåò àâòîìàòè÷åñêóþ ïîäñòàíîâêó ïåðåìåííûõ â ñëó÷àå, åñëè èñïîëüçóþòñÿ äâîéíûå êàâû÷êè (<literal>"</literal>). Ïîñêîëüêó ïåðåìåííàÿ <literal>$foo</literal> âðÿä ëè îïðåäåëåíà, îíà çàìåíÿåòñÿ ïóñòîé ñòðîêîé, òàê ÷òî ïåðåäàâàåìûé <literal>PHP</literal>-êîä äëÿ âûïîëíåíèÿ âûãëÿäèò ñëåäóþùèì îáðàçîì: <screen> <![CDATA[ $ php -r " = get_defined_constants();" ]]> </screen> Ïðàâèëüíûì ðåøåíèåì â äàííîì ñëó÷àå áóäåò èñïîëüçîâàíèå îäèíî÷íûõ êàâû÷åê <literal>'</literal>, ïîñêîëüêó àâòîìàòè÷åñêàÿ ïîäñòàíîâêà ïåðåìåííûõ, çàêëþ÷åííûõ â îäèíî÷íûå êàâû÷êè, â sh/bash íå ïðîèñõîäèò. <screen> <![CDATA[ $ php -r '$foo = get_defined_constants(); var_dump($foo);' array(370) { ["E_ERROR"]=> int(1) ["E_WARNING"]=> int(2) ["E_PARSE"]=> int(4) ["E_NOTICE"]=> int(8) ["E_CORE_ERROR"]=> [...] ]]> </screen> Åñëè âû èñïîëüçóåòå îáîëî÷êó, îòëè÷íóþ îò sh/bash, ó âàñ ìîãóò âîçíèêíóòü äðóãèå âîïðîñû.  òàêîì ñëó÷àå ñîçäàéòå ðàïîðò î âîçíèêøåé ïðîáëåìå èëè íàïèøèòå ïèñüìî ïî àäðåñó phpdoc@lists.php.net. Âû âïîëíå ìîæåòå ñòîëêíóòüñÿ ñ ïðîáëåìàìè ïðè ïîïûòêå ïîëó÷èòü äîñòóï ê ïåðåìåííûì îáîëî÷êè èëè ïðè ðàáîòå ñ ýêðàíèðóþùèìè îáðàòíûìè ñëåøàìè. Ìû âàñ ïðåäóïðåäèëè. </para> </note> <note> <para> Êëþ÷ <literal>-r</literal> äîñòóïåí â <emphasis>CLI</emphasis> SAPI è íå äîñòóïåí â <emphasis>CGI</emphasis> SAPI. </para> </note> </entry> </row> <row> <entry>-h</entry> <entry>--help</entry> <entry> Ïðè ïîìîùè ýòîé îïöèè âû ìîæåòå ïîëó÷èòü èíôîðìàöèþ î äåéñòâóþùåì ñïèñêå îïöèé êîìàíäíîé ñòðîêè è èõ êðàòêîå îïèñàíèå. </entry> </row> <row> <entry>-?</entry> <entry>--usage</entry> <entry> Àëèàñ äëÿ <literal>--help</literal>. </entry> </row> <!-- new, not in PHP 4.3.4, but are in php_cli.c 1.102 or cgi_main.c 1.243 -b <address:port>|<port> bindpath Bind Path for external FASTCGI Server mode, only CGI, no Windows -B <begin_code> process-begin Run PHP <begin_code> before processing input lines -R <code> process-code Run PHP <code> for every input line -F <file> process-file Parse and execute <file> for every input line -E <end_code> process-end Run PHP <end_code> after processing all input lines -H hide-args Hide any passed arguments from external tools. -g global Define global variables on command line --> </tbody> </tgroup> </table> </para> <!-- NEW DOCUMENTATION ENDS --> <!-- OLD DOCUMENTED STARTS mfischer, 20020510: I've commented out the start paragraphs of the old documentation as it is meant to be replaced by the new one. <para> The command line options of the PHP executable are useful if you would like to debug or test your PHP setup, but they can also be handy, if you would like to use PHP for a different purpose than web scripting. </para> <para> Note, that you can always direct the output of the PHP executable to an external file with the &gt; character, so <literal>php -q test.php &gt; test.html</literal> will print out the output of <filename>test.php</filename> without HTTP headers to the <filename>test.html</filename> file in the same directory. </para> <para> You can only use these command line options if you have the PHP executable. If you built the server module version, and you have no CGI version available on your machine, than you have no chance to use these options. For Windows users both the PHP executable and the server modules are in the binary package, the executable is named <filename>php.exe</filename>. </para> <para> This list of command line options is consistent with PHP 4.0.6. You can get the actual list and some one line descriptions with the <literal>-h</literal> option. The output of <literal>php -h</literal> should be something like this: <screen> <![CDATA[ Usage: php [-q] [-h] [-s [-v] [-i] [-f <file>] | {<file> [args...]} -q Quiet-mode. Suppress HTTP Header output. -s Display colour syntax highlighted source. -f <file> Parse <file>. Implies `-q' -v Version number -C Do not chdir to the script's directory -c <path> Look for php.ini file in this directory -d foo[=bar] Define INI entry foo with value 'bar' -e Generate extended information for debugger/profiler -z <file> Load Zend extension <file>. -l Syntax check only (lint) -m Show compiled in modules -i PHP information -h This help ]]> </screen> </para> <para> Here we list some of the most important command line options with detailed explanations. </para> <para> <table> <title>Command line options</title> <tgroup cols="2"> <thead> <row> <entry>Option</entry> <entry>Description</entry> </row> </thead> <tbody> <row> <entry>-q</entry> <entry> Suppress HTTP headers output. Normally PHP prints out HTTP headers for the calling program (ie. webserver) to hand on to the browser. When writing command line applications these headers are useless. </entry> </row> <row> <entry>-s</entry> <entry> Display the color highlighted source of the file given with its name. This is the same as if you were printing out the source using the <function>highlight_file</function> function in a PHP script. </entry> </row> <row> <entry>-f</entry> <entry> Parse the file given, and search for syntactical and fatal errors. This option implies -q. Use for debugging purposes. </entry> </row> <row> <entry>-v</entry> <entry> By calling PHP with this option, you can ask it to print out its version number, ie: 4.0.6. </entry> </row> <row> <entry>-C</entry> <entry> Normally PHP changes the working directory to the running scripts directory. This makes it possible for example, to open files in the same directory, with only specifying the name of the file. If you would like to disable this directory change, use this option. </entry> </row> <row> <entry>-c</entry> <entry> Using this option, you can specify an alternative &php.ini; path, so PHP will search your configurations file in this path instead of the default one. </entry> </row> <row> <entry>-d</entry> <entry> With this option, you can set individual &php.ini; settings in the time of running a script. </entry> </row> <row> <entry>-l</entry> <entry> Check the file given for syntax errors. This option implies -q. Use for debugging purposes. This option won't find fatal errors (like undefined functions). Use -f if you would like to test for fatal errors too. </entry> </row> <row> <entry>-m</entry> <entry> 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> 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> </tgroup> </table> </para> --> <para> Èñïîëíÿåìûé PHP-ôàéë ìîæåò èñïîëüçîâàòüñÿ äëÿ çàïóñêà PHP-ñêðèïòîâ íåçàâèñèìî îò âåá-ñåðâåðà.  ñëó÷àå, åñëè âû ðàáîòàåòå â Unix-ïîäîáíîé ñèñòåìå, âàì íåîáõîäèìî äîáàâèòü êî âñåì ñêðèïòàì ñïåöèàëüíóþ ïåðâóþ ñòðîêó è ñäåëàòü èõ èñïîëíÿåìûìè, ÷òîáû óêàçàòü, êàêàÿ èç ïðîãðàìì äîëæíà îáðàáàòûâàòü ýòè ñêðèïòû. Íà Windows-ïëàòôîðìàõ âû ìîæåòå íàçíà÷èòü îáðàáîò÷èê <literal>php.exe</literal> äëÿ ôàéëîâ ñ ðàñøèðåíèÿìè <literal>.php</literal> ëèáî ñîçäàòü ïàêåòíûé (.bat) ôàéë äëÿ çàïóñêà ñêðèïòîâ ïîñðåäñòâîì PHP. Ñòðîêà, äîáàâëÿåìàÿ âíà÷àëå ñêðèïòà äëÿ Unix-ñèñòåì, íå âëèÿåò íà èõ ðàáîòó â ÎÑ Windows, òàêèì îáðàçîì âû ìîæåòå ñîçäàâàòü êðîññïëàòôîðìåííûå ñêðèïòû. Íèæå ïðèâåäåí ïðîñòîé ïðèìåð ñêðèïòà, âûïîëíÿåìîãî èç êîìàíäíîé ñòðîêè: </para> <para> <example> <title>Ñêðèïò, ïðåäíàçíà÷åííûé äëÿ çàïóñêà èç êîìàíäíîé ñòðîêè (script.php)</title> <programlisting role="php"> <![CDATA[ #!/usr/bin/php <?php if ($argc != 2 || in_array($argv[1], array('--help', '-help', '-h', '-?'))) { ?> Ýòî êîíñîëüíûé PHP-ñêðèïò, ïðèíèìàþùèé îäèí àðãóìåíò. Èñïîëüçîâàíèå: <?php echo $argv[0]; ?> <option> <option> Ëþáîå ñëîâî, êîòîðîå âû õîòåëè áû íàïå÷àòàòü. Îïöèè --help, -help, -h, èëè -? ïîêàæóò òåêóùóþ ñïðàâî÷íóþ èíôîðìàöèþ. <?php } else { echo $argv[1]; } ?> ]]> </programlisting> </example> </para> <para>  ïðèâåäåííîì ïðèìåðå ìû èñïîëüçóåì ñïåöèàëüíóþ ïåðâóþ ñòðîêó äëÿ óêàçàíèÿ íà òî, ÷òî ýòîò ñêðèïò íåîáõîäèìî çàïóñêàòü ïðè ïîìîùè PHP. Ïîñêîëüêó ìû ðàáîòàåì ñ CLI-âåðñèåé, òî 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-ñèñòåìå âû ìîæåòå ñîçäàòü äëÿ ýòîãî ïàêåòíûé ôàéë: </para> <para> <example> <title>Ïàêåòíûé ôàéë äëÿ çàïóñêà PHP-ñêðèïòà èç êîìàíäíîé ñòðîêè (script.bat)</title> <programlisting role="shell"> <![CDATA[ @c:\php\cli\php.exe script.php %1 %2 %3 %4 ]]> </programlisting> </example> </para> <para> Ïðåäïîëàãàÿ, ÷òî ñêðèïò íàçûâàåòñÿ <filename>script.php</filename> è ïîëíûé ïóòü ê CLI <filename>php.exe</filename> ñîâïàäàåò ñ <filename>c:\php\cli\php.exe</filename>, ïðèâåäåííûé ïàêåòíûé ôàéë çàïóñòèò ñêðèïò ñ ïåðåäàííûìè âàìè ïàðàìåòðàìè: <literal>script.bat echothis</literal> ëèáî <literal>script.bat -h</literal>. </para> <para> Âû òàêæå ìîæåòå îçíàêîìèòñÿ ñ ðàñøèðåíèåì <link linkend="ref.readline">Readline</link>, êîòîðîå ìîæåò áûòü èñïîëüçîâàíî äëÿ óñîâåðøåíñòâîâàíèÿ êîíñîëüíîãî PHP-ñêðèïòà. </para> </chapter> <!-- 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 --> http://cvs.php.net/co.php/phpdoc-ru/features/remote-files.xml?r=1.1&p=1 Index: phpdoc-ru/features/remote-files.xml +++ phpdoc-ru/features/remote-files.xml <?xml version="1.0" encoding="windows-1251"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.22 Maintainer: young Status: ready --> <chapter id="features.remote-files"> <title>Ðàáîòà ñ óäàëåííûìè ôàéëàìè</title> <para>  ñëó÷àå, åñëè îïöèÿ <parameter>allow_url_fopen</parameter> âêëþ÷åíà â êîíôèãóðàöèîííîì ôàéëå &php.ini;, âû ìîæåòå èñïîëüçîâàòü HTTP è FTP ññûëêè â áîëüøèíñòâå ôóíêöèé, ïðèíèìàþùèõ â êà÷åñòâå ïàðàìåòðà èìÿ ôàéëà. Òàêæå âû ìîæåòå èñïîëüçîâàòü ññûëêè â îïåðàòîðàõ <function>include</function>, <function>include_once</function>, <function>require</function> è <function>require_once</function>. Äîïîëíèòåëüíóþ èíôîðìàöèþ î ïîääåðæèâàåìûõ â &php; ïðîòîêîëàõ âû ìîæåòå íàéòè â <xref linkend="wrappers"/>. </para> <note> <para>  4.0.3 è áîëåå ðàííèõ âåðñèÿõ ïðè ñáîðêå íåîáõîäèìî èñïîëüçîâàòü îïöèþ <option>--enable-url-fopen-wrapper</option> äëÿ àêòèâàöèè âîçìîæíîñòè ðàáîòàòü ñ óäàëåííûìè ôàéëàìè. </para> </note> <para> <note> <para> Äèñòðèáóòèâû <literal>PHP</literal> äëÿ Windows-ïëàòôîðì äî âåðñèè 4.3 íå ïîääåðæèâàþò âîçìîæíîñòè ðàáîòû ñ óäàëåííûìè ôàéëàìè äëÿ ñëåäóþùèõ îïåðàòîðîâ: <function>include</function>, <function>include_once</function>, <function>require</function>, <function>require_once</function>, è ôóíêöèé âèäà imagecreatefromXXX (<xref linkend="ref.image"/>). </para> </note> </para> <para> Íàïðèìåð, âû ìîæåòå èñïîëüçîâàòü ýòî äëÿ òîãî, ÷òîáû îòêðûòü ôàéë íà óäàëåííîì ñåðâåðå, èçâëå÷ü íåîáõîäèìûå âàì äàííûå è èñïîëüçîâàòü èõ â çàïðîñå ê áàçå äàííûõ èëè æå ïðîñòî îòîáðàçèòü èõ â äèçàéíå âàøåãî ñàéòà. </para> <para> <example> <title>Ïîëó÷åíèå çàãîëîâêà óäàëåííîé ñòðàíèöû</title> <programlisting role="php"> <![CDATA[ <?php $file = fopen ("http://www.example.com/", "r"); if (!$file) { echo "<p>Unable to open remote file.\n"; exit; } while (!feof ($file)) { $line = fgets ($file, 1024); /* Ñðàáîòàåò, òîëüêî åñëè çàãîëîâîê è ñîïóòñòâóþùèå òåãè ðàñïîëîæåíû â îäíîé ñòðîêå */ if (eregi ("<title>(.*)</title>", $line, $out)) { $title = $out[1]; break; } } fclose($file); ?> ]]> </programlisting> </example> </para> <para> Âû òàêæå ìîæåòå ðàáîòàòü ñ óäàëåííûìè ôàéëàìè, ðàñïîëîæåííûìè íà FTP-ñåðâåðå (ïîäðàçóìåâàåòñÿ, ÷òî âû àâòîðèçèðîâàëèñü ñ íåîáõîäèìûìè äëÿ ýòîãî ïðèâèëåãèÿìè). Òàêèì îáðàçîì âû ìîæåòå ñîçäàâàòü íîâûå ôàéëû, íî ïîïûòêà ïåðåçàïèñàòü ñóùåñòâóþùèé ôàéë ïðè ïîìîùè ôóíêöèè <function>fopen</function> ïðèâåäåò ê îøèáêå. </para> <para> Äëÿ òîãî, ÷òî áû àâòîðèçèðîâàòüñÿ ïîä ïîëüçîâàòåëåì, îòëè÷íûì îò 'anonymous', âàì íåîáõîäèìî óêàçàòü ëîãèí (è, âîçìîæíî, ïàðîëü) â àäðåñíîé ñòðîêå, íàïðèìåð òàê: 'ftp://user:password@ftp.example.com/path/to/file'. (Âû ìîæåòå èñïîëüçîâàòü ýòîò æå ñèíòàêñèñ äëÿ äîñòóïà ê óäàëåííûì ôàéëàì ïî HTTP-ïðîòîêîëó, åñëè íåîáõîäèìà Basic-àâòîðèçàöèÿ.) </para> <para> <example> <title>Ñîõðàíåíèå äàííûõ íà óäàëåííîì ñåðâåðå</title> <programlisting role="php"> <![CDATA[ <?php $file = fopen ("ftp://ftp.example.com/incoming/outputfile", "w"); if (!$file) { echo "<p>Unable to open remote file for writing.\n"; exit; } /* Çàïèñü äàííûõ. */ fputs ($file, $_SERVER['HTTP_USER_AGENT'] . "\n"); fclose ($file); ?> ]]> </programlisting> </example> </para> <para> <note> <para> Ãëÿäÿ íà ïðèâåäåííûé âûøå ïðèìåð, ó âàñ ìîæåò âîçíèêíóòü èäåÿ èñïîëüçîâàòü ýòó òåõíèêó äëÿ âåäåíèÿ óäàëåííîãî ëîã-ôàéëà. Ê ñîæàëåíèþ, ýòî íå ðåàëèçóåìî, ïîñêîëüêó ïîïûòêà çàïèñè â óæå ñóùåñòâóþùèé óäàëåííûé ôàéë ïðè ïîìîùè ôóíêöèè <function>fopen</function> ïðèâåäåò ê îøèáêå.  ðåàëèçàöèè ðàñïðåäåëåííîãî ëîãèðîâàíèÿ, âîçìîæíî, âàì ïîìîæåò ôóíêöèÿ <function>syslog</function>. </para> </note> </para> </chapter> <!-- 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 -->
« previous php.doc.ru (#297) next »