Skip to content
Browse files

Fixed #15077 -- Clarified FastCGI documentation with regard to shared…

… hosting providers. Thanks, Horst Gutmann.

git-svn-id: bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
1 parent 0b58e46 commit 286e45e9ea2d2b64eb919fe91d923991d27a6dd6 @jezdez jezdez committed
Showing with 31 additions and 0 deletions.
  1. +31 −0 docs/howto/deployment/fastcgi.txt
31 docs/howto/deployment/fastcgi.txt
@@ -225,6 +225,23 @@ This is probably the most common case, if you're using Django's admin site:
Django will automatically use the pre-rewrite version of the URL when
constructing URLs with the ``{% url %}`` template tag (and similar methods).
+Using mod_fcgid as alternative to mod_fastcgi
+Another way to serve applications through FastCGI is by using Apache's
+`mod_fcgid`_ module. Compared to mod_fastcgi mod_fcgid handles FastCGI
+applications differently in that it manages the spawning of worker processes
+by itself and doesn't offer something like ``FastCGIExternalServer``. This
+means that the configuration looks slightly different.
+In effect, you have to go the way of adding a script handler similar to what
+is described later on regarding running Django in a :ref:`shared-hosting
+environment <apache_shared_hosting>`. For further details please refer to the
+`mod_fcgid reference`_
+.. _mod_fcgid:
+.. _mod_Fcgid reference:
lighttpd setup
@@ -306,6 +323,8 @@ The Cherokee project provides a documentation to `setting up Django`_ with Chero
.. _setting up Django:
+.. _apache_shared_hosting:
Running Django on a shared-hosting provider with Apache
@@ -349,6 +368,18 @@ be sure to make it executable:
from django.core.servers.fastcgi import runfastcgi
runfastcgi(method="threaded", daemonize="false")
+This works if your server uses mod_fastcgi. If, on the other hand, you are
+using mod_fcgid the setup is mostly the same except for a slight change in the
+``.htaccess`` file. Instead of adding a fastcgi-script handler, you have to
+add a fcgid-handler:
+.. code-block:: apache
+ AddHandler fcgid-script .fcgi
+ RewriteEngine On
+ RewriteCond %{REQUEST_FILENAME} !-f
+ RewriteRule ^(.*)$ mysite.fcgi/$1 [QSA,L]
Restarting the spawned server

0 comments on commit 286e45e

Please sign in to comment.
Something went wrong with that request. Please try again.