名前¶

Mojolicious::Guides - 銀河 Mojolicious ガイド

あわてるな¶

Mojolicious ドキュメントは三つの部分で 構成されています。 全員が始めるための "TUTORIAL"、全ての主な機能を説明する "GUIDES"、 全ての利用可能な API の一覧である "REFERENCE" です。

このドキュメントの一部は例として Mojolicious::Lite マイクロ web フレームワークのみを使っていますが、 これは単に読者の利便性のためです。 ほとんど全ての機能は完全な Mojolicious アプリケーションに対しても 正確に同じです。

BASICS¶

Learning Perl

(Perlを学ぶ)

If you are new to Perl, we recommend Learn Perl in 2 hours 30 minutes for a quick introduction, or the Modern Perl book, freely available in many formats. Both are excellent introductions to the language. For more books and documentation, check out learn.perl.org.

もしあなたがPerlが初めてならば、すばやい学習のために Learn Perl in 2 hours 30 minutes を見るか、 多くのフォーマットで自由に利用できる Modern Perl bookという本 をおすすめします。 どちらも素晴らしい言語の入門になっています。 さらなる本やドキュメントについては、 learn.perl.org を見てください。

Learning Web Technologies

(Web 技術を学ぶ)

All web development starts with HTML, CSS and JavaScript, to learn the basics we recommend the Mozilla Developer Network. And if you want to know more about how browsers and web servers actually communicate, there's also a very nice introduction to HTTP.

全ての web 開発は HTML, CSS, JavaScript から始まるので、 基本を学ぶためには Mozilla Developer Network を お勧めします。 そしてブラウザと web サーバーが実際にどのように通信するかについて さらに知りたいなら、 HTTP が とても良い導入となります。

CONVENTIONS¶

Modern Perl

(モダン Perl)

Mojolicious uses a modern subset of Perl exclusively, and therefore all documentation assumes that strict, warnings, utf8 and Perl 5.10 features are enabled, even if examples don't specifically mention it.

Mojolicious は Perl のモダンな部分だけを使うので、 全てのドキュメントは、たとえ例が特に触れていなくても、 strict, warnings, utf8 および Perl 5.10 features が有効であることを仮定しています。

  use strict;
  use warnings;
  use utf8;
  use feature ':5.10';

Some modules, like Mojo::Base and Mojolicious::Lite, will enable them for you automatically, whenever they are used.

Mojo::Base と Mojolicious::Lite のような一部のモジュールは、 これがどこで使われても、あなたのためにこれらを自動的に有効にします。

Variable names

(変数名)

For brevity and clarity, example variables will reflect the type of data the API uses. For instance, $bytes or $chars to distinguish whether it is encoded bytes or decoded characters in a Perl string, $bool if the value just indicates true or false, $c to denote a Mojolicious::Controller object, or $app to denote the application object.

簡潔さと明確さのために、例の変数は API が使うデータの型を反映しています。 例えば、$bytes や $chars はエンコードされたバイト列か デコードされた Perl 文字列 かを区別し、 値が単に真または偽を示す場合は $bool を、 Mojolicious::Controller オブジェクトを示すためには $c を、 application オブジェクトを示すためには $app を使います。

チュートリアル¶

Mojolicious::Guides::Tutorial

A fast and fun way to get started developing web applications with Mojolicious. The tutorial introduces the Mojolicious::Lite micro web framework, which is only a thin wrapper around the full web framework. The simplified notation introduced in the tutorial is commonly used throughout the guides and is therefore considered a prerequisite, you should definitely take a look!

Mojolicious でウェブアプリケーションの開発を始める本当に早く楽しい方法。 このチュートリアルは、完全な web フレームワークの薄いラッパーである Mojolicious::Lite マイクロ web フレームワークを紹介しています。 このチュートリアルで学ぶほとんどすべてのことは、 普通のMojoliciousアプリケーションで利用することができ、 ガイドを読む前に学習するためのものになっています。 絶対に見るべきです!

ガイド¶

Mojolicious::Guides::Growing

Starting a Mojolicious::Lite prototype from scratch and growing it into a well-structured Mojolicious application.

ゼロからの Mojolicious::Lite の原型から始めて、 それを良く構造化された Mojolicious アプリケーションへ育てること。

Mojolicious::Guides::Routing

Simple and fun introduction to the Mojolicious router.

簡単で楽しい Mojolicious ルータへの入門。

Mojolicious::Guides::Rendering

Generating content with the Mojolicious renderer.

Mojolicious レンダラでの内容生成。

Mojolicious::Guides::Testing

Powerful yet elegant testing techniques and tools for Mojolicious and other web applications.

強力だが洗練された、Mojolicious やその他の web アプリケーションのための テスト技術とツール。

Mojolicious::Guides::Cookbook

Cooking with Mojolicious, recipes for every taste.

Mojolicious での料理、あらゆる風味のためのレシピ。

Mojolicious::Guides::Contributing

Become a part of the ongoing Mojolicious development.

進行中のMojolicious開発に参加しよう。

Mojolicious::Guides::FAQ

Answers to the most frequently asked questions.

もっともよくある質問への回答。

ハイライト¶

Mojolicious と Mojolicious::Lite は Mojo web 開発ツールキットの上に構築された多くの部品の集合体です。 つまり独立に使用可能である小さな構成ブロックが集約されたものです; これらは最も顕著なものです。

Mojo::UserAgent

Full featured non-blocking I/O HTTP and WebSocket user agent.

完全な機能を備えた非同期 I/O HTTP および WebSocket ユーザエージェント。

Mojo::DOM

Very fun and minimalistic HTML/XML DOM parser with CSS selector support.

とても楽しい、CSS セレクタをサポートした最小限の HTML/XML DOM パーサ。

Mojo::JSON

Minimalistic JSON implementation that just works.

正しく動作する最小限の JSON 実装。

Mojo::Server::Daemon

Full featured, highly portable non-blocking I/O HTTP and WebSocket server, with self-restart support through Mojo::Server::Morbo, perfect for development and testing.

完全な機能を持ち、高度にポータブルな非同期 I/O HTTP および WebSocket サーバ; 開発とテストに最適な、Mojo::Server::Morbo による自己再起動に対応。

Mojo::Server::Prefork

Full featured, UNIX optimized, preforking non-blocking I/O HTTP and WebSocket server with support for zero downtime software upgrades (hot deployment) through Mojo::Server::Hypnotoad.

完全な機能を備え、UNIXに最適化された、 プリフォーク非同期 I/O HTTP および WebSocket サーバ; Mojo::Server::Hypnotoadを通して、 停止時間なしでのソフトウェア更新(ホットデプロイメント)をサポートします。

Mojo::Server::CGI, Mojo::Server::PSGI

Transparent CGI and PSGI support out of the box.

そのままで CGI, FastCGI, PSGI を透過的にサポート。

Mojo::IOLoop

A minimalistic event loop with support for multiple reactor backends.

複数のリアクターバックエンドをサポートした最小限のイベントループ。

Mojo::Template

Very Perl-ish and minimalistic template system.

とても Perl 的、かつ最小限のテンプレートシステム。

Test::Mojo

Testing toolkit for web applications.

ウェブアプリケーションのためのテストツールキット。

ojo

Fun one-liners using everything above.

上記全ての利用をワンライナーでお楽しみ下さい。

スピンオフ¶

これらのモジュールは Mojolicious ディストリビューションの 一部ではありませんが、これらと共に使うように設計されており、 同じ傘の下で開発されています。

Mojo::Pg

A tiny wrapper around DBD::Pg that makes PostgreSQL a lot of fun to use with Mojolicious. Perform queries blocking and non-blocking, use all SQL features PostgreSQL has to offer, generate CRUD queries from data structures, manage your database schema with migrations and build scalable real-time web applications with the publish/subscribe pattern.

PostgreSQL を Mojolicious と共にとても楽しく使えるようにするための DBD::Pg の小さいラッパーです。 ブロックと非ブロックのクエリの実行、 PostgreSQL が提供している全ての SQL 機能 の使用、 データ構造からの CRUD クエリの生成、 マイグレーションのあるデータベーススキーマの管理、 発行/購読パターンのスケールするリアルタイム web アプリケーションの 構築などです。

Examples: The minimal chat application will show you how to scale WebSockets to multiple servers, and the well-structured blog application how to apply the MVC design pattern in practice.

例: 最小限の チャット アプリケーションは、WebSockets を複数サーバーにスケールする方法を示し、 よく構成された ブログ アプリケーションは実践的な MVC デザインパターンの適用方法を示します。

Minion

A full featured job queue for Mojolicious with support for multiple backends (such as PostgreSQL). Job queues allow you to process time and/or computationally intensive tasks in background processes, outside of the request/response lifecycle. Among those tasks you'll commonly find image resizing, spam filtering, HTTP downloads, building tarballs, warming caches and basically everything else you can imagine that's not super fast.

(PostgreSQL のような) 複数のバックエンドに 対応する、Mojolicious のための完全な機能のジョブキューです。 ジョブキューは、時間や計算集約的なタスクを、リクエスト/レスポンスの ライフサイクルの外側のバックグラウンドプロセスで処理できるようになります。 いろいろなタスクの中でも、よくあるのはイメージのリサイズ、スパムフィルタ、 HTTP ダウンロード、tar ボールのビルド、キャッシュのウォーミングアップおよび、 一般的にとても速いという訳ではないと想像する全てです。

Examples: The link checker will show you how to integrate background jobs into well-structured Mojolicious applications.

例: リンクチェッカー は、 バックグラウンドジョブをよく構成された Mojolicious アプリケーションとどのように統合するかを示しています。

REFERENCE¶

これは Mojolicious 配布のクラス階層です。

• Mojo

• Mojo::Base

  • Mojolicious

    • Mojo::HelloWorld

    • Mojolicious::Lite

  • Mojo::Cache

  • Mojo::Cookie

    • Mojo::Cookie::Request

    • Mojo::Cookie::Response

  • Mojo::DOM::CSS

  • Mojo::DOM::HTML

  • Mojo::Date

  • Mojo::EventEmitter

    • Mojo::Asset

      • Mojo::Asset::File

      • Mojo::Asset::Memory

    • Mojo::Content

      • Mojo::Content::MultiPart

      • Mojo::Content::Single

    • Mojo::IOLoop

    • Mojo::IOLoop::Client

    • Mojo::IOLoop::Server

    • Mojo::IOLoop::Stream

    • Mojo::IOLoop::Subprocess

    • Mojo::IOLoop::TLS

    • Mojo::Log

    • Mojo::Message

      • Mojo::Message::Request

      • Mojo::Message::Response

    • Mojo::Reactor

      • Mojo::Reactor::Poll

        • Mojo::Reactor::EV

    • Mojo::Server

      • Mojo::Server::CGI

      • Mojo::Server::Daemon

        • Mojo::Server::Prefork

      • Mojo::Server::PSGI

    • Mojo::Transaction

      • Mojo::Transaction::HTTP

      • Mojo::Transaction::WebSocket

    • Mojo::UserAgent

    • Mojolicious::Plugins

  • Mojo::Exception

  • Mojo::Headers

  • Mojo::JSON::Pointer

  • Mojo::Parameters

  • Mojo::Path

  • Mojo::Promise

    • Mojo::IOLoop::Delay

  • Mojo::Server::Hypnotoad

  • Mojo::Server::Morbo

  • Mojo::Server::Morbo::Backend

    • Mojo::Server::Morbo::Backend::Poll

  • Mojo::Template

  • Mojo::URL

  • Mojo::Upload

  • Mojo::UserAgent::CookieJar

  • Mojo::UserAgent::Proxy

  • Mojo::UserAgent::Server

  • Mojo::UserAgent::Transactor

  • Mojolicious::Command

    • Mojolicious::Command::cgi

    • Mojolicious::Command::daemon

    • Mojolicious::Command::eval

    • Mojolicious::Command::get

    • Mojolicious::Command::prefork

    • Mojolicious::Command::psgi

    • Mojolicious::Command::routes

    • Mojolicious::Command::version

    • Mojolicious::Command::Author::cpanify

    • Mojolicious::Command::Author::generate::app

    • Mojolicious::Command::Author::generate::lite_app

    • Mojolicious::Command::Author::generate::makefile

    • Mojolicious::Command::Author::generate::plugin

    • Mojolicious::Command::Author::inflate

    • Mojolicious::Commands

      • Mojolicious::Command::Author::generate

  • Mojolicious::Controller

  • Mojolicious::Plugin

    • Mojolicious::Plugin::Config

      • Mojolicious::Plugin::JSONConfig

    • Mojolicious::Plugin::DefaultHelpers

    • Mojolicious::Plugin::EPLRenderer

      • Mojolicious::Plugin::EPRenderer

    • Mojolicious::Plugin::HeaderCondition

    • Mojolicious::Plugin::Mount

    • Mojolicious::Plugin::TagHelpers

  • Mojolicious::Renderer

  • Mojolicious::Routes::Match

  • Mojolicious::Routes::Pattern

  • Mojolicious::Routes::Route

    • Mojolicious::Routes

  • Mojolicious::Sessions

  • Mojolicious::Static

  • Mojolicious::Types

  • Mojolicious::Validator

  • Mojolicious::Validator::Validation

  • Test::Mojo

• Mojo::ByteStream

• Mojo::Collection

• Mojo::DynamicMethods

• Mojo::DOM

• Mojo::File

  • Mojo::Home

• Mojo::JSON

• Mojo::Loader

• Mojo::Util

• Mojo::WebSocket

• ojo

より学ぶには¶

多くのユーザーによるより多くのドキュメントやサンプルは Mojolicious wiki にあります。

サポート¶

ドキュメントに答えが見つからなくて質問があるときは、 mailing listか公式のIRCチャンネルである irc.freenode.net (chat now!)の #mojoでためらわずに質問してください。