Annotation of embedaddon/php/sapi/fpm/php-fpm.8.in, revision 1.1.1.1

1.1       misho       1: .TH PHP-FPM 8 "2009" "The PHP Group" "Scripting Language"
                      2: .SH NAME
                      3: .TP 15
                      4: php-fpm \- PHP FastCGI Process Manager 'PHP-FPM'
                      5: .SH SYNOPSIS
                      6: .B php-fpm
                      7: [options]
                      8: .LP
                      9: .SH DESCRIPTION
                     10: \fBPHP\fP is a widely\-used general\-purpose scripting language that is especially suited for 
                     11: Web development and can be embedded into HTML. This is a variant of PHP that will run in the background as a daemon, listening for CGI requests. Output is logged to @php_fpm_localstatedir@/log/php-fpm.log.
                     12: .LP
                     13: Most options are set in the configuration file. The configuration file is @php_fpm_sysconfdir@/php-fpm.conf. By default, php-fpm will respond to CGI requests listening on localhost http port 9000. Therefore php-fpm expects your webserver to forward all requests for '.php' files to port 9000 and you should edit your webserver configuration file appropriately.
                     14: .SH OPTIONS
                     15: .TP 15
                     16: .B \-C
                     17: Do not chdir to the script's directory
                     18: .TP
                     19: .PD 0
                     20: .B \-\-php\-ini \fIpath\fP|\fIfile\fP
                     21: .TP
                     22: .PD 1
                     23: .B \-c \fIpath\fP|\fIfile\fP
                     24: Look for 
                     25: .B php.ini 
                     26: file in the directory
                     27: .IR path
                     28: or use the specified
                     29: .IR file
                     30: .TP
                     31: .PD 0
                     32: .B \-\-no\-php\-ini
                     33: .TP
                     34: .PD 1
                     35: .B \-n
                     36: No 
                     37: .B php.ini 
                     38: file will be used
                     39: .TP
                     40: .PD 0
                     41: .B \-\-define \fIfoo\fP[=\fIbar\fP]
                     42: .TP
                     43: .PD 1
                     44: .B \-d \fIfoo\fP[=\fIbar\fP]
                     45: Define INI entry 
                     46: .IR foo 
                     47: with value
                     48: .IR bar
                     49: .TP
                     50: .B \-e
                     51: Generate extended information for debugger/profiler
                     52: .TP
                     53: .PD 0
                     54: .B \-\-help
                     55: .TP
                     56: .PD 1
                     57: .B \-h
                     58: This help
                     59: .TP
                     60: .PD 0
                     61: .B \-\-info
                     62: .TP
                     63: .PD 1
                     64: .B \-i
                     65: PHP information and configuration
                     66: .TP
                     67: .PD 0
                     68: .B \-\-modules
                     69: .TP
                     70: .PD 1
                     71: .B \-m
                     72: Show compiled in modules
                     73: .TP
                     74: .PD 0
                     75: .B \-\-version
                     76: .TP
                     77: .PD 1
                     78: .B \-v
                     79: Version number
                     80: .B \-\-prefix \fIpath\fP
                     81: .TP
                     82: .PD 1
                     83: .B \-p
                     84: Specify alternative prefix path (the default is @php_fpm_prefix@)
                     85: .TP
                     86: .PD 0
                     87: .B \-\-fpm\-config \fIfile\fP
                     88: .TP
                     89: .PD 1
                     90: .B \-y
                     91: Specify alternative path to FastCGI process manager configuration file (the default is @php_fpm_sysconfdir@/php-fpm.conf)
                     92: .TP
                     93: .PD 0
                     94: .B \-\-test
                     95: .TP
                     96: .PD 1
                     97: .B \-t
                     98: Test FPM configuration file and exit
                     99: If called twice (-tt), the configuration is dumped before exiting.
                    100: .TP
                    101: .PD 0
                    102: .B \-\-zend\-extension \fIfile\fP
                    103: .TP
                    104: .PD 1
                    105: .B \-z \fIfile\fP
                    106: Load Zend extension 
                    107: .IR file
                    108: .SH FILES
                    109: .TP 15
                    110: .B php-fpm.conf
                    111: The configuration file for the php-fpm daemon.
                    112: .TP
                    113: .B php.ini
                    114: The standard php configuration file.
                    115: .SH EXAMPLES
                    116: You should use the init script provided to start and stop the php-fpm daemon. This situation applies for any unix systems which use init.d for their main process manager.
                    117: .P
                    118: .PD 1
                    119: .RS
                    120: sudo /etc/init.d/php-fpm start
                    121: .RE
                    122: .TP
                    123: If your installation has no appropriate init script, launch php-fpm with no arguments. It will launch as a daemon (background process) by default. The file @php_fpm_localstatedir@/run/php-fpm.pid determines whether php-fpm is already up and running. Once started, php-fpm then responds to several POSIX signals:
                    124: .P
                    125: .PD 0
                    126: .RS
                    127: .B SIGINT,SIGTERM      \fPimmediate termination
                    128: .TP
                    129: .B SIGQUIT                     \fPgraceful stop
                    130: .TP
                    131: .B SIGUSR1                     \fPre-open log file
                    132: .TP
                    133: .B SIGUSR2                     \fPgraceful reload of all workers + reload of fpm conf/binary
                    134: .RE
                    135: .PD 1
                    136: .P
                    137: .SH TIPS
                    138: The PHP-FPM CGI daemon will work well with most popular webservers, including Apache2, lighttpd and nginx.
                    139: .PD 1
                    140: .P
                    141: .SH SEE ALSO
                    142: The PHP-FPM website:
                    143: .PD 0
                    144: .P
                    145: .B http://php-fpm.org
                    146: .PD 1
                    147: .P
                    148: For a more or less complete description of PHP look here:
                    149: .PD 0
                    150: .P
                    151: .B http://www.php.net/manual/
                    152: .PD 1
                    153: .P
                    154: A nice introduction to PHP by Stig Bakken can be found here:
                    155: .PD 0
                    156: .P
                    157: .B http://www.zend.com/zend/art/intro.php
                    158: .PD 1
                    159: .SH BUGS
                    160: You can view the list of known bugs or report any new bug you
                    161: found at:
                    162: .PD 0
                    163: .P
                    164: .B http://bugs.php.net
                    165: .PD 1
                    166: .SH AUTHORS
                    167: PHP-FPM SAPI was written by Andrei Nigmatulin. The mailing-lists are highload-php-en (English) and highload-php-ru (Russian).
                    168: .P
                    169: The PHP Group: Thies C. Arntzen, Stig Bakken, Andi Gutmans, Rasmus Lerdorf, Sam Ruby, Sascha Schumann, Zeev Suraski, Jim Winstead, Andrei Zmievski.
                    170: .P
                    171: A List of active developers can be found here:
                    172: .PD 0
                    173: .P
                    174: .B http://www.php.net/credits.php
                    175: .PD 1
                    176: .P
                    177: And last but not least PHP was developed with the help of a huge amount of 
                    178: contributors all around the world.
                    179: .SH VERSION INFORMATION
                    180: This manpage describes \fBphp-fpm\fP, version @PHP_VERSION@.
                    181: .SH COPYRIGHT
                    182: Copyright \(co 1997\-2009 The PHP Group
                    183: .PD 0
                    184: .P
                    185: Copyright (c) 2007-2009, Andrei Nigmatulin
                    186: .PD 1
                    187: .LP
                    188: This source file is subject to version 3.01 of the PHP license,
                    189: that is bundled with this package in the file LICENSE, and is
                    190: available through the world-wide-web at the following url:
                    191: .PD 0
                    192: .P
                    193: .B http://www.php.net/license/3_01.txt
                    194: .PD 1
                    195: .P
                    196: If you did not receive a copy of the PHP license and are unable to
                    197: obtain it through the world-wide-web, please send a note to
                    198: .B license@php.net
                    199: so we can mail you a copy immediately.

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>