diff options
Diffstat (limited to 'sapi/cli/php.1.in')
| -rw-r--r-- | sapi/cli/php.1.in | 299 |
1 files changed, 299 insertions, 0 deletions
diff --git a/sapi/cli/php.1.in b/sapi/cli/php.1.in new file mode 100644 index 0000000000..75fc6f5fe2 --- /dev/null +++ b/sapi/cli/php.1.in @@ -0,0 +1,299 @@ +./" +----------------------------------------------------------------------+ +./" | PHP Version 4 | +./" +----------------------------------------------------------------------+ +./" | Copyright (c) 1997-2003 The PHP Group | +./" +----------------------------------------------------------------------+ +./" | This source file is subject to version 2.02 of the PHP license, | +./" | that is bundled with this package in the file LICENSE, and is | +./" | available at through the world-wide-web at | +./" | http://www.php.net/license/2_02.txt. | +./" | If you did not receive a copy of the PHP license and are unable to | +./" | obtain it through the world-wide-web, please send a note to | +./" | license@php.net so we can mail you a copy immediately. | +./" +----------------------------------------------------------------------+ +./" | Author: Marcus Boerger <helly@php.net> | +./" +----------------------------------------------------------------------+ +./" +./" $Id$ +./" +.TH PHP 1 "Feb 2003" "The PHP Group" "Scripting Language" +.SH NAME +.TP 15 +.B php +PHP Command Line Interface 'CLI' +.SH SYNOPSIS +.B php +[options] [ +.B \-f ] +.IR file +[[\-\-] +.IR args.\|.\|. ] +.LP +.B php +[options] +.B \-r +.IR code +[[\-\-] +.IR args.\|.\|. ] +.LP +.B php +[options] [\-B +.IR code ] +.B \-R +.IR code +[\-E +.IR code ] +[[\-\-] +.IR args.\|.\|. ] +.LP +.B php +[options] [\-B +.IR code ] +.B \-F +.IR file +[\-E +.IR code ] +[[\-\-] +.IR args.\|.\|. ] +.LP +.B php +[options] \-\- [ +.IR args.\|.\|. ] +.LP +.SH DESCRIPTION +.B PHP +is a widely\-used general\-purpose scripting language that is especially suited for +Web development and can be embedded into HTML. This is the command line interface +that enables you to the following: +.P +You can parse and execute files by using parameter \-f followed by the name of the +.IR file +to be executed. +.LP +Using parameter \-r you can directly execute PHP +.IR code +simply as you would do inside a .php file when using the +.B eval() +function. +.LP +It is also possible to process the standard input line by line using either +the parameter \-R or \-F. In this mode each separate input line causes the +.IR code +specified by \-R or the +.IR file +specified by \-F to be executed. +You can access the input line by \fB$argn\fP. While processing the input lines +.B $argi +contains the number of the actual line being processed. Further more +the paramters \-B and \-E can be used to execute +.IR code +(see \-r) before and +after all input lines have been processed respectively. +.LP +If none of \-r \-f \-B \-R \-F or \-E is present but a single parameter is given +then this parameter is taken as the filename to parse and execute (same as +with \-f). If no parameter is present then the standard input is read and +executed. +.SH OPTIONS +.TP 15 +.B \-a +Run interactively +.TP +.B \-c \fIpath\fP|\fIfile\fP +Look for +.B php.ini +file in the directory +.IR path +or use the specified +.IR file +.TP +.B \-n +No +.B php.ini +file will be used +.TP +.B \-d \fIfoo\fP[=\fIbar\fP] +Define INI entry +.IR foo +with value +.IR bar +.TP +.B \-e +Generate extended information for debugger/profiler +.TP +.B \-f \fIfile\fP +Parse and execute +.IR file +.TP +.B \-h +This help +.TP +.B \-H +Hide script name (\fIfile\fP) and parameters (\fIargs\.\.\.\fP) from external +tools. For example you may want to use this when a php script is started as +a daemon and the command line contains sensitive data such as passwords. +.TP +.B \-i +PHP information and configuration +.TP +.B \-l +Syntax check only (lint) +.TP +.B \-m +Show compiled in modules +.TP +.B \-r \fIcode\fP +Run PHP +.IR code +without using script tags +.B '<?..?>' +.TP +.B \-B \fIcode\fP +Run PHP +.IR code +before processing input lines +.TP +.B \-R \fIcode\fP +Run PHP +.IR code +for every input line +.TP +.B \-F \fIfile\fP +Parse and execute +.IR file +for every input line +.TP +.B \-E \fIcode\fP +Run PHP +.IR code +after processing all input lines +.TP +.B \-s +Display colour syntax highlighted source +.TP +.B \-v +Version number +.TP +.B \-w +Display source with stripped comments and whitespace +.TP +.B \-z \fIfile\fP +Load Zend extension +.IR file +.TP +.IR args.\|.\|. +Arguments passed to script. Use +.B '\-\-' +.IR args +when first argument starts with +.B '\-' +or script is read from stdin +.SH FILES +.TP 15 +.B php\-cli.ini +The configuration file for the CLI version of PHP. +.TP +.B php.ini +The standard configuration file will only be used when +.B php\-cli.ini +cannot not be found. +.SH EXAMPLES +.TP 5 +\fIphp -r 'echo "Hello World\\n";'\fP +This command simply writes the text "Hello World" to stabdard out. +.TP +\fIphp \-r 'print_r(gd_info());'\fP +This shows the configuration of your gd extension. You can use this +to easily check which imag formats you can use. If you have any +dynamic modules you may want to use the same ini file that php uses +when executed from your webserver. There are more extensions which +have such a function. For dba use: +.RS +\fIphp \-r 'print_r(dba_handlers(1));'\fP +.RE +.TP +\fIphp \-d html_errors=1 \-i | php \-R 'echo strip_tags($argn)."\\n";'\fP +This example uses PHP first to generate a HTML output. This is +meant to be replaced with any tool that displays HTML (for instance +you could use 'cat file.html'). The second php command now strips off +the HTML tags line by line and outputs the result. +.TP +\fIphp \-E 'echo "Lines: $argi\\n";'\fP +This command shows the number of lines being input. +.TP +\fIphp \-R '$l+=count(file($argn));' \-E'echo "Lines:$l\\n";'\fP +This commands expects each input line beeing a file. It counts all lines +of the files specified by each input line and shows the summarized result. +You may combine this with tools like find and change the php scriptlet. +.TP +\fIphp \-R 'echo "$argn\\n"; fgets(STDIN);'\fP +Since you have access to STDIN from within \-B \-R and \-F you can skip certain +input lines with your code. But note that in such cases $argi only counts the +lines being processed by php itself. Having read this you will guess what the +above program does: skipping every second input line. +.SH TIPS +You can use a shebang line to automatically invoke php +from scripts. Only the CLI version of PHP will ignore +such a first line as shown below: +.P +.PD 0 +.RS +#!/bin/php +.P +<?php +.P + // your script +.P +?> +.RE +.PD 1 +.P +.SH SEE ALSO +For a more or less complete description of PHP look here: +.PD 0 +.P +.B http://www.php.net/manual/ +.PD 1 +.P +A nice introduction to PHP by Stig Sæther Bakken can be found here: +.PD 0 +.P +.B http://www.zend.com/zend/art/intro.php +.PD 1 +.SH BUGS +You can view the list of known bugs or add any new bug you +found here: +.PD 0 +.P +.B http://bugs.php.net +.PD 1 +.SH AUTHORS +The PHP Group: Thies C. Arntzen, Stig Bakken, Andi Gutmans, Rasmus Lerdorf, Sam Ruby, Sascha Schumann, Zeev Suraski, Jim Winstead, Andrei Zmievski. +.P +Additional work for the CLI sapi was done by Edin Kadribasic and Marcus Boerger. +.P +A List of active developers can be found here: +.PD 0 +.P +.B http://www.php.net/credits.php +.PD 1 +.P +And last but not least PHP was developed with the help of a huge amount of +contributors all around the world. +.SH VERSION INFORMATION +This manpage describes \fBphp\fP, version @PHP_VERSION@. +.SH COPYRIGHT +Copyright \(co 1997\-2003 The PHP Group +.LP +This source file is subject to version 2.02 of the PHP license, +that is bundled with this package in the file LICENSE, and is +available at through the world-wide-web at +.PD 0 +.P +.B http://www.php.net/license/2_02.txt +.PD 1 +.P +If you did not receive a copy of the PHP license and are unable to +obtain it through the world-wide-web, please send a note to +.B license@php.net +so we can mail you a copy immediately. |