catalyst::manual::deployment::sharedhosting(3pm) [debian man page]

Catalyst::Manual::Deployment::SharedHosting(3pm)	User Contributed Perl Documentation	  Catalyst::Manual::Deployment::SharedHosting(3pm)

NAME

       Catalyst::Manual::Deployment::SharedHosting - Deploying Catalyst on Shared Hosting

Catalyst on shared hosting
       So, you want to put your Catalyst application out there for the whole world to see, but you don't want to break the bank. There is an
       answer - if you can get shared hosting with FastCGI and a shell, you can install your Catalyst app in a local directory on your shared
       host. First, run

	   perl -MCPAN -e shell

       and go through the standard CPAN configuration process. Then exit without installing anything. Next, download the latest local::lib package
       and follow its 'bootstrap' instructions to get it installed and the local configuration added to your "~/.bashrc".

       Now log out, then back in again (or run ". .bashrc" if you prefer).

       Now you can install the modules you need using CPAN as normal; they will be installed into your local directory, and Perl will pick them
       up.  Finally, change into the root directory of your virtual host, and symlink your application's script directory:

	   cd path/to/mydomain.com
	   ln -s ~/lib/MyApp/script script

       And add the following lines to your .htaccess file (assuming the server is setup to handle .pl as fcgi - you may need to rename the script
       to myapp_fastcgi.fcgi and/or use a SetHandler directive):

	 RewriteEngine On
	 RewriteCond %{REQUEST_URI} !^/?script/myapp_fastcgi.pl
	 RewriteRule ^(.*)$ script/myapp_fastcgi.pl/$1 [PT,L]

       Now "http://mydomain.com/" should now Just Work. Congratulations, now you can tell your friends about your new website.

AUTHORS

       Catalyst Contributors, see Catalyst.pm

COPYRIGHT

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

perl v5.14.2							    2012-01-20			  Catalyst::Manual::Deployment::SharedHosting(3pm)

Catalyst::Manual::Deployment::lighttpd::FastCGI(3pm)	User Contributed Perl Documentation   Catalyst::Manual::Deployment::lighttpd::FastCGI(3pm)

NAME

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

Lighttpd
       These configurations were tested with Lighttpd 1.4.7.

   Standalone server mode
	   server.document-root = "/var/www/MyApp/root"

	   fastcgi.server = (
	       "" => (
		   "MyApp" => (
		       "socket"      => "/tmp/myapp.socket",
		       "check-local" => "disable"
		   )
	       )
	   )

   Static mode
	   server.document-root = "/var/www/MyApp/root"

	   fastcgi.server = (
	       "" => (
		   "MyApp" => (
		       "socket"       => "/tmp/myapp.socket",
		       "check-local"  => "disable",
		       "bin-path"     => "/var/www/MyApp/script/myapp_fastcgi.pl",
		       "min-procs"    => 2,
		       "max-procs"    => 5,
		       "idle-timeout" => 20
		   )
	       )
	   )

       Note that in newer versions of lighttpd, the min-procs and idle-timeout values are disabled.  The above example would start 5 processes.

   Non-root configuration
       You can also run your application at any non-root location with either of the above modes.  Note the required mod_rewrite rule.

	   url.rewrite = ( "myapp$" => "myapp/" )
	   fastcgi.server = (
	       "/myapp" => (
		   "MyApp" => (
		       # same as above
		   )
	       )
	   )

       For more information on using FastCGI under Lighttpd, visit <http://www.lighttpd.net/documentation/fastcgi.html>

   Static file handling
       Static files can be served directly by lighttpd for a performance boost.

	  $HTTP["url"] !~ "^/(?:img/|static/|css/|favicon.ico$)" {
		fastcgi.server = (
		    "" => (
			"MyApp" => (
			    "socket"	   => "/tmp/myapp.socket",
			    "check-local"  => "disable",
			)
		    )
		)
	   }

       This will serve everything in the "img", "static", and "css" directories statically, as well as the favicon file.

AUTHORS

       Catalyst Contributors, see Catalyst.pm

COPYRIGHT

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

perl v5.14.2							    2012-01-20		      Catalyst::Manual::Deployment::lighttpd::FastCGI(3pm)