mod_fastcgi

manifests/mod/fastcgi.pp

@@ -0,0 +1,20 @@
+class apache::mod::fastcgi {
+
+  # Debian specifies it's fastcgi lib path, but RedHat uses the default value
+  # with no config file
+  $fastcgi_lib_path = $apache::params::fastcgi_lib_path
+
+  apache::mod { 'fastcgi': }
+
+  if $fastcgi_lib_path {
+    file { 'fastcgi.conf':
+      ensure  => file,
+      path    => "${apache::mod_dir}/fastcgi.conf",
+      content => template('apache/mod/fastcgi.conf.erb'),
+      require => Exec["mkdir ${apache::mod_dir}"],
+      before  => File[$apache::mod_dir],
+      notify  => Service['httpd'],
+    }
+  }
+
+}

manifests/params.pp

@@ -57,6 +57,7 @@
     $suphp_configpath     = undef
     $mod_packages         = {
       'auth_kerb'  => 'mod_auth_kerb',
+      'fastcgi'    => 'mod_fastcgi',
       'fcgid'      => 'mod_fcgid',
       'passenger'  => 'mod_passenger',
       'perl'       => 'mod_perl',
@@ -79,6 +80,7 @@
     $conf_template        = 'apache/httpd.conf.erb'
     $keepalive            = 'Off'
     $keepalive_timeout    = 15
+    $fastcgi_lib_path     = undef
   } elsif $::osfamily == 'Debian' {
     $user             = 'www-data'
     $group            = 'www-data'
@@ -106,6 +108,7 @@
     $suphp_configpath  = '/etc/php5/apache2'
     $mod_packages     = {
       'auth_kerb'  => 'libapache2-mod-auth-kerb',
+      'fastcgi'    => 'libapache2-mod-fastcgi',
       'fcgid'      => 'libapache2-mod-fcgid',
       'passenger'  => 'libapache2-mod-passenger',
       'perl'       => 'libapache2-mod-perl2',
@@ -123,6 +126,7 @@
     $conf_template     = 'apache/httpd.conf.erb'
     $keepalive         = 'Off'
     $keepalive_timeout = 15
+    $fastcgi_lib_path  = '/var/lib/apache2/fastcgi'
   } else {
     fail("Class['apache::params']: Unsupported osfamily: ${::osfamily}")
   }

manifests/vhost.pp

@@ -123,7 +123,10 @@
     $wsgi_process_group          = undef,
     $wsgi_script_aliases         = undef,
     $custom_fragment             = undef,
-    $itk                         = undef
+    $itk                         = undef,
+    $fastcgi_server              = undef,
+    $fastcgi_socket              = undef,
+    $fastcgi_dir                 = undef,
   ) {
   # The base class must be included first because it is used by parameter defaults
   if ! defined(Class['apache']) {
@@ -296,6 +299,13 @@
     }
   }
 
+  # Load mod_fastci if needed and not yet loaded
+  if $fastcgi_server and $fastcgi_socket {
+    if ! defined(Class['apache::mod::fastcgi']) {
+      include apache::mod::fastcgi
+    }
+  }
+
   # Configure the defaultness of a vhost
   if $priority {
     $priority_real = $priority

spec/classes/mod/fastcgi_spec.rb

@@ -0,0 +1,32 @@
+describe 'apache::mod::fastcgi', :type => :class do
+  let :pre_condition do
+    'include apache'
+  end
+  context "on a Debian OS" do
+    let :facts do
+      {
+        :osfamily               => 'Debian',
+        :operatingsystemrelease => '6',
+        :concat_basedir         => '/dne',
+      }
+    end
+    it { should include_class("apache::params") }
+    it { should contain_apache__mod('fastcgi') }
+    it { should contain_package("libapache2-mod-fastcgi") }
+    it { should contain_file('fastcgi.conf') }
+  end
+
+  context "on a RedHat OS" do
+    let :facts do
+      {
+        :osfamily               => 'RedHat',
+        :operatingsystemrelease => '6',
+        :concat_basedir         => '/dne',
+      }
+    end
+    it { should include_class("apache::params") }
+    it { should contain_apache__mod('fastcgi') }
+    it { should contain_package("mod_fastcgi") }
+    it { should_not contain_file('fastcgi.conf') }
+  end
+end

templates/mod/fastcgi.conf.erb

@@ -0,0 +1,6 @@
+# The Fastcgi Apache module configuration file is being
+# managed by Puppet and changes will be overwritten.
+<IfModule mod_fastcgi.c>
+  AddHandler fastcgi-script .fcgi
+  FastCgiIpcDir <%= @fastcgi_lib_path %>
+</IfModule>

templates/vhost.conf.erb

@@ -48,4 +48,5 @@
 <%= scope.function_template(['apache/vhost/_requestheader.erb']) -%>
 <%= scope.function_template(['apache/vhost/_wsgi.erb']) -%>
 <%= scope.function_template(['apache/vhost/_custom_fragment.erb']) -%>
+<%= scope.function_template(['apache/vhost/_fastcgi.erb']) -%>
 </VirtualHost>

templates/vhost/_fastcgi.erb

@@ -0,0 +1,19 @@
+<% if @fastcgi_server -%>
+
+  FastCgiExternalServer <%= @fastcgi_server -%> -socket <%= @fastcgi_socket -%>
+<% end -%>
+
+<% if @fastcgi_dir -%>
+
+  <Directory <%= @fastcgi_dir -%>> 
+    Options +ExecCGI
+    AllowOverride All
+    SetHandler fastcgi-script
+    Order allow,deny
+    Allow from all
+    AuthBasicAuthoritative Off
+  </Directory>
+
+  AllowEncodedSlashes On
+  ServerSignature Off
+<% end -%>