NAME

Egg::Release - Version of Egg WEB Application Framework.

DESCRIPTION

'Egg' is MVC framework that is influenced from 'Catalyst' and developed.

It consists of a simple module composition. and the residing memory is comparatively few and operates at high speed, too.

Model

Egg::Model::DBI is attached by the standard.

Because Egg::Model::DBI is registered in CPAN, we am separately used properly by the favorite.

View

Egg::View::Template and Egg::View::Mason is attached by the standard. Egg::View::Template is loaded in default.

Moreover, Egg::View::TT is registered in CPAN, and use it by the favorite separately, please.

Controller

It generates it with helper script (Egg::Helper).

Configuration and Dispatch is included in the controller.

Request

Either of Egg::Request::Apache::* or Egg::Request::CGI or Egg::Request::FastCGI is loaded judging the environment.

Response

Egg::Response is used fixing.

Moreover, all enhanced features rely on Plugin.

Please refer to the document of the module of the object for details or more for each part.

PROJECT

Egg constructs the application in each project generated with Egg::Helper.

  % perl egg_helper.pl Project NewProject

The helper script generates the project file with the following compositions.

PROJECT ROOT

The helper script makes the root directory of the project for a suitable place. And, all configuration files are generated to the directory.

SCRIPT FILE

ƒvƒƒWƒFƒNƒg‚ÉŠÖ‚·‚鎟‚̂悤‚È‚¢‚­‚‚©‚̃XƒNƒŠƒvƒg‚ª ./bin ‚Ì’†‚ɐ¶¬‚³‚ê‚Ü‚·B

  • [PROJECT_NAME]_helper.pl

    Helper script only for project.

  • [PROJECT_NAME]_tester.pl

    Test script only for project. The operational condition of the project can be checked by requesting WEB virtual.

  • trigger.cgi

    Script that becomes trigger when operating as usual CGI. When managing it by this, it moves to an appropriate place and WEB is requested to this script.

  • dispatch.fcgi

    Script used when operating with FastCGI.

Ã“IƒRƒ“ƒeƒ“ƒc

The banner image etc. of some Egg are generated to ./htdocs as static contents.

ƒ‰ƒCƒuƒ‰ƒŠ

The controller and the configuration for the project are generated to ./lib.

ƒfƒBƒŒƒNƒgƒŠ

Additionally, the following directories are generated according to the usage.

  • cache

    Empty directory for file cash. Please give the proper permission when you use it.

  • root

    Preservation place of template.

  • comp

    Preservation place of template only for include.

  • etc

    Other configuration file depositories etc.

  • tmp

    Temporary work directory. Please give the proper permission when you use it.

  • t

    Test file depository when project complete set is managed as Perl module.

CONTROLLER

The controller of the project contains processing importance the application is composed, and the following.

  • Loading of Egg

    Egg is read with use and the plugin and the flag that wants to load it by the argument are passed.

      use Egg qw/
        -Debug
        ConfigLoader
        Encode
        Upload
        Tools
        Dispatch::Standard
        Debugging
        Log
        FormValidator::Simple
        ErrorDocument
        DBI::Transaction
        +MyApp::Plugin
        /;

    Because the method such as 'dispatch' and 'debug' and 'log' that Egg demands is included as for 'Dispatch::*' and 'Debugging' and 'Log', it is necessary to load it.

    In addition, please refer to the document of Egg for details.

  • Initialization of Egg.

    The configuration of an appropriate place is loaded by ConfigLoader in default. Please refer to the document of Egg::Plugin::ConfigLoader for details.

    However, if it is not a platform where the perpetuity objects such as mod_perl and FastCGI are treated, it always costs the behavior cost in initial operation. To evade this, the configuration is passed directly to 'egg_startup'.

      __PACKAGE__->egg_startup({
        title => 'project_name',
        .....
        ...
        .
        });

    Please refer to the document of Egg for a set item of Egg.

  • Dispatch ‚̐ݒè

    The setting for loaded Dispatch is set up by 'run_modes'.

      __PACKAGE__->run_modes(
        .....
        ...
        .
        );

    Please refer to the document of Egg::Plugin::Dispatch::Standard and Egg::Plugin::Dispatch::Fast for details for the setting method.

Additionally, Egg does a little tricky processing that adds the plugin and oneself to controller's @ISA. Therefore, the method of the addition to the controller is given to priority more than any module included in controller's @ISA.

$e->next::method is used to process it of returning the method of other modules to former processing after override is done as a controller.

  sub overwrite_method {
     my($e)= @_;
     .......
     ....
     ..
     $e->next::method;
  }

PLUGINS

It is the main list of the plug-in for Egg. * The one other than the standard are included.

Blosxom

It is a plugin to use ModBlosxom that uses blosxom of a famous Blog system as a module.

Egg::Plugin::Blosxom,

CGIrun

Arbitrary CGI is moved in Egg and the result is output.

Egg::Plugin::CGIrun,

* I think that there is a thing that doesn't operate well according to CGI either.

Cache

The use of an arbitrary cash module becomes convenient.

Egg::Plugin::Cache

Charset

It appropriately processes it concerning the character set of the output contents.

The following plug-in is loaded and used.

Egg::Plugin::Charset::Charset::UTF8, Egg::Plugin::Charset::EUC_JP, Egg::Plugin::Charset::Shift_JIS,

ConfigLoader

The configuration of an appropriate place is loaded.

Egg::Plugin::ConfigLoader,

Crypt::CBC

Plugin to use Crypt::CBC.

Egg::Plugin::Crypt::CBC,

DBI::Easy

It comes to be able to write the code of troublesome DBI simply variously.

Egg::Plugin::DBI::Easy

DBI::Transaction

The processing of Transaction by Egg::Model::DBI is automated.

Egg::Plugin::DBI::Transaction

DBIC::Transaction

The processing of Transaction by Egg::Model::DBIC is automated.

Egg::Plugin::DBIC::Transaction

* It is not possible to use it at the same time with 'DBI::Transaction'.

Debugging

'debug' method demanded by Egg is offered. It is an indispensable plugin.

Egg::Plugin::Debugging

Dispatch

'dispatch' method demanded by Egg is offered. It is an indispensable plugin.

Please load the following either.

Egg::Plugin::Dispatch::Fast, Egg::Plugin::Dispatch::Standard,

Encode

It processes it concerning the character-code conversion or union.

Egg::Plugin::Encode.

ErrorDocument

The contents output when it makes an error of '404 Not Found' and '403 Forbidden', etc. is helped.

Egg::Plugin::ErrorDocument

* It does without relation to the processing when the exception is generated.

File::Rotate

The file is rotated and the file before is left.

Egg::Plugin::File::Rotate

FillInForm

Plugin to use 'HTML::FillInForm'.

Filter

It is a plugin to receive the data regularized by Filter.

Egg::Plugin::Filter.

Plugin: Egg::Plugin::Filter::Plugin::Japanese::UTF8, Egg::Plugin::Filter::Plugin::Japanese::EUC, Egg::Plugin::Filter::Plugin::Japanese::Shift_JIS,

FormValidator::Simple

Plugin to use 'FormValidator::Simple'.

Egg::Plugin::FormValidator::Simple.

HTTP::HeadParser

Parsing when response header and request header are received by text.

Egg::Plugin::HTTP::HeadParser.

LWP

Plugin to use 'LWP::UserAgent'.

Egg::Plugin::LWP.

Log

'log' method demanded by Egg is offered. It is an indispensable plugin.

Egg::Plugin::Log.

MailSend

Plugin to do Mail Sending.

Egg::Plugin::MailSend.

Net::Ping

Plugin to use 'Net::Ping'.

Egg::Plugin::Net::Ping.

Net::Scan

It connects with an arbitrary port and a target service situation is checked.

Egg::Plugin::Net::Scan.

Pod::HTML

The Pod document is output.

Egg::Plugin::Pod::HTML.

Prototype

Plugin to use 'Prototype'.

Egg::Plugin::Prototype.

Redirect::Body

An easy HTML source for Redirect is offered and output.

Egg::Plugin::Redirect::Body

SessionKit

The session function is offered.

Egg::Plugin::SessionKit.

Tools

It is a plugin that offers a convenient method.

Egg::Plugin::Tools.

Upload

Plugin to support file up-loading.

Egg::Plugin::Upload.

YAML

Plugin to use 'YAML'.

Egg::Plugin::YAML

rc

Plugin to read resource code file.

Egg::Plugin::rc.

SUPPORT

Distribution site.

  L<http://egg.bomcity.com/>.

sourcefoge project.

  L<http://sourceforge.jp/projects/egg/>.

AUTHOR

Masatoshi Mizuno <lushe@cpan.org>

COPYRIGHT

Copyright (C) 2007 by Bee Flag, Corp. <http://egg.bomcity.com/>, All Rights Reserved.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.6 or, at your option, any later version of Perl 5 you may have available.

2 POD Errors

The following errors were encountered while parsing the POD:

Around line 55:

L<> starts or ends with whitespace

L<> starts or ends with whitespace

Around line 90:

Non-ASCII character seen before =encoding in 'ƒvƒƒWƒFƒNƒg‚ÉŠÖ‚·‚鎟‚̂悤‚È‚¢‚­‚‚©‚̃XƒNƒŠƒvƒg‚ª'. Assuming ISO8859-1