cvs: phpdoc /en/features commandline.xml

mfischer Thu Jun 6 14:36:45 2002 EDT Modified files: /phpdoc/en/features commandline.xml Log: - Sync with latest commits to php_cgi.c . Index: phpdoc/en/features/commandline.xml diff -u phpdoc/en/features/commandline.xml:1.5 phpdoc/en/features/commandline.xml:1.6 --- phpdoc/en/features/commandline.xml:1.5 Thu May 16 16:52:38 2002 +++ phpdoc/en/features/commandline.xml Thu Jun 6 14:36:45 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <chapter id="features.commandline"> <title>Using PHP from the command line</title> <!-- NEW DOCUMENTATION STARTS --> @@ -109,6 +109,65 @@ e.g. <link linkend="ini.register-argc-argv">register_argc_argv</link>). </para> </note> + </listitem> + <listitem> + <para> + The ease the operating in the shell environment, the following constants + are defined: + <table> + <title>CLI specific Constants</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Constant</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>STDIN</constant></entry> + <entry> + An already opened stream to <literal>stdin</literal>. This saves + opening it with + <programlisting role="php"> +$stdin = fopen('php://stdin', 'r'); + </programlisting> + </entry> + </row> + <row> + <entry><constant>STDOUT</constant></entry> + <entry> + An already opened stream to <literal>stdout</literal>. This saves + opening it with + <programlisting role="php"> +$stdout = fopen('php://stdout', 'w'); + </programlisting> + </entry> + </row> + <row> + <entry><constant>STDERR</constant></entry> + <entry> + An already opened stream to <literal>stdout</literal>. This saves + opening it with + <programlisting role="php"> +$stderr = fopen('php://stderr', 'w'); + </programlisting> + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> + Given the above, you don't need to open e.g. a stream for + <literal>stderr</literal> yourself but simply use the constant instead of + the stream resource: + <programlisting role="php"> +php -r 'fwrite(STDERR, "stderr\n");' + </programlisting> + You do not need to explicitely close these streams, this is automatically + done by <literal>PHP</literal>. + </para> </listitem> <listitem> <para>