Rip the stuff out of Engine::FastCGI in master

[catagits/Catalyst-Manual.git] / lib / Catalyst / Manual / Deployment / lighttpd / FastCGI.pod

diff --git a/lib/Catalyst/Manual/Deployment/lighttpd/FastCGI.pod b/lib/Catalyst/Manual/Deployment/lighttpd/FastCGI.pod
index 002c1d9..a9ba089 100644 (file)
--- a/lib/Catalyst/Manual/Deployment/lighttpd/FastCGI.pod
+++ b/lib/Catalyst/Manual/Deployment/lighttpd/FastCGI.pod
@@ -2,6 +2,61 @@
 
 Catalyst::Manual::Deployment::lighttpd::FastCGI - Deploying Catalyst with lighttpd
 
+=head2 Lighttpd
+
+These configurations were tested with Lighttpd 1.4.7.
+
+=head3 Standalone server mode
+
+    server.document-root = "/var/www/MyApp/root"
+
+    fastcgi.server = (
+        "" => (
+            "MyApp" => (
+                "socket"      => "/tmp/myapp.socket",
+                "check-local" => "disable"
+            )
+        )
+    )
+
+=head3 Static mode
+
+    server.document-root = "/var/www/MyApp/root"
+
+    fastcgi.server = (
+        "" => (
+            "MyApp" => (
+                "socket"       => "/tmp/myapp.socket",
+                "check-local"  => "disable",
+                "bin-path"     => "/var/www/MyApp/script/myapp_fastcgi.pl",
+                "min-procs"    => 2,
+                "max-procs"    => 5,
+                "idle-timeout" => 20
+            )
+        )
+    )
+
+Note that in newer versions of lighttpd, the min-procs and idle-timeout
+values are disabled.  The above example would start 5 processes.
+
+=head3 Non-root configuration
+
+You can also run your application at any non-root location with either of the
+above modes.  Note the required mod_rewrite rule.
+
+    url.rewrite = ( "myapp\$" => "myapp/" )
+    fastcgi.server = (
+        "/myapp" => (
+            "MyApp" => (
+                # same as above
+            )
+        )
+    )
+
+For more information on using FastCGI under Lighttpd, visit
+L<http://www.lighttpd.net/documentation/fastcgi.html>
+
+
 =head4 Static file handling
 
 Static files can be served directly by lighttpd for a performance boost.
@@ -20,3 +75,13 @@ Static files can be served directly by lighttpd for a performance boost.
 Which serves everything in the img, static, css directories
 statically, as well as the favicon file.
 
+=head1 AUTHORS
+
+Catalyst Contributors, see Catalyst.pm
+
+=head1 COPYRIGHT
+
+This library is free software. You can redistribute it and/or modify it under
+the same terms as Perl itself.
+
+=cut
\ No newline at end of file