nginx_simplecgi cookbook

(opens in a new tab) (opens in a new tab) (opens in a new tab)

This cookbook provides CGI support for NGINX via SimpleCGI.

Maintainers

This cookbook is maintained by the Sous Chefs. The Sous Chefs are a community of Chef cookbook maintainers working together to maintain important cookbooks. If you’d like to know more please visit sous-chefs.org (opens in a new tab) or come chat with us on the Chef Community Slack in #sous-chefs (opens in a new tab).

Requirements

Platforms

Debian/ Ubuntu
RHEL based platforms (CentOS, Redhat, etc)

Chef

Chef 12.19+

Cookbooks

nginx
perl
runit
yum-epel

Usage

Attributes

node['nginx_simplecgi']['cgi'] -> Enable CGI dispatch
node['nginx_simplecgi']['php'] -> Enable PHP dispatch
node['nginx_simplecgi']['php_cgi_bin'] -> PHP executable path for CGI
node['nginx_simplecgi']['init_type'] -> Init style for dispatchers
node['nginx_simplecgi']['dispatcher_directory'] -> Directory to contain socket and pid files
node['nginx_simplecgi']['dispatcher_processes'] -> Number of dispatcher processes for handling requests

Template Helper

A template method helper, dispatch is provided to add the require location block into your nginx configuration files:

<%= nginx_dispatch(:cgi) %>

The default call will output:

  location ~ ^/cgi-bin/.*\.cgi$ {
    gzip off;
    fastcgi_pass  unix:/var/run/nginx/cgiwrap-dispatch.sock;
    fastcgi_index index.cgi;
    fastcgi_param SCRIPT_FILENAME /usr/lib$fastcgi_script_name;
    fastcgi_param QUERY_STRING     $query_string;
    fastcgi_param REQUEST_METHOD   $request_method;
    fastcgi_param CONTENT_TYPE     $content_type;
    fastcgi_param CONTENT_LENGTH   $content_length;
    fastcgi_param GATEWAY_INTERFACE  CGI/1.1;
    fastcgi_param SERVER_SOFTWARE    nginx;
    fastcgi_param SCRIPT_NAME        $fastcgi_script_name;
    fastcgi_param REQUEST_URI        $request_uri;
    fastcgi_param DOCUMENT_URI       $document_uri;
    fastcgi_param DOCUMENT_ROOT      $document_root;
    fastcgi_param SERVER_PROTOCOL    $server_protocol;
    fastcgi_param REMOTE_ADDR        $remote_addr;
    fastcgi_param REMOTE_PORT        $remote_port;
    fastcgi_param SERVER_ADDR        $server_addr;
    fastcgi_param SERVER_PORT        $server_port;
    fastcgi_param SERVER_NAME        $server_name;
  }

Available options:

:pattern -> change the pattern nginx matches
:cgi_bin_dir -> change the prefix directory of the local cgi-bin
:dispatcher -> use a custom dispatcher (socket or tcp based)
:custom -> string to be appended within the location block

The method will also accept a block that will be eval'd and the result appended within the location block.

Contributors

This project exists thanks to all the people who contribute. (opens in a new tab)

Backers

Thank you to all our backers!