Lighttpd

= Lighttpd and PHP =
`Startingpoint` Lighttpd is already [wiki:TutorialInstallation installed and working]
PHP and FastCGI
First of all you need a PHP which is providing FastCGI support. Depending on your
distribution you might already have it: === ArchLinux ===
Read http://wiki.archlinux.org/index.php/Fastcgi_and_lighttpd === FreeBSD === {{{
$ cd /usr/ports/www/php-cgi
$ make install clean
}}} === Gentoo ===
Add the USE flag 'fastcgi' to compile php with fastcgi support. {{{
$ emerge php-cgi
}}} === Debian ===
Debian provides (at least in Sarge) a fastcgi enabled version - though it's called php4-cgi. {{{
$ apt-get install php4-cgi
}}}

=== Others ===
Download a source tar-ball from http://www.php.net/ and configure it with at least this settings: {{{
$ ./configure \
--enable-fastcgi \
--enable-discard-path \
--enable-force-redirect
}}}
If you want to have the same PHP as you are using in a mod_php configuration somewhere else call {{{

}}}

• copy the configure options from the output of the script
• remove the ``--with-apxs`` and ``--with-apxs2`` options
• add the three options from above.
  Build PHP now by callings ``make`` and ``make install`` and see if you can find a php binary which is responding: {{{
  $ php -v
  PHP 5.0.3 (cgi-fcgi) (built: Dec 21 2004 12:59:18)
  Copyright (c) 1997-2004 The PHP Group
  Zend Engine v2.0.3, Copyright (c) 1998-2004 Zend Technologies
  with eAccelerator v0.9.3, Copyright (c) 2004-2005 eAccelerator, by eAccelerator
  }}}
  or something like this. The ``(cgi-fcgi)`` is the important part. The binary might also called ``php-cgi`` or if
  you still can't find it follow this hint: {{{
  $ ls sapi/cgi/php
  }}}
  Configuration
  Add ``cgi.fix_pathinfo = 1`` to you ``php.ini`` and add this basic section to you ``lighttpd.conf``: {{{
  fastcgi.server = ( ".php" => ((
  "bin-path" => "/path/to/php-cgi",
  "socket" => "/tmp/php.socket",
  )))
  }}}
  A little bit more advance is this setting which tries the tune some more options. If you need PATH_INFO the broken-scriptfilename is
  for you. {{{
  fastcgi.server = ( ".php" => ((
  "bin-path" => "/path/to/php-cgi",
  "socket" => "/tmp/php.socket",
  "max-procs" => 2,
  "bin-environment" => (
  "PHP_FCGI_CHILDREN" => "16",
  "PHP_FCGI_MAX_REQUESTS" => "10000"
  ),
  "bin-copy-environment" => (
  "PATH", "SHELL", "USER"
  ),
  "broken-scriptfilename" => "enable"
  )))
  }}}

Please read the configuration section for more background * http://www.lighttpd.net/documentation/configuration.html * http://www.lighttpd.net/documentation/fastcgi.html
and use
http://trac.lighttpd.net/trac/file/branches/lighttpd-1.3.x/doc/lighttpd.conf
as starting point for the configuration.