lib/Catalyst/Manual/Deployment/FastCGI.pod

   1 =head1 NAME
   2
   3 Catalyst::Manual::Deployment::FastCGI - Deploying Catalyst with FastCGI
   4
   5 =head1 FastCGI Deployment
   6
   7 FastCGI is a high-performance extension to CGI. It is suitable for production
   8 environments, and is the standard method for deploying Catalyst in shared
   9 hosting environments.
  10
  11 =head2 Pros
  12
  13 =head3 Speed
  14
  15 FastCGI performs equally as well as mod_perl.  Don't let the 'CGI' fool you;
  16 your app runs as multiple persistent processes ready to receive connections
  17 from the web server.
  18
  19 =head3 App Server
  20
  21 When using external FastCGI servers, your application runs as a standalone
  22 application server.  It may be restarted independently from the web server.
  23 This allows for a more robust environment and faster reload times when
  24 pushing new app changes.  The frontend server can even be configured to
  25 display a friendly "down for maintenance" page while the application is
  26 restarting.
  27
  28 =head3 Load-balancing
  29
  30 You can launch your application on multiple backend servers and allow
  31 the frontend web server to perform load-balancing among all of them. And
  32 of course, if one goes down, your app continues to run.
  33
  34 =head3 Multiple versions of the same app
  35
  36 Each FastCGI application is a separate process, so you can run different
  37 versions of the same app on a single server.
  38
  39 =head3 Can run with threaded Apache
  40
  41 Since your app is not running inside of Apache, the faster mpm_worker module
  42 can be used without worrying about the thread safety of your application.
  43
  44 =head3 Widely supported.
  45
  46 FastCGI is compatible with many server implementations, not just Apache.
  47
  48 =head2 Cons
  49
  50 You may have to disable mod_deflate.  If you experience page hangs with
  51 mod_fastcgi then remove deflate.load and deflate.conf from mods-enabled/
  52
  53 =head3 More complex environment
  54
  55 With FastCGI, there are more things to monitor and more processes running
  56 than when using mod_perl.
  57
  58 =head2 Standalone FastCGI Server
  59
  60 In server mode the application runs as a standalone server and accepts
  61 connections from a web server.  The application can be on the same machine as
  62 the web server, on a remote machine, or even on multiple remote machines.
  63 Advantages of this method include running the Catalyst application as a
  64 different user than the web server, and the ability to set up a scalable
  65 server farm.
  66
  67 To start your application in server mode, install the FCGI::ProcManager
  68 module and then use the included fastcgi.pl script.
  69
  70     $ script/myapp_fastcgi.pl -l /tmp/myapp.socket -n 5
  71
  72 Command line options for fastcgi.pl include:
  73
  74     -d -daemon     Daemonize the server.
  75     -p -pidfile    Write a pidfile with the pid of the process manager.
  76     -l -listen     Listen on a socket path, hostname:port, or :port.
  77     -n -nproc      The number of processes started to handle requests.
  78
  79 See below for the specific web server configurations for using the external
  80 server.
  81
  82 =head1 WEB SERVERS
  83
  84 Any web server which supports FastCGI should work with Catalyst. Configuration
  85 recipes for well-known web servers are linked below, and we would welcome
  86 contributions from people deploying Catalyst on other web servers.
  87
  88 =head2 Apache
  89
  90 L<Catalyst::Manual::Deployment::Apache::FastCGI>
  91
  92 =head2 nginx
  93
  94 L<Catalyst::Manual::Deployment::nginx::FastCGI>
  95
  96 =head2 lighttpd
  97
  98 L<Catalyst::Manual::Deployment::lighttpd::FastCGI>
  99
 100 =head2 Microsoft IIS
 101
 102 L<Catalyst::Manual::Deployment::IIS::FastCGI>
 103
 104 =head1 AUTHORS
 105
 106 Catalyst Contributors, see Catalyst.pm
 107
 108 =head1 COPYRIGHT
 109
 110 This library is free software. You can redistribute it and/or modify it under
 111 the same terms as Perl itself.
 112
 113 =cut
 114