The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Toadfarm::Manual::Intro - Introduction to Toadfarm

DESCRIPTION

This manual aims to give an introduction to how to set up toadfarm.

Script

First you need to create a basic script to describe when an application will be triggered. This is a plain Perl script which allow you to pull in any trick you like from the Perl toolbox.

Example:

  #!/usr/bin/perl
  use Toadfarm -init;

  mount "/home/web/project1/script/app1" => {
    "X-Request-Base" => "http://mydomain.com/whatever"
  };

  mount "Web::App2" => {
    "Host" => "mydomain.com",
  };

  start;

The script above will pass the request on to app1 when the "X-Request-Base" header is set to "http://mydomain.com/whatever". Or it will pass the request on to Web::App2 if the "Host" header is set to "mydomain.com".

You can save the content of the file anywhere and run it as any other Mojolicious application.

Note: There are other special fields to trigger on, besides HTTP headers. See "Apps" in Toadfarm::Manual::Config for more details.

Start Toadfarm

After you have saved the config file, you can start the Toadfarm application:

  $ /path/to/your-script start

After this, you should see your-script running and the applications can be accessed from http://localhost:8080.

Further reading

See Toadfarm::Manual::RunningToadfarm for more command line options, and Toadfarm::Manual::Config for full list of config file options.

SEE ALSO

Toadfarm::Manual::Config.

Toadfarm::Manual::RunningToadfarm.

AUTHOR

Jan Henning Thorsen - jhthorsen@cpan.org