Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

runapp(3pm) [debian man page]

RunApp(3pm)						User Contributed Perl Documentation					       RunApp(3pm)

NAME

       RunApp - A generic module to run web-applications

SYNOPSIS

	use RunApp '-chdir';

	use RunApp;
	use RunApp::Apache;

	my $cmd = shift || 'development';
	my $config = { var => 'value', app_apache => { var_for_apache => 'value'} };
	RunApp->new (app_apache => RunApp::Apache->new
			   (root => catfile (cwd, $_),
			    httpd => '/path/to/httpd'),
		     my_daemon => RunApp::Control::AppControl->new
			   (binary => '/path/to/daemon',
			    args => ['--daemon'],
			    pidfile => '/path/to/daemon.pid',
			   )
			)->$cmd ($config);

DESCRIPTION

       "RunApp" streamlines the process for configuring applications that requires one or more web servers and/or other daemons, during develop-
       ment or deployment.

       It builds the config files required by the services from the $config hash, such as apache's httpd.conf.

OPTIONS

	use RunApp '-chdir';
	use RunApp qw(-chdir ..);

       This will cause the your script to "chdir" to the base directory.  If it's a symbolic link it will be resolved and you will be in the
       directory of where the original script is.  The "lib" directory will be added into @INC, and you can use the modules in that path.

       It also takes an optional relative path if want the script to chdir to somewhere else.

       This makes it possible for symlinking the your runapp script into system's rc.d startup directory.

CONSTRUCTOR

       new (@services)

       @services is actually an hash, with keys being the name of the service, and values being "RunApp::Control" objects.  Use an array instead
       of a hash here to retain the order of dispatching.

       The names are used to pick config from the hash, which will be flatten into top level of the config hash, when running "build" for the each
       service.

METHODS

       $self->development ($conf)

       Runs "build" and "start", and then waits for SIGINT to <stop> the servers.

AUTOLOAD

       All other methods are dispatched to the "RunApp::Control" objects in the order called in CONSTRUCTOR.  Note that this is done with
       RunApp::Control dispatching to the "dispatch" method.

SEE ALSO

       RunApp::Apache, RunApp::Control::AppControl, App::Control

AUTHORS

       Chia-liang Kao <clkao@clkao.org>

       Refactored from works by Leon Brocard <acme@astray.com> and Tom Insam <tinsam@fotango.com>.

COPYRIGHT

       Copyright (C) 2002-5, Fotango Ltd.

       This module is free software; you can redistribute it or modify it under the same terms as Perl itself.

perl v5.8.8							    2008-01-09							       RunApp(3pm)

Check Out this Related Man Page

Catalyst::Engine::Apache::MP13(3pm)			User Contributed Perl Documentation		       Catalyst::Engine::Apache::MP13(3pm)

NAME

       Catalyst::Engine::Apache::MP13 - Catalyst Apache mod_perl 1.3x Engine

SYNOPSIS

	   # Set up your Catalyst app as a mod_perl 1.3x application in httpd.conf
	   <Perl>
	       use lib qw( /var/www/MyApp/lib );
	   </Perl>

	   # Preload your entire application
	   PerlModule MyApp

	   <VirtualHost *>
	       ServerName   myapp.hostname.com
	       DocumentRoot /var/www/MyApp/root

	       <Location />
		   SetHandler	    perl-script
		   PerlHandler	    MyApp
	       </Location>

	       # you can also run your app in any non-root location
	       <Location /some/other/path>
		   SetHandler	   perl-script
		   PerlHandler	   MyApp
	       </Location>

	       # Make sure to let Apache handle your static files
	       # (And remember to remove the Static::Simple plugin in production)
	       <Location /static>
		   SetHandler	   default-handler
	       </Location>
	   </VirtualHost>

DESCRIPTION

       This is the Catalyst engine specialized for Apache mod_perl version 1.3x.

Apache::Registry
       While this method is not recommended, you can also run your Catalyst application via an Apache::Registry script.

       httpd.conf:

	   PerlModule Apache::Registry
	   Alias / /var/www/MyApp/script/myapp_registry.pl/

	   <Directory /var/www/MyApp/script>
	       Options +ExecCGI
	   </Directory>

	   <Location />
	       SetHandler  perl-script
	       PerlHandler Apache::Registry
	   </Location>

       script/myapp_registry.pl (you will need to create this):

	   #!/usr/bin/perl

	   use strict;
	   use warnings;
	   use MyApp;

	   MyApp->handle_request( Apache->request );

METHODS

   ok_constant
OVERLOADED METHODS

       This class overloads some methods from "Catalyst::Engine::Apache".

   $c->engine->finalize_headers
SEE ALSO

       Catalyst, Catalyst::Engine, Catalyst::Engine::Apache.

AUTHORS

       o   Sebastian Riedel <sri@cpan.org>

       o   Christian Hansen <ch@ngmedia.com>

       o   Andy Grundman <andy@hybridized.org>

       o   Tomas Doran <bobtfish@bobtfish.net>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2010 by The "AUTHORS".

       This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

perl v5.10.1							    2010-11-26				       Catalyst::Engine::Apache::MP13(3pm)
Man Page