[catagits/Catalyst-Manual.git] / lib / Catalyst / Manual / Deployment / FastCGI.pod

=head1 NAME

Catalyst::Manual::Deployment::FastCGI - Deploying Catalyst with FastCGI

=head1 FastCGI Deployment

FastCGI is a high-performance extension to CGI. It is suitable
for production environments.

=head2 Pros

=head3 Speed

FastCGI performs equally as well as mod_perl.  Don't let the 'CGI' fool you;
your app runs as multiple persistent processes ready to receive connections
from the web server.

=head3 App Server

When using external FastCGI servers, your application runs as a standalone
application server.  It may be restarted independently from the web server.
This allows for a more robust environment and faster reload times when
pushing new app changes.  The frontend server can even be configured to
display a friendly "down for maintenance" page while the application is
restarting.

=head3 Load-balancing

You can launch your application on multiple backend servers and allow the
frontend web server to load-balance between all of them.  And of course, if
one goes down, your app continues to run fine.

=head3 Multiple versions of the same app

Each FastCGI application is a separate process, so you can run different
versions of the same app on a single server.

=head3 Can run with threaded Apache

Since your app is not running inside of Apache, the faster mpm_worker module
can be used without worrying about the thread safety of your application.

=head2 Cons

You may have to disable mod_deflate.  If you experience page hangs with
mod_fastcgi then remove deflate.load and deflate.conf from mods-enabled/

=head3 More complex environment

With FastCGI, there are more things to monitor and more processes running
than when using mod_perl.

XXX - FIXME, note not just apache!

=head3 More Info

L<Catalyst::Engine::FastCGI> - XXX FIXME.

=head1 AUTHORS

Catalyst Contributors, see Catalyst.pm

=head1 COPYRIGHT

This library is free software. You can redistribute it and/or modify it under
the same terms as Perl itself.

=cut
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