Ticket #9251: ew-mythweb-lighty-20110118a.patch

INSTALL

@@ -199 +199 @@
     mythweb.conf.apache         (See section 5.0)
     mythweb.conf.lighttpd       (See section 6.0)
 
-Please do not use Lighttpd unless you know what you are doing.
-
 ==========
 5.0 Apache
 ==========
@@ -366 +364 @@
 6.0 Lighttpd
 ============
 
-Sorry, no documentation here yet...
+Configuring lighttpd for mythweb is straightforward and easy.
+
+1.  Copy the lighttpd config template file from your mythweb
+sources to your lighttpd configuration directory:
+
+# cp -vi ./mythweb.conf.lighttpd /etc/lighttpd/mythweb.conf.lighttpd
+
+Be sure to edit it for any particulars of your setup.
+
+2.  Edit your main lighttpd.conf file and add an include (with any
+path adjustments, depending on where you stored it):
+
+include "/etc/lighttpd/mythweb.conf.lighttpd"
+
+3.  For HTTP Digest authentication, create the credentials file (see
+the htdigest documentation for more detail):
+
+# htdigest -c /etc/lighttpd/mythweb.htdigest 'Authorized MythWebbers' tom
+
+4.  Set up a hostname that begins with "mythweb", pointing to an IP on
+which your lighttpd server is listening.
+
+4a.  For DNS: If you run your own DNS, add an "A" record for
+mythweb.whatever.
+
+4b.  For /etc/hosts: On all of your client browser machines, add
+something like the following to /etc/hosts:
+
+192.186.0.3     mythweb.local mythweb
+
+Be sure to substitute the IP address at which lighttpd is reachable,
+of course.  Also, take note that some systems are particular about the
+whitespace between the IP address and the hostname in /etc/hosts --
+sometimes it must consist of tab (^H) characters.
+
+Then...  Restart lighttpd and go!
+
+Assuming you set it up this way, simply direct your browser to
+http://mythweb.local/ and enjoy.
 
 =======
 7.0 PHP

mythweb.conf.lighttpd

@@ -1 +1 @@
 # This is a user supplied example file. Please modify before use
 
 # Apply mythweb configuration if hostname starts with mythtv
-$HTTP["host"] =~ "^mythtv" {
-    # Requiring authentication is a good idea if the server is publicly
-    # accessible.  On a private server this section can be safely removed.
-    auth.backend = "htdigest"
-    auth.backend.htdigest.userfile = "/path/to/htdigest"
-    auth.require = (
-        "/" => (
-            "method"  => "digest",
-            "realm"   => "MythTV",
-            "require" => "valid-user"
-        )
-    )
+$HTTP["host"] =~ "^mythweb" {
+
+  # You'll want to specify the document root, naturally.  Clone the
+  # git repo there for the easiest and best results.
+
+  server.document-root = "/var/www/localhost/htdocs/mythweb"
 
-    # Use fastcgi for the PHP parts
-    fastcgi.server = (
-        ".php" => ((
-            "bin-path" => "/usr/bin/php-cgi",
-            "socket"   => "/var/run/lighttpd/mythtv-php-fcgi.socket",
-            "broken-scriptfilename" => "enable",
-            "bin-environment" => (
-                "db_server"   => "agrajag",
-                "db_name"     => "mythconverg",
-                "db_login"    => "mythtv",
-                "db_password" => "mythtv"
-            )
-        ))
+  # Configure this section for HTTP Digest Authentication.  Be sure to
+  # set up the mythweb.htdigest file for your users according to the
+  # lighttpd documentation.
+
+  auth.backend = "htdigest"
+  auth.backend.htdigest.userfile = "/etc/lighttpd/mythweb.htdigest"
+  auth.require = (
+    "/" => (
+      "method"  => "digest",
+      "realm"   => "MythTV",
+      "require" => "valid-user"
     )
+  )
+
+  # Whether or not you're using fastcgi for PHP applications in
+  # general on your lighttpd server, this makes sure you are for
+  # mythweb.
 
-    # Environment variables for the Perl parts
-    setenv.add-environment = (
-        "db_server"   => "servername",
+  fastcgi.server = (
+    ".php" => ((
+      "bin-path" => "/usr/bin/php-cgi",
+      "socket"   => "/var/run/lighttpd/mythtv-php-fcgi.socket",
+      "broken-scriptfilename" => "enable",
+      "bin-environment" => (
+        "db_server"   => "localhost",
         "db_name"     => "mythconverg",
         "db_login"    => "mythtv",
-        "db_password" => "password"
-    )
+        "db_password" => "mythtv"
+      )
+    ))
+  )
 
-    cgi.assign = (
-        ".pl"  => "/usr/bin/perl"
-    )
+  # Credentials to pass along to the CGI scripts.  Be sure to
+  # configure the correct hostname, username, database name, and
+  # password for your MySQL server's MythTV setup.
 
-    url.rewrite-once = (
-        "^/(css|data|images|js|themes|skins|[a-z_]+\.(php|pl)).*" => "$0",
-        "^/(pl(/.*)?)$" => "/mythweb.pl/$1",
-        "^/(.+)$"       => "/mythweb.php/$1",
-        "^/(.*)$"       => "/mythweb.php"
-    )
+  setenv.add-environment = (
+    "db_server"   => "localhost",
+    "db_name"     => "mythconverg",
+    "db_login"    => "mythtv",
+    "db_password" => "mythtv"
+  )
+
+  # This makes sure that mythweb's perl files get run by the perl
+  # interpreter.
+
+  cgi.assign = (
+    ".pl"  => "/usr/bin/perl"
+  )
+
+  # The mythweb code relies on some URL rewriting.  This directive is
+  # required.
+
+  url.rewrite-once = (
+    "^/(css|data|images|js|themes|skins|[a-z_]+\.(php|pl)).*" => "$0",
+    "^/(pl(/.*)?)$" => "/mythweb.pl/$1",
+    "^/(.+)$"       => "/mythweb.php/$1",
+    "^/(.*)$"       => "/mythweb.php"
+  )
 }