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>