Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

module::install::catalyst(3pm) [debian man page]

Module::Install::Catalyst(3pm)				User Contributed Perl Documentation			    Module::Install::Catalyst(3pm)

NAME

	 Module::Install::Catalyst - Module::Install extension for Catalyst

SYNOPSIS

	 use inc::Module::Install;

	 name 'MyApp';
	 all_from 'lib/MyApp.pm';

	 requires 'Catalyst::Runtime' => '5.7014';

	 catalyst_ignore('.*temp');
	 catalyst_ignore('.*tmp');
	 catalyst;
	 WriteAll;

DESCRIPTION

       Module::Install extension for Catalyst.

METHODS

   catalyst
       Calls catalyst_files and catalyst_par. Should be the last catalyst* command called in "Makefile.PL".

   catalyst_files
       Collect a list of all files a Catalyst application consists of and copy it inside the blib/lib/ directory. Files and directories that match
       the modules ignore list are excluded (see catalyst_ignore and catalyst_ignore_all).

   catalyst_ignore_all(@ignore)
       This function replaces the built-in default ignore list with the given list.

   catalyst_ignore(@ignore)
       Add a regexp to the list of ignored patterns. Can be called multiple times.

   catalyst_par($name)
   catalyst_par_core($core)
   catalyst_par_classes(@clases)
   catalyst_par_engine($engine)
   catalyst_par_multiarch($multiarch)
   catalyst_par_options($optstring)
       This command can be used in Makefile.PL to customise the PAR creation process.  The parameter "$optstring" contains a string with arguments
       in identical syntax as arguments of pp command from PAR::Packer package.

       Example:

	   # part of your Makefile.PL

	   catalyst_par_options("--verbose=2 -f Bleach -z 9");
	   # verbose mode; use filter 'Bleach'; zip with compression level 9
	   catalyst;

       Note1: There is no reason to use catalyst_par_options() command multiple times as you can spacify in "$optstring" as many options as you
       want. Still, it is supported to call catalyst_par_options() more than once. In that case the specified options are merged (collisions are
       handled on principle "later wins").  BEWARE: you are discouraged from using parameters -a -A -X -f -F -I -l -M in multiple
       catalyst_par_options() as they are not merged but replaced as you would expected.

       Note2: By default the options "-x -p -o=<appname>.par" are set and option "-n" is unset. This default always overrides whatever you specify
       by catalyst_par_options().

   catalyst_par_script($script)
   catalyst_par_usage($usage)
AUTHORS

       Catalyst Contributors, see Catalyst.pm

LICENSE

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

perl v5.14.2							    2011-08-16					    Module::Install::Catalyst(3pm)

Check Out this Related 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)
Man Page