NAME
Ado::Command::generate::apache2vhost - Generates minimal Apache2 Virtual Host configuration file
SYNOPSIS
On the command-line:
$ bin/ado generate apache2vhost --ServerName example.com -s \
> etc/001-example.com.vhost.conf
Review your newly generated 001-example.com.vhost.conf
!!! Create link to your generated configuration.
# ln -siv /home/you/dev/Ado/etc/001-example.com.vhost.conf \
/etc/apache2/sites-enabled/001-example.com.vhost.conf
# service apache2 reload
Generate your .htaccess
file. Since you own the machine, you can put its content into the 001-example.com.vhost.conf
file.
$ bin/ado generate apache2htaccess --module fcgi \
>
$MOJO_HOME
/.htaccess
Programmatically:
my
$vhost
= Ado::Command::generate::apache2vhost->new;
$vhost
->run(
'--ServerName'
=>
'example.com'
,
'-p'
=> 8080);
DESCRIPTION
Ado::Command::generate::apache2vhost generates a minimal Apache2 Virtual Host configuration file for your Ado application.
This is a core command, that means it is always enabled and its code a good example for learning to build new commands, you're welcome to fork it.
OPTIONS
Below are the options this command accepts described in Getopt::Long notation.
n|ServerName=s
Fully Qualified Domain Name for the virtual host. Required! See also documentation for Apache2 directive ServerName.
p|port=i
Port on which this host will be served. Defaults to 80.
A|ServerAlias=s
Alias for ServerName. Defaults to 'www.'.$ServerName
. See also documentation for Apache2 directive ServerAlias.
a|ServerAdmin=s
Email of the administrator for this host - you. Defaults to webmaster@$ServerName. See also documentation for Apache2 directive ServerAdmin.
D|DocumentRoot=s
DocumentRoot for the virtual host. Defaults to $ENV{MOJO_HOME}
. See also documentation for Apache2 directive DocumentRoot.
c|config_file=s
Full path to the file in which the configuration will be written. If not provided the configuration is printed to the screen.
s|with_suexec
Adds SuexecUserGroup
directive which is effective only if mod_suexec
is loaded. The user and the group are guessed from the user running the command.
u|user=s
User to be used with suexec.
g|group=s
Group to be used with suexec.
v|verbose
Verbose output.
ATTRIBUTES
Ado::Command::generate::apache2vhostn inherits all attributes from Ado::Command::generate and implements the following new ones.
args
Used for storing arguments from the commandline and then passing them to the template
my
$args
=
$self
->args;
description
my
$description
=
$vhost
->description;
$v
=
$vhost
->description(
'Foo!'
);
Short description of this command, used for the command list.
env
Reference to %ENV
.
usage
my
$usage
=
$vhost
->usage;
$v
=
$vhost
->usage(
'Foo!'
);
Usage information for this command, used for the help screen.
METHODS
Ado::Command::generate::apache2vhost inherits all methods from Ado::Command::generate and implements the following new ones.
run
$vhost
->run(
@ARGV
);
Run this command. Returns $self
.
SEE ALSO
Apache deployment, Apache - Upgrading to 2.4 from 2.2, Mojolicious::Guides::Cookbook, Ado::Command::generate::apache2htaccess, Mojolicious::Command::generate, Getopt::Long, Ado::Command Ado::Manual, Mojolicious, "DEPLOYMENT" in Mojolicious::Guides::Cookbook