Jensens Süppchen

Using zc.buildout for administrative tasks can be fun. On a Debian Lenny we have a well maintained php5. I want to run some legacy php apps with it using nginx and spawnfcgi (both used from sources here). Now I wire all together in this buildout. filesystem structure is:

/opt/myapp/bootstrap.py
/opt/myapp/buildout.cfg
/opt/myapp/phpctl.in
/opt/myapp/nginx.conf.in
/opt/myapp/htdocs

buildout.cfg looks like so - adapt values for address and port as needed:
----------------------------------------------------------------------------------------------
[buildout]
parts = mkdirs nginx nginx-cfg spawnfcgi phpctl

[mkdirs]
recipe = z3c.recipe.mkdir
paths =
    ${buildout:directory}/var

[nginx]
# this build needs (on debian based systems):
# sudo apt-get install libpcre3-dev
recipe = zc.recipe.cmmi
url = http://sysoev.ru/nginx/nginx-0.7.67.tar.gz

[nginx-cfg]
recipe = collective.recipe.template
address = 10.1.2.52
port = 30000
input = ${buildout:directory}/nginx.conf.in
output = ${nginx:location}/conf/nginx.conf

[spawnfcgi]
recipe = zc.recipe.cmmi
url = http://www.lighttpd.net/download/spawn-fcgi-1.6.3.tar.gz

[phpctl]
recipe = collective.recipe.template
mode = 755
port = 30001
input = ${buildout:directory}/phpctl.in
output = ${buildout:directory}/bin/phpctl
----------------------------------------------------------------------------------------------

phpctl.in looks like so:
----------------------------------------------------------------------------------------------


#!/bin/sh

# Specify path variable
PATH=/sbin:/usr/sbin:/bin:/usr/bin

# Kill me on all errors
set -e

# define binaries
NGINX=${nginx:location}/sbin/nginx
SPAWNFCGI=${spawnfcgi:location}/bin/spawn-fcgi
PHPCGI=/usr/bin/php-cgi

case "$1" in
  start)
    $NGINX
    $SPAWNFCGI -p ${phpctl:port} -- $PHPCGI\
       | sed 's/.*PID:\(.*\)$/\1/' \
       > ${buildout:directory}/var/phpcgi.pid
    ;;
  stop)
    kill `cat ${nginx:location}/logs/nginx.pid`
    kill `cat ${buildout:directory}/var/phpcgi.pid`
    rm ${buildout:directory}/var/phpcgi.pid
    ;;   
  *)
    echo "Usage: $0 {start|stop}"
    exit 1
    ;;
esac
----------------------------------------------------------------------------------------------

nginx.conf.in looks like so:
----------------------------------------------------------------------------------------------
events {
    worker_connections  1024;
}
http {
    include       mime.types;
    default_type  application/octet-stream;
    sendfile        on;
    keepalive_timeout  65;
    server {
        listen ${:address}:${:port} default;
        server_name  localhost;
        error_page   500 502 503 504  /50x.html;
        location = /50x.html {
            root   html;
        }
        location ~ .php$ {
                fastcgi_pass  127.0.0.1:${phpctl:port};
                fastcgi_index index.php;
                fastcgi_param SCRIPT_FILENAME  ${buildout:directory}/htdocs/$fastcgi_script_name;
                fastcgi_param QUERY_STRING     $query_string;
                fastcgi_param REQUEST_METHOD   $request_method;
                fastcgi_param CONTENT_TYPE     $content_type;
                fastcgi_param CONTENT_LENGTH   $content_length;              
                fastcgi_param SCRIPT_NAME      $fastcgi_script_name;
                fastcgi_param REQUEST_URI      $request_uri;
                fastcgi_param DOCUMENT_URI     $document_uri;
                fastcgi_param DOCUMENT_ROOT    $document_root;
                fastcgi_param SERVER_PROTOCOL  $server_protocol;               
                fastcgi_param GATEWAY_INTERFACE CGI/1.1;
                fastcgi_param REMOTE_ADDR      $remote_addr;
                fastcgi_param REMOTE_PORT      $remote_port;
                fastcgi_param SERVER_ADDR      $server_addr;
                fastcgi_param SERVER_PORT      $server_port;
                fastcgi_param SERVER_NAME      $server_name;      
                fastcgi_read_timeout           300;        
        }
        location / {
                root ${buildout:directory}/htdocs;
                index  index.php;
        }
    }
}
----------------------------------------------------------------------------------------------

And do not forget to put your php app under htdocs.

fetch packages with apt (you may need more, i had already installed some stuff before):
$ sudo apt-get install build-essential libpcre3-dev libssl-dev

fetch bootstrap.py from http://python-distribute.org/bootstrap.py
$ wget http://python-distribute.org/bootstrap.py


bootstrap and run your buildout:
$ cd /opt/myapp
$ python bootstrap.py
$ ./bin/buildout

then start your php app:
$ ./bin/phpctl start

take your browser and load http::/YOURADDRESS:YOURNGINXPORT

finally you can stop it with
$ ./bin/phpctl stop