Mojolicious — веб в коробке!

=head1 ИМЯ

Mojolicious — веб в коробке!

=head1 ОБЗОР

# Приложение Mojolicious
package MyApp;

use base 'Mojolicious';

sub startup {
my $self = shift;

# Routes
my $r = $self->rout

# Default route
$r->route('/:controller/:action/:id')->to('foo#welcome');
}

# Контроллер Mojolicious
package MyApp::Foo;

use base 'Mojolicious::Controller';

# Say hello
sub welcome {
my $self = shift;
$self->render_text('Hi there!');
}

# Say goodbye from a template (foo/bye.html.ep)
sub bye { shift->render }

=head1 ОПИСАНИЕ

На заре развития всемирной паутины существовала прекрасная библиотека Perl,
называемая C<CGI>; многие люди изучали Perl только из-за неё.
Она была достаточно проста, чтобы начать работу без особого знания языка и достаточно мощна, чтобы с увлечением продолжать изучать язык. Хотя большинство используемых ею методов в настоящее время устарело, сама идея остается актуальной. C<Mojolicious> — новая попытка реализации этой идеи c использованием передовых технологий.

=head2 Возможности

=over 4

Великолепный веб-фреймворк MVC позволяет написать полноценное приложение в одном файле с помощью L<Mojolicious::Lite>.

Очень чистый, портируемый и объектно-ориентированный Perl API без какой-либо скрытой магии и требований, кроме Perl 5.8.7.

Полная поддержка HTTP 1.1 и клиент/серверная реализация WebSocket с IPv6, TLS, IDNA, конвейеров, поддержка chunking и multipart.

Встроенный асинхронный ввод-вывод, prefork-вебсервер с поддержкой epoll и kqueue, "горячая" развёртка и использование доменного сокета UNIX (анг. Unix domain socket sharing) — прекрасно подходит для встраивания!

Поддержка CGI, FastCGI и L<PSGI>.

Свежий код, основанный на многолетнем опыте разработки Catalyst.

Мощные возможности прямо из коробки: роуты RESTful, плагины, сессии, подписанные cookies, сервер статических файлов (static file server), тестировочный фреймворк, шаблонизация в стиле Perl, JSON, I18N, первоклассная поддержка Юникода и многое другое!

=back

=head2 Липкая лента для HTML5

Веб-разработка для людей, делающая сложные вещи возможными, а саму разработку приятной.

use Mojolicious::Lite;

get '/hello' => sub { shift->render(text => 'Hello World!') }

get '/time' => 'clock';

websocket '/echo' => sub {
my $self = shift;
$self->receive_message(
sub {
my ($self, $message) = @_;
$self->send_message("echo: $message");
}
);
};

get '/title' => sub {
my $self = shift;
my $url = $self->param('url');
$self->render(text =>
$self->client->get($url)->success->dom->at('title')->text);
};

post '/:offset' => sub {
my $self = shift;
my $offset = $self->param('offset') || 23;
$self->render(json => {list => [0 .. $offset]});
};

app->start;
__DATA__

@@ clock.html.ep
% my ($second, $minute, $hour) = (localtime(time))[0, 1, 2];
The time is <%= $hour %>:<%= $minute %>:<%= $second %>.

См. более дружественную к пользователю документацию L<Mojolicious::Guides> и L<Mojolicious::Lite>.

=head2 Вот такие пироги

.---------------------------------------------------------------.
| |
| .----------------------------------------------'
| | .--------------------------------------------.
| Application | | Mojolicious::Lite |
| | '--------------------------------------------'
| | .--------------------------------------------.
| | | Mojolicious |
'----------------' '--------------------------------------------'
.---------------------------------------------------------------.
| Mojo |
'---------------------------------------------------------------'
.-------. .-----------. .--------. .------------. .-------------.
| CGI | | FastCGI | | PSGI | | HTTP 1.1 | | WebSocket |
'-------' '-----------' '--------' '------------' '-------------'

АТРИБУТЫ

L<Mojolicious> наследует все атрибуты из L<Mojo> и реализует следующие.

=head2 C<controller_class>

my $class = $mojo->controller_class;
$mojo = $mojo->controller_class('Mojolicious::Controller');

Класс который будет использоваться в качестве контроллера,
по умолчанию используется L<Mojolicious::Controller>.

=head2 C<mode>

my $mode = $mojo->mode;
$mojo = $mojo->mode('production');

Режим работы для вашего приложения.
По умолчанию используется значение переменной окружения C<MOJO_MODE> или C<development>.
Mojo назовёт лог-файл по текущему режиму; если режим отличается от C<development>, логи будут ограничены.

Если вы хотите добавить в ваше приложение логику, зависящую от режима, можете добавить подпрограмму C<$mode_mode>.

sub development_mode {
my $self = shift;
}

sub production_mode {
my $self = shift;
}

=head2 C<plugins>

my $plugins = $mojo->plugins;
$mojo = $mojo->plugins(Mojolicious::Plugins->new);

Загрузчик плагина по умолчанию — объект L<Mojolicious::Plugins>. Обычно вы можете оставить всё как есть, см. L<Mojolicious::Plugin>, если хотите написать плагин.

=head2 C<renderer>

my $renderer = $mojo->renderer;
$mojo = $mojo->renderer(MojoX::Renderer->new);

Используется для визуализации контента, по умолчанию L<MojoX::Render>.
Два основных плагина визуализации L<Mojolicious::Plugin::EpRenderer>
и L<Mojolicious::Plugin::EplRenderer> содержат более подробную информацию.

=head2 C<routes>

my $routes = $mojo->routes;
$mojo = $mojo->routes(MojoX::Dispatcher::Routes->new);

Диспетчер маршрутов, по умолчанию L<MojoX::Dispatcher::Routes>. Вы используете его в стартовом методе для определения url endpoints для вашего приложения.

sub startup {
my $self = shift;

my $r = $self->routes;
$r->route('/:controller/:action')->to('test#welcome');
}

=head2 C<secret>

my $secret = $mojo->secret;
$mojo = $mojo->secret('passw0rd');

Секретный пароль, используемый для подписанных cookies и т.п., по умолчанию — название приложения, что не очень надежно, поэтому вы должны изменить его!!! До тех пор, пока вы будете использовать значение по умолчанию, в лог файл будут писаться отладочные сообщения с напоминанием о смене пароля.

=head2 C<static>

my $static = $mojo->static;
$mojo = $mojo->static(MojoX::Dispatcher::Static->new);

Для обслуживания статических ресурсов из каталога C<public>, по
умолчанию L<MojoX::Dispatcher::Static>.

=head2 C<types>

my $types = $mojo->types;
$mojo = $mojo->types(MojoX::Types->new);

Отвечает за отслеживание типов контента, который вы хотите
обслуживать в приложении, по умолчанию L<MojoX::Types>. Вы можете легко зарегистрировать новый тип.

$mojo->types->type(vti => 'help/vampire')

=head1 Методы

L<Mojolicious> наследует все методы от L<Mojo> и реализует следующие новые.

=head2 C<new>

my $mojo = Mojolicious->new;

Создаёт новое приложение L<Mojolicious>. Автоматически определяет ваш домашний каталог и устанавливает логирование, основываясь на вашем текущем режиме работы. Кроме того, устанавливается маршрутизация, статическая диспетчеризация и стандартный набор плагинов.

=head2 C<dispatch>

$mojo->dispatch($c);

Сердце каждого приложения Mojolicious, вызывает диспетчеры статических файлов и маршрутов для каждого запроса.

=head2 C<finish>

$mojo->finish($c);

Чистка после обработки запроса, как правило, вызывается автоматически.

=head2 C<handler>

$tx = $mojo->handler($tx);

Устанавливает контроллер по умолчанию и вызывает процесс для каждого запроса.

=head2 C<plugin>

$mojo->plugin('something');
$mojo->plugin('something', foo => 23);
$mojo->plugin('something', {foo => 23});

Загрузка плагина.

=head2 C<process>

$mojo->process($c);

Данный метод может быть перегружен, чтобы сделать логику, зависящую от запроса, по умолчанию просто вызывает C<dispatch>.
Вообще-то, вместо него вы будете использовать плагин или контроллер, считайте его за кувалду в вашем набор инструментов.

sub process {
my ($self, $c) = @_;
$self->dispatch($c);
}

=head2 C<start>

Mojolicious->start;
Mojolicious->start('daemon');

Запускает интерфейс командной строки L<Mojolicious::Commands> для вашего приложения.

=head2 C<startup>

$mojo->startup;

Это ваша основная точка входа в приложении, метод будет вызываться при запуске.

sub startup {
my $self = shift;
}

=head1 ПОДДЕРЖКА

=head2 В интернете

http://mojolicious.org