https://github.com/gandi/mod_fastcgi_handler
mod_fastcgi_handler
https://github.com/gandi/mod_fastcgi_handler
Last synced: about 1 month ago
JSON representation
mod_fastcgi_handler
- Host: GitHub
- URL: https://github.com/gandi/mod_fastcgi_handler
- Owner: Gandi
- License: other
- Created: 2014-12-15T14:50:09.000Z (over 11 years ago)
- Default Branch: gandi
- Last Pushed: 2015-12-03T10:32:17.000Z (over 10 years ago)
- Last Synced: 2025-01-15T01:41:41.241Z (over 1 year ago)
- Language: C
- Size: 879 KB
- Stars: 1
- Watchers: 32
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.rst
- License: LICENSE
Awesome Lists containing this project
README
===================
mod_fastcgi_handler
===================
:Author: `Benedikt Böhm `_
:Version: 0.6
:Web: http://github.com/hollow/mod_fastcgi_handler
:Git: ``git clone https://github.com/hollow/mod_fastcgi_handler.git``
:Download: http://github.com/hollow/mod_fastcgi_handler/downloads
mod_fastcgi_handler is a very simple FastCGI implementation derived from
mod_fastcgi and mod_proxy_fcgi. mod_fastcgi_handler does not implement a
process manager, nor does it support Authenticator and Authorizer roles.
mod_fastcgi_handler is a module for rapidly deploying FastCGI applications with
Apache.
Rationale
=========
mod_fastcgi and mod_fcgid both include a huge process manager code, which is
not needed with a typical FastCGI application. Such applications, including
Django and PHP-FPM, ship their own process manager and provide a socket to
communication with the web server. Thus a simple mechanism for talking to this
socket is required. While mod_fastcgi and mod_proxy_fcgi both provide such a
feature, the former has a quite complex configuration syntax while the latter
does not support unix domain sockets.
The solution is to provide simple handler for external FastCGI applications.
Installation
============
To compile and install this module, use ``apxs`` provided by the apache
webserver:
::
apxs -i -a -o mod_fastcgi_handler.so -c *.c
Configuration
=============
mod_fastcgi_handler provides a handler that can be activated by using the
``AddHandler`` and ``SetHandler`` directives. To use mod_fastcgi_handler with
PHP-FPM add the following option to your httpd.conf:
::
AddHandler fcgi:/var/run/php-fpm.socket .php
To use mod_fastcgi_handler with a Django FastCGI application running on port 3000:
::
SetHandler fcgi:127.0.0.1:3000
Bugs
====
mod_fastcgi_handler is beta-quality software. It has not been widely tested,
and some production-critical features, like non-blocking sockets and timeouts
have not yet been implemented.