NAME

Ado::Command::generate::apache2htaccess - Generates Apache2 .htaccess file

SYNOPSIS

  Usage:
  #on the command-line

  $ bin/ado generate apache2htaccess --modules cgi,fcgid > .htaccess

  #programatically
  use Ado::Command::generate::apache2htaccess;
  my $v = Ado::Command::generate::apache2htaccess->new;
  $v->run('--modules' => 'cgi,fcgid');

DESCRIPTION

Ado::Command::generate::apache2htaccess generates an Apache2 .htaccess configuration file for your Ado application. You can use this command for a shared hosting account.

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.

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.

v|verbose

Verbose output.

M|modules=s@

Apache modules to use for running ado. Currently supported modules are mod_cgi and mod_fcgid. You can mention them both to add the corresponding sections and Apache will use mod_fcgid if loaded or mod_cgi (almost always enabled). The generated configuration for mod_fcgid will use Plack (plackup) or Mojo::Server::FastCGI. So make sure you have at least one of them installed. Plack is recommended. To use Plack with mod_fcgid you will need to install FCGI, FCGI::ProcManager and Apache::LogFormat::Compiler.

ATTRIBUTES

Ado::Command::generate::apache2htaccess inherits all attributes from Ado::Command::generate and implements the following new ones.

description

  my $description = $htaccess->description;
  $v              = $htaccess->description('Foo!');

Short description of this command, used for the command list.

usage

  my $usage = $htaccess->usage;
  $v        = $htaccess->usage('Foo!');

Usage information for this command, used for the help screen.

METHODS

Ado::Command::generate::apache2htaccess inherits all methods from Ado::Command::generate and implements the following new ones.

run

  my $htaccess = Ado::Command::generate::apache2htaccess->run(@ARGV);
  my $htaccess = $app->commands->run("generate", "apache2htaccess",
    '-m' => 'cgi,fcgid', '-c' => $config_file);
Run this command. Returns C<$self>.

SEE ALSO

Ado::Plugin::Routes, Apache deployment, Apache - Upgrading to 2.4 from 2.2, Ado::Command::generate::apache2vhost, Ado::Command::generate, Getopt::Long, Ado::Command Ado::Manual, Mojolicious, "DEPLOYMENT" in Mojolicious::Guides::Cookbook, Mojo::Server::FastCGI.