Re: [PHP-DOC] cvs: phpdoc /en/appendices commandline.xml
On Sun, Jun 23, 2002 at 01:26:02AM -, Marcus Börger wrote : helly Sat Jun 22 21:26:02 2002 EDT Modified files: /phpdoc/en/appendices commandline.xml Log: explain cli and difference to cgi Are you sure you hit the right document? I don't see appendices/commandilne.xml being used anywhere (might be wrong?) , we were updating features/commandline.xml instead which is the one reflected at http://www.php.net/manual/en/features.commandline.php . - Markus
Re: [PHP-DOC] cvs: phpdoc /en/appendices commandline.xml
At 08:35 23.06.2002, Markus Fischer wrote: On Sun, Jun 23, 2002 at 01:26:02AM -, Marcus Börger wrote : helly Sat Jun 22 21:26:02 2002 EDT Modified files: /phpdoc/en/appendices commandline.xml Log: explain cli and difference to cgi Are you sure you hit the right document? I don't see appendices/commandilne.xml being used anywhere (might be wrong?) , we were updating features/commandline.xml instead which is the one reflected at http://www.php.net/manual/en/features.commandline.php . - Markus Arghs, i wasn't aware of that file. Perhaps the one i changed should be removed and i'll see if i merge something into the new one. marcus
Re: [PHP-DOC] cvs: phpdoc /en/appendices commandline.xml
On Sun, 23 Jun 2002, Marcus Börger wrote: helly Sat Jun 22 21:26:02 2002 EDT Modified files: /phpdoc/en/appendices commandline.xml Log: explain cli and difference to cgi Please don't use tabs for indentation in the XML docs. Derick --- Did I help you? http://www.derickrethans.nl/link.php?url=giftlist Frequent ranting: http://www.derickrethans.nl/ --- PHP: Scripting the Web - [EMAIL PROTECTED] All your branches are belong to me! SRM: Script Running Machine - www.vl-srm.net ---
[PHP-DOC] cvs: phpdoc /en/appendices commandline.xml
helly Sat Jun 22 21:26:02 2002 EDT
Modified files:
/phpdoc/en/appendices commandline.xml
Log:
explain cli and difference to cgi
Index: phpdoc/en/appendices/commandline.xml
diff -u phpdoc/en/appendices/commandline.xml:1.10
phpdoc/en/appendices/commandline.xml:1.11
--- phpdoc/en/appendices/commandline.xml:1.10 Thu Mar 28 12:16:34 2002
+++ phpdoc/en/appendices/commandline.xmlSat Jun 22 21:26:02 2002
-1,5 +1,5
?xml version=1.0 encoding=iso-8859-1?
-!-- $Revision: 1.10 $ --
+!-- $Revision: 1.11 $ --
!--
TODO:
-19,29 +19,40
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 literalphp -q test.php test.html/literal will
- print out the output of filenametest.php/filename
- without HTTP headers to the filenametest.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 filenamephp.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
- literalphp -h/literal should be something like this:
- screen
+ para
+ There are two commandline versions of PHP. First you can
+ use the CGI version of PHP as a commandline interpreter and
+ since version 4.2 of PHP you can use the CLI version where
+ CLI stands for Command Line Interface. As the name suggests
+ the CLI version has some modifications which allow easier
+ use on the commandline.
+ /para
+ section id=commandline.cgi
+ titleThe CGI version/title
+para
+ Note, that you can always direct the output of the PHP
+ executable to an external file with the gt; character,
+ so literalphp -q test.php test.html/literal will
+ print out the output of filenametest.php/filename
+ without HTTP headers to the filenametest.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 filenamephp.exe/filename.
+/para
+para
+ This list of command line options is consistent with
+ the CGI version of PHP 4.0.6.
+ You can get the actual list and some one line descriptions
+ with the literal-h/literal option. The output of
+ literalphp -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.
-49,7 +60,7
-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
+ -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.
-58,143 +69,145
-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
- titleCommand line options/title
- tgroup cols=2
-thead
- row
- entryOption/entry
- entryDescription/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
- functionhighlight_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
[PHP-DOC] cvs: phpdoc /en/appendices commandline.xml migration4.xml /en/chapters config.xml install.apache.xml install.configure.php.xml install.windows.xml security.xml /en/faq com.xml using.xml /en/features connection-handling.xml error-handling.xml file-upload.xml remote-files.xml /en/functions com.xml filesystem.xml http.xml ibase.xml info.xml ingres_ii.xml ldap.xml math.xml mbstring.xml mcrypt.xml ming.xml mssql.xml pgsql.xml printer.xml session.xml var.xml /en/language basic-syntax.xml variables.xml
hholzgraThu Mar 28 12:16:46 2002 EDT Modified files: /phpdoc/en/appendices commandline.xml migration4.xml /phpdoc/en/chapters config.xml install.apache.xml install.configure.php.xml install.windows.xml security.xml /phpdoc/en/faq com.xml using.xml /phpdoc/en/features connection-handling.xml error-handling.xml file-upload.xml remote-files.xml /phpdoc/en/functionscom.xml filesystem.xml http.xml ibase.xml info.xml ingres_ii.xml ldap.xml math.xml mbstring.xml mcrypt.xml ming.xml mssql.xml pgsql.xml printer.xml session.xml var.xml /phpdoc/en/language basic-syntax.xml variables.xml Log: use php.ini; entity Index: phpdoc/en/appendices/commandline.xml diff -u phpdoc/en/appendices/commandline.xml:1.9 phpdoc/en/appendices/commandline.xml:1.10 --- phpdoc/en/appendices/commandline.xml:1.9Thu Jan 17 22:32:22 2002 +++ phpdoc/en/appendices/commandline.xmlThu Mar 28 12:16:34 2002 -1,5 +1,5 ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.9 $ -- +!-- $Revision: 1.10 $ -- !-- TODO: -124,7 +124,7 entry-c/entry entry Using this option, you can specify an alternative - filenamephp.ini/filename path, so PHP will + php.ini; path, so PHP will search your configurations file in this path instead of the default one. /entry -133,7 +133,7 entry-d/entry entry With this option, you can set individual - filenamephp.ini/filename settings in the + php.ini; settings in the time of running a script. /entry /row Index: phpdoc/en/appendices/migration4.xml diff -u phpdoc/en/appendices/migration4.xml:1.22 phpdoc/en/appendices/migration4.xml:1.23 --- phpdoc/en/appendices/migration4.xml:1.22Thu Mar 28 11:40:32 2002 +++ phpdoc/en/appendices/migration4.xml Thu Mar 28 12:16:34 2002 -1,5 +1,5 ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.22 $ -- +!-- $Revision: 1.23 $ -- appendix id=migration4 titleMigrating from PHP 3 to PHP 4/title -56,7 +56,7 titleMigrating Configuration Files/title para The global configuration file, filenamephp3.ini/filename, -has changed its name to filenamephp.ini/filename. +has changed its name to php.ini;. /para para For the Apache configuration file, there are slightly more -208,7 +208,7 want the error reporting system to report all but the simple style warnings that are categorized by the symbolic constant literalE_NOTICE/literal. Then you'll put the following into - your filenamephp.ini/filename: literalerror_reporting = + your php.ini;: literalerror_reporting = E_ALL amp; ~ ( E_NOTICE )/literal. If you want to suppress warnings too you add up the appropriate constant within the braces using the binary or operator '|': -331,7 +331,7 the Zend engine) at runtime as parsing already happened by then. So the function functionshort_tags/function no longer exists. You can still change the parsers behavior by setting - appropriate values in the filenamephp.ini/filename file. + appropriate values in the php.ini; file. /para para Another feature of PHP 3 that is not a part of PHP 4 is the bundled Index: phpdoc/en/chapters/config.xml diff -u phpdoc/en/chapters/config.xml:1.40 phpdoc/en/chapters/config.xml:1.41 --- phpdoc/en/chapters/config.xml:1.40 Thu Mar 28 12:06:54 2002 +++ phpdoc/en/chapters/config.xml Thu Mar 28 12:16:34 2002 -1,5 +1,5 ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.40 $ -- +!-- $Revision: 1.41 $ -- chapter id=configuration titleConfiguration/title -8,13 +8,13 simpara The configuration file (called filenamephp3.ini/filename in -PHP 3.0, and simply filenamephp.ini/filename as of PHP 4.0) +PHP 3.0, and simply php.ini; as of PHP 4.0) is read when PHP starts up. For the server module versions of PHP, this happens only once when the web server is started. For the acronymCGI/acronym version, it happens on every invocation./simpara para example - titlephp.ini example/title + titlephp.ini; example/title programlisting role=ini ![CDATA[ ; any text on a line after an unquoted semicolon (;) is ignored Index: phpdoc/en/chapters/install.apache.xml diff -u phpdoc/en/chapters/install.apache.xml:1.9 phpdoc/en/chapters/install.apache.xml:1.10 --- phpdoc/en/chapters/install.apache.xml:1.9 Thu Mar 28 12:11:10 2002 +++ phpdoc/en/chapters/install.apache.xml Thu Mar 28 12:16:36 2002 -1,5 +1,5 ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.9 $ -- +!-- $Revision: 1.10 $ -- sect1 id=install.apache titleServers-Apache/title para -135,7 +135,7
[PHP-DOC] cvs: phpdoc /en/appendices commandline.xml
gobaFri Dec 28 10:14:25 2001 EDT Modified files: /phpdoc/en/appendices commandline.xml Log: Add -f and -l option documentation. Add see also readline para. Index: phpdoc/en/appendices/commandline.xml diff -u phpdoc/en/appendices/commandline.xml:1.7 phpdoc/en/appendices/commandline.xml:1.8 --- phpdoc/en/appendices/commandline.xml:1.7Wed Dec 12 15:46:26 2001 +++ phpdoc/en/appendices/commandline.xmlFri Dec 28 10:14:25 2001 @@ -1,12 +1,12 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.7 $ -- +!-- $Revision: 1.8 $ -- !-- TODO: The command line options not in the list, but in the -h output below: - -f, -e, -z, -l + -e, -z It would be best to document these, and collect more info about -c and -d! @@ -95,6 +95,14 @@ /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 @@ -130,6 +138,16 @@ /entry /row row + entry-l/entry + entry + Check the file given for syntax errors. This + option implies -q. Use for debugging purpouses. + 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 @@ -239,6 +257,11 @@ will run it for you with your added options: literalscript.bat echothis/literal or literalscript.bat -h/literal. + /para + para + See also the link linkend=ref.readlineReadline/link + extension documentation for more functions you can use + to enhance your command line applications in PHP. /para /appendix
[PHP-DOC] cvs: phpdoc /en/appendices commandline.xml
gobaSun Nov 18 05:59:12 2001 EDT
Modified files:
/phpdoc/en/appendices commandline.xml
Log:
Ups, computeroutput seems to be an inline element.
But screen is documented as a block type of element...
Index: phpdoc/en/appendices/commandline.xml
diff -u phpdoc/en/appendices/commandline.xml:1.5
phpdoc/en/appendices/commandline.xml:1.6
--- phpdoc/en/appendices/commandline.xml:1.5Sat Nov 10 16:49:25 2001
+++ phpdoc/en/appendices/commandline.xmlSun Nov 18 05:59:12 2001
@@ -1,5 +1,5 @@
?xml version=1.0 encoding=iso-8859-1?
-!-- $Revision: 1.5 $ --
+!-- $Revision: 1.6 $ --
!--
TODO:
@@ -41,7 +41,7 @@
You can get the actual list and some one line descriptions
with the literal-h/literal option. The output of
literalphp -h/literal should be something like this:
- computeroutput
+ screen
![CDATA[
Usage: php [-q] [-h] [-s [-v] [-i] [-f file] | {file [args...]}
-q Quiet-mode. Suppress HTTP Header output.
@@ -58,7 +58,7 @@
-i PHP information
-h This help
]]
- /computeroutput
+ /screen
/para
para
Here we list some of the most important command line options
[PHP-DOC] cvs: phpdoc /en/appendices commandline.xml
damsFri Oct 19 11:02:38 2001 EDT Modified files: /phpdoc/en/appendices commandline.xml Log: no message Index: phpdoc/en/appendices/commandline.xml diff -u phpdoc/en/appendices/commandline.xml:1.1 phpdoc/en/appendices/commandline.xml:1.2 --- phpdoc/en/appendices/commandline.xml:1.1Sun Oct 14 09:19:12 2001 +++ phpdoc/en/appendices/commandline.xmlFri Oct 19 11:02:37 2001 @@ -1,5 +1,5 @@ ?xml encoding=iso-8859-1? -!-- $Revision: 1.1 $ -- +!-- $Revision: 1.2 $ -- !-- TODO: @@ -20,7 +20,7 @@ different purpose than web scripting. /para para - Note, that you can allways direct the output of the PHP + Note, that you can always direct the output of the PHP executable to an external file with the gt; character, so literalphp -q test.php test.html/literal will print out the output of filenametest.php/filename @@ -78,7 +78,7 @@ row entry-q/entry entry - Suppress HTTP headers output. Normally PHP prints out + Suppress HTTP headers output. Normaly 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. @@ -215,7 +215,7 @@ 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, printng the script name dynamically. + we printed out the help message, printing the script name dynamically. If we received some other argument we echoed that out. /para para
[PHP-DOC] cvs: phpdoc /en/appendices commandline.xml
damsFri Oct 19 11:08:49 2001 EDT Modified files: /phpdoc/en/appendices commandline.xml Log: Correcting my own mistakes =D Index: phpdoc/en/appendices/commandline.xml diff -u phpdoc/en/appendices/commandline.xml:1.2 phpdoc/en/appendices/commandline.xml:1.3 --- phpdoc/en/appendices/commandline.xml:1.2Fri Oct 19 11:02:37 2001 +++ phpdoc/en/appendices/commandline.xmlFri Oct 19 11:08:49 2001 @@ -1,5 +1,5 @@ ?xml encoding=iso-8859-1? -!-- $Revision: 1.2 $ -- +!-- $Revision: 1.3 $ -- !-- TODO: @@ -78,7 +78,7 @@ row entry-q/entry entry - Suppress HTTP headers output. Normaly PHP prints out + 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.
