diff options
author | foobar <sniper@php.net> | 2003-02-12 04:38:30 +0000 |
---|---|---|
committer | foobar <sniper@php.net> | 2003-02-12 04:38:30 +0000 |
commit | 7788cefdd3bcf534a435d320801b3a80962cb750 (patch) | |
tree | 31bfc20ebfe84c14b0ba6f2266ce933d05c1bb8a /sapi/cli/php.1 | |
parent | cd7260537a211f04135903393b6a3f82764dc5fb (diff) | |
download | php-git-7788cefdd3bcf534a435d320801b3a80962cb750.tar.gz |
"Generate" the man page so that it gets correct version always.
Diffstat (limited to 'sapi/cli/php.1')
-rw-r--r-- | sapi/cli/php.1 | 299 |
1 files changed, 0 insertions, 299 deletions
diff --git a/sapi/cli/php.1 b/sapi/cli/php.1 deleted file mode 100644 index 6235c394b1..0000000000 --- a/sapi/cli/php.1 +++ /dev/null @@ -1,299 +0,0 @@ -./" +----------------------------------------------------------------------+ -./" | 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 5.0.0. -.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. |