My Online Log

What is Nginx ?

nginx (pronounced as “engine X”) is a lightweight, high performance web server/reverse proxy and e-mail (IMAP/POP3) proxy, licensed under a BSD-like license.

What is PHP-FPM ?

PHP-FPM is a patch for PHP4/5 to greatly improve PHP’s FastCGI SAPI capabilities and administration. This means that you don’t install php through your distribution’s package manager, but rather download the package from the PHP-website, and the patch from another site. You patch up the sourcecode, compile things, and get it started.

The following is a comparison chart of problems and how php-fpm handles them, when enabled with the FastCGI SAPI:

Description	php “out of the box”	spawn-fcgi + spawn-php.sh + daemontools	php-fpm
php daemonization: pid file, log file, setsid(), setuid(), setgid(), chroot()	(-)	(+)	(+)
Process Management. Ability to “graceful” stop and start php workers without losing any queries. The possibility of gradually update the configuration and binary without losing any queries.	php4 (-), php5 (only graceful completion)	(-)	(+)
Restricting ip addresses from which requests can come from a web server	php4 (-), php5 (+) (from 5.2.2)	(-)	(+)
Dynamic number of processes, depending on the load	(-)	(-)	TODO
Starting the workers with different uid/gid/chroot/environment and different php.ini option. You do not need a safe mode!	(-)	(-)	(+)
Logging stdout & stderr business processes	(-)	(-)	(+)
Emergency restart all the processes in the event of accidental destruction of shared memory opcode cache, if used accelerator	(-)	(-)	(+)
Forcing the completion of process if set_time_limit() fails	(-)	(-)	(+)

Installation

1. Install some dependecies first
# yast2 –install gcc libjpeg-devel libpng-devel libmcrypt libmcrypt-devel pcre pcre-devel libcurl-devel  libmysqlclient-devel mysql make wget vim

2. We need to get PHP-sourcecode and php-fpm patch, in this tutorial i use php-5.2.10 and php-5.2.10-fpm-0.5.13
# wget http://id.php.net/get/php-5.2.10.tar.bz2/from/us.php.net/mirror
# wget http://php-fpm.org/downloads/php-5.2.10-fpm-0.5.13.diff.gz

3. Extract and run the patch
# tar xvf php-5.2.10.tar.bz2
# gzip -cd php-5.2.10-fpm-0.5.13.diff.gz | patch -d php-5.2.10 -p1

4. Configure and compile  php-5.2.10 and php-5.2.10-fpm-0.5.13 patch

# cd php-5.2.10
#  ./configure –enable-fastcgi –enable-fpm –with-mcrypt –enable-mbstring –enable-mysql –with-mysql=/usr/include/mysql –with-mysql-sock=/var/lib/mysql/mysql.sock –with-curl –with-sockets –with-gd –with-zlib –with-iconv –with-dom –with-jpeg-dir=/usr/lib
#  make
#  make install

5. Installing Init Script for PHP-FPM
# cd /etc/init.d/
# ln -s /usr/local/sbin/php-fpm php-fpm

now make the nginx start on boot

# chkconfig –add php-fpm
# chkconfig –level 345 php-fpm on

6. Installing and configure nginx, when i write this tutorial the latest stable versions are nginx-0.7.61 you can go to http://nginx.net/ for latest nginx sourcode
#  wget http://sysoev.ru/nginx/nginx-0.7.61.tar.gz
#  tar xvf http://sysoev.ru/nginx/nginx-0.7.61.tar.gz
#  cd nginx-0.7.61
#  ./configure –pid-path=/usr/local/nginx/logs/nginx.pid –sbin-path=/usr/local/sbin/nginx –with-md5=/usr/lib –with-sha1=/usr/lib –with-http_ssl_module –with-http_dav_module –without-mail_pop3_module –without-mail_imap_module –without-mail_smtp_module

you should see this on the end of configuration

nginx path prefix: “/usr/local/nginx”
nginx binary file: “/usr/local/sbin/nginx”
nginx configuration prefix: “/usr/local/nginx/conf”
nginx configuration file: “/usr/local/nginx/conf/nginx.conf”
nginx pid file: “/usr/local/nginx/logs/nginx.pid”
nginx error log file: “/usr/local/nginx/logs/error.log”
nginx http access log file: “/usr/local/nginx/logs/access.log”
nginx http client request body temporary files: “client_body_temp”
nginx http proxy temporary files: “proxy_temp”
nginx http fastcgi temporary files: “fastcgi_temp”

# make
# make install

now make the nginx start on boot

# chkconfig –add nginx
# chkconfig –level 345 nginx on

7. Installing Nginx Daemon for openSUSE 11.0, you can copy paste this script to your /etc/init.d/nginx

# vim /etc/init.d/nginx

#! /bin/sh

PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
DAEMON=/usr/local/sbin/nginx
NAME=nginx
DESC=nginx
PIDFILE=/usr/local/nginx/logs/$NAME.pid
DAEMON_CONFIG=/usr/local/nginx/conf/nginx.conf

test -x $DAEMON || exit 0

set -e

case “$1” in
start)
echo -n “Starting $DESC: ”
start-stop-daemon –start –quiet –pidfile $PIDFILE \
–exec $DAEMON
echo ” started”
;;
stop)
echo -n “Stopping $DESC: ”
if [ -f $PIDFILE ]; then
kill -15 `cat $PIDFILE 2>/dev/null`
fi
echo ” stopped”
;;
restart|force-reload)
echo -n “Restarting $DESC: ”
if [ -f $PIDFILE ]; then
kill -15 `cat $PIDFILE 2>/dev/null`
fi
sleep 1
start-stop-daemon –start –quiet –pidfile $PIDFILE \
–exec $DAEMON
echo ” restarted”
;;
status)
echo “Status $DESC: ”
ps aux | grep -v grep | grep -v /bin/sh | grep $NAME
;;
*)
N=/etc/init.d/$NAME
echo “Usage: $N {start|stop|status|restart}” >&2
exit 1
;;
esac

exit 0

8.  Nginx  configuration

– Go to nginx.conf on /usr/local/nginx/conf/nginx.conf and  remove the #

user  nobody;

– Go to/usr/local/etc/php-fpm.conf

# vi /usr/local/etc/php-fpm.conf

Find these two lines. Remove the Comments (arrows)

<!–  <value name=”user”>nobody</value>         –>
<!–  <value name=”group”>nobody</value>      –>

If you don’t do this, starting php-fpm will show this error.

fpm_unix_conf_wp(), line 124: please specify user and group othe

– Go to nginx configuration file: “/usr/local/nginx/conf/nginx.conf” , and add the php configuration

location ~ \.php$ {
root /usr/share/nginx/html; # itmena the root of the coument are located on /usr/share/nginx/html
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME /usr/share/nginx/html$fastcgi_script_name;
include fastcgi_params;
}

to make index.php to be your web default page add index.php on

location / {
root /usr/share/nginx/html;
index index.php index.html index.htm;
}

– Go to /usr/share/nginx/html and create php files

# mkdir -p /usr/share/nginx/html
# vi index.php
<?php  phpinfo();  ?>

9. Start the nginx and php-fpm
# /etc/init.d/php-fpm start

# /etc/init.d/nginx start

10. You should go to your domain http://localhost/index.php or server address and see the phpinfo