summaryrefslogtreecommitdiffstats
path: root/network/lighttpd/README
blob: d8623f000f430ece80e6cfc3fbb03b1d46fa0268 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
lighttpd is a fast, secure, and flexible webserver. It is optimized
for high-performance environments, and provides an extensive feature 
set, including FastCGI, CGI, Auth, output compression, and URL
rewriting support.

By default, this package uses the "lighttpd" user and group to run
lighttpd as a unpriviliged process. The script will exit if these
do not exist on this machine.  We recommend using the following
UID and GID as they do not conflict with any stock Slackware users
and groups, nor with any added by other slackbuilds.org scripts.

    lighttpd
    ========
    User:  lighttpd         UID: 208        GID: 208
    Group: lighttpd                         GID: 208

After that, lighttpd can be started and stopped through the
initialization script that is provided:

/etc/rc.d/rc.lighttpd start
/etc/rc.d/rc.lighttpd stop

If you would like to start lighttpd automatically when the system
is booted, add the following lines to /etc/rc.d/rc.local:

    if [ -x /etc/rc.d/rc.lighttpd ]; then
      /etc/rc.d/rc.lighttpd start
    fi

Conversely, add the following lines to /etc/rc.d/rc.local_shutdown
to stop lighttpd on system shutdown.

    if [ -x /etc/rc.d/rc.lighttpd ]; then
      /etc/rc.d/rc.lighttpd stop
    fi

* PHP users:  
Slackware's default php package is meant to work with 
httpd(apache).  It works fine with lighttpd with a couple of tweaks.  

1) Copy the php.ini from /etc/httpd to /etc/lighttpd

2) Uncomment mod_fastcgi from the modules section of 
/etc/lighttpd/lighttpd.conf.

3) Rework the fastcgi section of /etc/lighttpd/lighttpd.conf to the 
following: (Or just copy this in below the extisting commented out
fastcgi config.)

fastcgi.server  = ( ".php" =>
                    ( "localhost" =>
                      (
                        "socket" => "/tmp/php-fastcgi.socket",
                        "bin-path" => "/usr/bin/php-cgi -c /etc/lighttpd/php.ini"
                      )
                    )
                 )

4) Change the group of /var/lib/php from "apache" to "lighttpd".
Otherwise php won't be able to use $_SESSION.