4 Catalyst::Plugin::ConfigLoader::Manual - Guide to using the ConfigLoader plugin
10 use Catalyst qw( ConfigLoader ... );
12 =head1 ENVIRONMENT VARIABLES
16 =item * C<MYAPP_CONFIG> - specific config file to load for "MyApp"
18 =item * C<CATALYST_CONFIG_LOCAL_SUFFIX> - global suffix for extra config files
20 =item * C<MYAPP_CONFIG_LOCAL_SUFFIX> - suffix specifically for "MyApp"
26 =head2 Config::General
41 <Component Controller::Foo>
104 =head3 Example Config
108 'Controller::Foo' => {
126 =head3 Example Config
130 <component name="Controller::Foo">
150 =head3 Example Config
161 =head2 Configuring a Catalyst::Model::DBIC::Schema model from a YAML config
164 schema_class: MyApp::MySchema
166 - dbi:SQLite:myapp.db
171 =head2 Converting your existing config to Config::General format
173 As of L<Catalyst::Devel> 1.07, a newly created application will use
174 L<Config::General> for configuration. If you wish to convert your existing
175 config, run the following one-liner (replacing MyApp with your app's name):
177 perl -Ilib -MMyApp -MConfig::General -e 'Config::General->new->save_file("myapp.conf", MyApp->config);'
179 =head2 Using UTF-8 strings in a Config::General file
181 If you have UTF-8 strings in your L<Config::General>-based config file, you
182 should add the following config information to MyApp.pm:
184 __PACKAGE__->config( 'Plugin::ConfigLoader' => {
186 'General' => { -UTF8 => 1 },