README

NAME
    Para::Frame - Web site framework and application server


DESCRIPTION
    Para::Frame is a system to use for dynamic web sites. It runs as a
    backend daemon taking page requests from a Apache mod_perl client
    and returns a HTTP response.

    The URLs in the site corresponds to templates for displaying
    information. Operations on the data is put in perl modules
    separated from the templates.

    Para::Frame handles multitasking within the process, enabeling you
    to keep your initialized objects in memory with no need to sync
    with the DB for each request.

    The session data lives in memory. No need to save it in an
    external format.

    Para::Frame uses "routes" for planning things to do in a session,
    taking care of which page to display next, depending on form
    actions.  Integrated with exception handling.

    One Para::Frame daemon can handle many sites on the same
    server. It uses the Apache configuration for handling URL to file
    translation.

    You can have any number of Para::Frame daemons running in
    parallell on the same server. Maby using one for development, one
    for the stable version and one backup in case of failure. You can
    easily configure the site to use a backup daemon as a last resort.

    A Watchdog makes sure that the system works. It pings the daemon
    in regular intervals and restarts it if locks up or if the memory
    limit is reached. The restart is done by forking.

    There are tons of useful functions.


DOCUMENTATION
    Far from complete. Don't be afraid of reading the source.


PREREQUISITIES
    Perl v5.10 and Apache with mod_perl. I'm using DBD::Pg but others
    should mosly work.

    This module is the oposite of minimalist. It includes lots of
    other modules. Your experience of installing CPAN modules will
    come to good use.


INSTALL
    You are not meant to install Para::Frame among your Perl
    libraries.  Copy the ditribution to /usr/local/paraframe
    See INSTALL for details.


DEVELOPMENT
    The homepage for Para::Frame is http://frame.para.se/ there you
    can find the developers mailinglist and more background
    information.  Please send any comments to the developer
    mailinglist.


COPYRIGHT
    Copyright (C) 2004-2007 Jonas Liljegren. All Rights Reserved.

    This module is free software; you can redistribute it and/or
    modify it under the same terms as Perl itself.