Manual:Installing MediaWiki with Lighttpd

From MediaWiki.org

The content of this page has not been verified. Instructions written in this page have not been verified to be correct. If there are any inaccuracies, please drop a note at the support desk.

Installation guides
on FreeBSD
on GNU/Linux
- ALT Linux
- Damnsmalllinux
- Debian
- Fedora
- Gentoo
- Mandriva
- Red Hat Enterprise Linux
- Slackware
- SuSE 9.3
- Ubuntu
on Mac OS X
on NetWare
on Solaris
- on Solaris 10
- on Solaris 9
on Windows
- Windows XP
- Windows Vista
- Windows Server 2000
- Windows Server 2003
- Newcomers guide
- Streamlined Guide
- Simple Windows/Apache Guide
- on a stick
- on WOS Portable
- on Uniform Server
- on Sourceforge.net

This page presents step-by-step instructions for installing MediaWiki with Lighttpd and PHP+FastCGI. We will assume you have MySQL installed already.

• Download Lighttpd
• Download PHP
• gzip -dc lighttpd-1.3.14.tar.gz | tar xf -
• cd lighttpd-1.3.14
• ./configure --prefix=/opt/lighttpd
• make all install
• cp doc/lighttpd.conf /etc/
• cd ..
• gzip -dc php-5.0.4.tar.gz | tar xf -
• cd php-5.0.4
• ./configure --enable-fastcgi --with-mysql=<path to MySQL installation> --prefix=/opt/php-fcgi
• make all install
• Edit /etc/lighttpd.conf as appropriate. You will need to add at least the following lines:

fastcgi.server = ( ".php" =>
                   ( "localhost" =>
                     (
                       "host" => "127.0.0.1",
                       "port" => 1026,
                       "bin-path" => "/opt/php-fcgi/bin/php-cgi"
                     )
                   )
                )

url.rewrite-once = (
                     "^/wiki/upload/(.+)" => "/wiki/upload/$1",
                     "^/$" => "/w/index.php",
                     "^/wiki/([^?]*)(?:\?(.*))?" => "/w/index.php?title=$1&$2"
                   )

If you use the static-file module, it will try to cache everything it can... including the PHP modules that are supposed to be executed instead. So in many cases you'll also need to add:

  static-file.exclude-extensions = ( ".php", ".pl", ".fcgi" )

or at least:

  static-file.exclude-extensions = ( ".php" )

And if you also want to support "http://yoursite/ArticleName" URLs:

url.redirect = ( "^/(?!w|wiki|robots\.txt|favicon\.ico)(.*)" => "/wiki/$1" )

Ensure the "rewrite", "redirect" and "fastcgi" modules are enabled.

• Extract the MediaWiki source into your document root, and mv mediawiki-1.5beta1 w
• Start lighttpd: /opt/lighttpd/sbin/lighttpd -f /etc/lighttpd.conf
• Visit "http://www.yoursite.com/w/config/index.php" and configure MediaWiki as documented at Manual:Installation guide
• Edit LocalSettings.php and change $wgArticlePath to:

$wgArticlePath = "/wiki/$1";

• Done!