Commit | Line | Data |
1d2376f3 |
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 |
8 | for production environments. |
9 | |
10 | =head2 Pros |
11 | |
12 | =head3 Speed |
13 | |
14 | FastCGI performs equally as well as mod_perl. Don't let the 'CGI' fool you; |
15 | your app runs as multiple persistent processes ready to receive connections |
16 | from the web server. |
17 | |
18 | =head3 App Server |
19 | |
20 | When using external FastCGI servers, your application runs as a standalone |
21 | application server. It may be restarted independently from the web server. |
22 | This allows for a more robust environment and faster reload times when |
23 | pushing new app changes. The frontend server can even be configured to |
24 | display a friendly "down for maintenance" page while the application is |
25 | restarting. |
26 | |
27 | =head3 Load-balancing |
28 | |
29 | You can launch your application on multiple backend servers and allow the |
30 | frontend web server to load-balance between all of them. And of course, if |
31 | one goes down, your app continues to run fine. |
32 | |
33 | =head3 Multiple versions of the same app |
34 | |
35 | Each FastCGI application is a separate process, so you can run different |
36 | versions of the same app on a single server. |
37 | |
38 | =head3 Can run with threaded Apache |
39 | |
40 | Since your app is not running inside of Apache, the faster mpm_worker module |
41 | can be used without worrying about the thread safety of your application. |
42 | |
43 | =head2 Cons |
44 | |
45 | You may have to disable mod_deflate. If you experience page hangs with |
46 | mod_fastcgi then remove deflate.load and deflate.conf from mods-enabled/ |
47 | |
48 | =head3 More complex environment |
49 | |
50 | With FastCGI, there are more things to monitor and more processes running |
51 | than when using mod_perl. |
52 | |
53 | XXX - FIXME, note not just apache! |
54 | |
55 | =head3 More Info |
56 | |
57 | L<Catalyst::Engine::FastCGI> - XXX FIXME. |
58 | |
59 | =head1 AUTHORS |
60 | |
61 | Catalyst Contributors, see Catalyst.pm |
62 | |
63 | =head1 COPYRIGHT |
64 | |
65 | This library is free software. You can redistribute it and/or modify it under |
66 | the same terms as Perl itself. |
67 | |
68 | =cut |
69 | |