Mod cgi » History » Revision 16
Revision 15 (stbuehler, 2009-10-25 19:19) → Revision 16/32 (rrt, 2012-03-23 23:08)
h1. The CGI-Module
*Module: mod_cgi*
{{>toc}}
h2. Description
CGI programs allow you to enhance the functionality of the server in a very straight-forward and simple way.
Note that to see stderr output from CGI processes, you need to set
<pre>
server.breakagelog = "/var/log/lighttpd/breakage.log"
</pre>
or similar.
h2. Options
*cgi.execute-x-only*
requires +x for cgi scripts if enabled.
*cgi.assign*
file-extensions that are handled by a CGI program
<pre>
cgi.assign = ( ".pl" => "/usr/bin/perl",
".cgi" => "/usr/bin/perl" )
</pre>
For PHP don't forget to set cgi.fix_pathinfo = 1 in the php.ini.
To get the old cgi-bin behavior of apache:
<pre>
#Note: make sure that mod_alias is loaded if you use this:
alias.url += ( "/cgi-bin" => server_root + "/cgi-bin" )
$HTTP["url"] =~ "^/cgi-bin" {
cgi.assign = ( "" => "" )
}
</pre>
*cgi.execute-all*
In 1.5.0 and later you can use:
<pre>
$PHYSICAL["existing-path"] =~ "^/var/www/myvhost/cgi-bin/" {
cgi.execute-all = "enable"
}
</pre>
which does the same thing as cgi.assign = ("" => "") but is more obvious to use.
h2. Examples
To setup an executable which can run on its own (e.g. binaries, scripts with a shebang line) you just don't specify a handler for the extension:
<pre>
cgi.assign = ( ".sh" => "" )
</pre>
If the file has no extension keep in mind that lighttpd matches not the extension itself but the right part of the URL:
<pre>
cgi.assign = ( "/testfile" => "" )
</pre>