mojo

:sparkles: Mojolicious - Perl real-time web framework

Github stars Tracking Chart

Build Status Windows build status

Mojolicious is a fresh take on Perl web development, based on years of
experience developing the Catalyst framework, and utilizing the latest
web standards and technologies. You can get started with your project
quickly, with a framework that grows with your needs.

The Mojo stack provides a consistent set of components that can be used in
any project. The guides cover most aspects of using the framework and the
components have comprehensive reference documentation. Mojolicious is a
real-time web framework, which allows a new class of web applications
using WebSockets and having long-running requests without blocking.

Join us now, and be a part of a friendly and knowledgeable community of
developers!

Features

  • An amazing real-time web framework, allowing you to easily grow single
    file prototypes into well-structured MVC web applications.
    • Powerful out of the box with RESTful routes, plugins, commands, Perl-ish
      templates, content negotiation, session management, form validation,
      testing framework, static file server, CGI/PSGI
      detection, first class Unicode support and much more for you to
      discover.
  • A powerful web development toolkit, that you can use for all kinds of
    applications, independently of the web framework.
    • Full stack HTTP and WebSocket client/server implementation with IPv6, TLS,
      SNI, IDNA, HTTP/SOCKS5 proxy, UNIX domain socket, Comet (long polling),
      Promises/A+, async/await, keep-alive, connection pooling, timeout, cookie,
      multipart, and gzip compression support.
    • Built-in non-blocking I/O web server, supporting multiple event loops as
      well as optional pre-forking and hot deployment, perfect for building
      highly scalable web services.
    • JSON and HTML/XML parser with CSS selector support.
  • Very clean, portable and object-oriented pure-Perl API with no hidden
    magic and no requirements besides Perl 5.26.0 (versions as old as 5.10.1
    can be used too, but may require additional CPAN modules to be installed)
  • Fresh code based upon years of experience developing
    Catalyst, free and open source.
  • Hundreds of 3rd party
    extensions and
    high quality spin-off projects like the
    Minion job queue.

Installation

All you need is a one-liner, it takes less than a minute.

$ curl -L https://cpanmin.us, perl - -M https://cpan.metacpan.org -n Mojolicious

We recommend the use of a Perlbrew environment.

Getting Started

These three lines are a whole web application.

use Mojolicious::Lite;

get '/' => {text => 'I ♥ Mojolicious!'};

app->start;

To run this example with the built-in development web server just put the
code into a file and start it with morbo.

$ morbo hello.pl
Server available at http://127.0.0.1:3000

$ curl http://127.0.0.1:3000/
I ♥ Mojolicious!

Duct tape for the HTML5 web

Use all the latest Perl and HTML features in beautiful single file
prototypes like this one, and
grow
them easily into well-structured Model-View-Controller web applications.

use Mojolicious::Lite -signatures;

# Render template "index.html.ep" from the DATA section
get '/' => sub ($c) {
  $c->render(template => 'index');
};

# WebSocket service used by the template to extract the title from a website
websocket '/title' => sub ($c) {
  $c->on(message => sub ($c, $msg) {
    my $title = $c->ua->get($msg)->result->dom->at('title')->text;
    $c->send($title);
  });
};

app->start;
__DATA__

@@ index.html.ep
% my $url = url_for 'title';
<script>
  var ws = new WebSocket('<%= $url->to_abs %>');
  ws.onmessage = function (event) { document.body.innerHTML += event.data };
  ws.onopen    = function (event) { ws.send('https://mojolicious.org') };
</script>

Want to know more?

Take a look at our excellent documentation!

Main metrics

Overview
Name With Ownermojolicious/mojo
Primary LanguagePerl
Program languagePerl (Language Count: 5)
Platform
License:Artistic License 2.0
所有者活动
Created At2008-10-21 07:50:26
Pushed At2025-04-20 16:25:25
Last Commit At
Release Count748
Last Release Namev9.39 (Posted on 2024-11-23 15:14:47)
First Release Namev0.999920 (Posted on 2010-02-11 02:50:11)
用户参与
Stargazers Count2.7k
Watchers Count214
Fork Count583
Commits Count12.9k
Has Issues Enabled
Issues Count1012
Issue Open Count74
Pull Requests Count380
Pull Requests Open Count26
Pull Requests Close Count521
项目设置
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private