network/mod_fcgid: Initial import

1 files changed, 53 insertions, 0 deletions

diff --git a/network/mod_fcgid/README b/network/mod_fcgid/README
new file mode 100644
index 0000000000..fb10cb9040
--- /dev/null
+++ b/network/mod_fcgid/README
@@ -0,0 +1,53 @@
+mod_fcgid is alternative FastCGI module for apache 2.x
+(note that "old and proven" mod_fastcgi doesn't work at all with apache 2.2)
+
+With mod_fcgid apache controls spawned FastCGI processes (as oposed to "external"
+FastCGI servers).
+
+Some features:
+  - Binary compatibility to mod_fastcgi
+  - Strict control on process spawn
+  - Simple spawning-speed control strategy
+  - Fastcgi server error detection
+
+Before running this script, you must have apache2 installed.
+Download and build apache2 build script from http://slackbuilds.org
+
+To use it, add the following line to your httpd.conf file:
+  Include /etc/apache2/extra/httpd-fcgid.conf
+
+Sample SuEXEC php wrapper script:
+  #!/bin/sh
+  #
+  # sample PHP FastCGI wrapper
+  PHPRC="/etc"    # directory which contains php.ini
+  PHP_FCGI_CHILDREN=4
+  PHP_FCGI_MAX_REQUESTS=250
+  export PHPRC PHP_FCGI_CHILDREN PHP_FCGI_MAX_REQUESTS
+  exec /usr/bin/php-cgi
+
+and apropriate vhost config:
+
+  # VirtualHost with SuExec and FastCGI PHP
+  <VirtualHost *:80>
+      # note: apache user should be member of 'vhost_group'
+      SuexecUserGroup vhost_user vhost_group
+
+      ServerAdmin webmaster@vhost.example.com
+      DocumentRoot /var/www/vhosts/vhost.example.com/htdocs
+      ServerName vhost.example.com
+      ServerAlias www.vhost.example.com
+      ErrorLog /var/log/apache2/vhost.example.com-error_log
+      CustomLog /var/log/apache2/vhost.example.com-access_log common
+    
+      # note: chmod /var/www/vhosts/vhost.example.com to 0750
+      <Directory /var/www/vhosts/vhost.example.com/htdocs>
+          Options ExecCGI
+          FCGIWrapper /var/www/vhosts/vhost.example.com/cgi-bin/php-wrapper .php
+          DirectoryIndex index.html index.php
+
+          AllowOverride None
+          Order allow,deny
+          Allow from all
+      </Directory>
+  </VirtualHost>