tehmoth / plack-app-dbi-gofer Goto Github PK

NAME

    Plack::App::DBI::Gofer - server side http transport for DBI-Gofer using
    PSGI

SYNOPSIS

            use Plack::App::DBI::Gofer;
            my $app = Plack::App::DBI::Gofer->new( config => {
                    %DBI_Gofer_Execute_config_params
            })->to_app;
            
            # or map a path to a forced dsn
            use Plack::Builder;
            builder {
                    mount '/mydb' => Plack::App::DBI::Gofer->new( config => {
                            forced_connect_dsn => 'dbi:SQLite:dbname=mydb.db',
                    })->to_app;
            };

    For a corresponding client-side transport see
    DBD::Gofer::Transport::http.

DESCRIPTION

    This module implements a DBD::Gofer server-side http transport through
    PSGI.

    This enables DBI to connect to databases through your PSGI-enabled HTTP
    server.

CONFIGURATION

 Gofer Configuration

    Rather than provide a DBI proxy that will connect to any database as
    any user, you may well want to restrict access to just one or a few
    databases.

    Or perhaps you want the database passwords to be stored only in your
    app.psgi so you don't have to maintain them in all your clients.

    A typical usage might be to define configurations for each specific
    database being used and then define a coresponding location for each of
    those. That would also allow standard http location access controls to
    be used

    That approach can also provide a level of indirection by avoiding the
    need for the clients to know and use the actual DSN. The clients can
    just connect to the specific gofer url with an empty DSN. This means
    you can change the DSN being used without having to update the clients.

    This enables the use of forking PSGI web servers and handlers,
    including Starman, Monoceros and Gazelle as caching, stateless database
    proxies.

    At this time, this application doesn't support asynchronous, event
    driven servers such as Twiggy.

    config

      Set to a hash of DBI::Gofer::Execute options, optional.

DIFFERENCES FROM DBI::Gofer::Transport::mod_perl

      * No equivalent for the Apache::Status support

      * No client side transport (relies instead on
      DBD::Gofer::Transport::http)

TO DO

      * Add a lighter client side http transport that doesn't require
      installing mod_perl

      Possibly using HTTP::Tiny or HTTP::Lite

      * More tests

      * Support http authorization (Basic and Digest)

      * Support PSGI streaming and async.

    Please report any bugs or feature requests to
    [email protected], or through the web interface at
    http://rt.cpan.org.

AUTHOR

    Tim Bunce, http://www.linkedin.com/in/timbunce

    James Wright https://metacpan.org/author/JWRIGHT

LICENCE AND COPYRIGHT

    Copyright (c) 2007, Tim Bunce, Ireland. All rights reserved.

    Copyright (c) 2018, James Wright, United States.

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

SEE ALSO

      * DBD::Gofer

      * DBD::Gofer::Transport::http

      * Plack