GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  CATALYST::PLUGIN::CONFIGLOADER::ENVIRONMENT (3)

.ds Aq ’

NAME

Catalyst::Plugin::ConfigLoader::Environment - Configure your application with environment variables.

CONTENTS

VERSION

Version 0.05

SYNOPSIS

Catalyst::Plugin::ConfigLoader::Environment reads environment variables and sets up the configuration in your application accordingly.

Here’s how you use it:



    package MyApp;
    use Catalyst qw(... ConfigLoader::Environment ...);
    MyApp->setup;



Then, before you run your application, set some environment variables:



    export MYAPP_foo=Hello, world!
    export MYAPP_bar="foobar"
    perl script/myapp_server.pl



Inside your application, $c->config->{foo} will be equal to Hello, world!, and $c->config->{bar} will be equal to foobar.

    Compatibility with ConfigLoader

You can use both ConfigLoader and this module in the same application. If you specify ConfigLoader before ConfigLoader::Environment in the import list to Catalyst, the environment will override any configuration files that ConfigLoader may find. This is the recommended setup.

You can reverse the order in the import list if you want static config files to override the environment, but that’s not recommended.

DETAILS

Here’s exactly how environment variables are translated into configuration.

First, your application’s name is converted to ALL CAPS, any colons are converted to underscores (i.e. My::App is translated to MY_APP), and a _ is appended. Then, any environment variables not starting with this prefix are discarded.

The prefix is then stripped, and the remaining variables are then converted to elements in the config hash as follows.

Variables starting with Model::, View::, or Controller:: and then any character other than _ are treated as configuration options for the corresponding component of your application. The prefix is saved as prefix and everything after the first _ is used as a key into the $c->config->{"prefix"} hash.

Any other variables not starting with a special prefix are added directly to the $c->config hash.

EXAMPLES

Let’s translate a YAML config file:



    ---
    name: MyApp
    title: This is My App!
    View::Foo:
      EXTENSION: tt
      EVAL_PERL: 1
    Model::Bar:
      root: "/etc"
    Model::DBIC:
      connect_info: [ "dbi:Pg:dbname=foo", "username", "password" ]



into environment variables that would setup the same configuration:



    MYAPP_name=MyApp
    MYAPP_title=This is My App!
    MYAPP_View__Foo_EXTENSION=tt
    MYAPP_View__Foo_EVAL_PERL=1
    MYAPP_Model__Bar_root=/etc
    MYAPP_Model__DBIC_connect_info=["dbi:Pg:dbname=foo", "username", "password"]



Double colons are converted into double underscores. For compatibility’s sake, support for the 0.01-style use of bourne-incompatible variable names is retained.

Values are JSON-decoded if they look like JSON arrays or objects (i.e. if they’re enclosed in []s or {}s). Taking advantage of that, we can write the same example this way:



    MYAPP_name=MyApp
    MYAPP_title=This is My App!
    MYAPP_View__Foo={"EXTENSION":"tt","EVAL_PERL":1}
    MYAPP_Model__Bar={"root":"/etc"}
    MYAPP_Model__DBIC={"connect_info":["dbi:Pg:dbname=foo", "username", "password"]}



FUNCTIONS

    setup

Overriding Catalyst’ setup routine.

AUTHOR

Jonathan Rockway, <jrockway at cpan.org>

CONTRIBUTORS

mugwump

Ryan D Johnson, <ryan at innerfence.com>

Devin J. Austin <dhoss@cpan.org>

BUGS

Please report any bugs or feature requests to bug-catalyst-plugin-configloader-environment at rt.cpan.org, or through the web interface at <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Catalyst-Plugin-ConfigLoader-Environment>. I will be notified, and then you’ll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.



    perldoc Catalyst::Plugin::ConfigLoader::Environment



You can also look for information at:
o Catalyst Mailing List

<mailto:catalyst@lists.rawmode.org>.

o RT: CPAN’s request tracker

<http://rt.cpan.org/NoAuth/Bugs.html?Dist=Catalyst-Plugin-ConfigLoader-Environment>

COPYRIGHT & LICENSE

Copyright 2006 Jonathan Rockway, all rights reserved.

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

If you’d like to use it under a different license, that’s probably OK. Please contact the author.

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 CATALYST::PLUGIN::CONFIGLOADER::ENVIRONMENT (3) 2010-06-05

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.