1Catalyst::Plugin::SetenUvs(e3r)Contributed Perl DocumentCaattiaolnyst::Plugin::Setenv(3)
2
3
4
6 Catalyst::Plugin::Setenv - Allows you to set up the environment from
7 Catalyst's config file.
8
10 Version 0.03
11
13 In your application:
14
15 use Catalyst qw/Setenv/;
16
17 In your config file:
18
19 environment:
20 FOO: bar
21 BAR: baz
22
23 When your app starts, $ENV{FOO} will be "bar", and $ENV{BAR} will be
24 "baz".
25
26 You can also append and prepend to existing environment variables. For
27 example, if $PATH is "/bin:/usr/bin", you can append "/myapp/bin" by
28 writing:
29
30 environment:
31 PATH: "::/myapp/bin"
32
33 After that, $PATH will be set to "/bin:/usr/bin:/myapp/bin". You can
34 prepend, too:
35
36 environment:
37 PATH: "/myapp/bin::"
38
39 which yields "/myapp/bin:/bin:/usr/bin".
40
41 If you want a literal colon at the beginning or end of the environment
42 variable, escape it with a "\", like "\:foo" or "foo\:". Note that
43 slashes aren't meaningful elsewhere, they're inserted verbatim into the
44 relevant environment variable.
45
47 A list of functions that can be exported. You can delete this section
48 if you don't export anything, such as for a purely object-oriented
49 module.
50
52 setup
53 Calls the other setup methods, and then sets the environment variables.
54
56 Jonathan Rockway, "<jrockway at cpan.org>"
57
59 Escaping
60 Things like "\:foo" can't be literally inserted into an environment
61 variable, due to my simplistic escaping scheme. Patches to fix this
62 (but not interpert "\"s anywhere else) are welcome.
63
64 REPORTING
65 Please report any bugs or feature requests to
66 "bug-catalyst-plugin-setenv at rt.cpan.org", or through the web
67 interface at
68 <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Catalyst-Plugin-Setenv>.
69 I will be notified, and then you'll automatically be notified of
70 progress on your bug as I make changes.
71
73 You can find documentation for this module with the perldoc command.
74
75 perldoc Catalyst::Plugin::Setenv
76
77 You can also look for information at:
78
79 · The Catalyst Website
80
81 <http://www.catalystframework.org/>
82
83 · AnnoCPAN: Annotated CPAN documentation
84
85 <http://annocpan.org/dist/Catalyst-Plugin-Setenv>
86
87 · CPAN Ratings
88
89 <http://cpanratings.perl.org/d/Catalyst-Plugin-Setenv>
90
91 · RT: CPAN's request tracker
92
93 <http://rt.cpan.org/NoAuth/Bugs.html?Dist=Catalyst-Plugin-Setenv>
94
95 · Search CPAN
96
97 <http://search.cpan.org/dist/Catalyst-Plugin-Setenv>
98
100 Thanks to Bill Moseley's message to the mailing list that prompted me
101 to write this.
102
104 Copyright 2006 Jonathan Rockway, all rights reserved.
105
106 This program is free software; you can redistribute it and/or modify it
107 under the same terms as Perl itself.
108
109
110
111perl v5.28.1 2019-02-02 Catalyst::Plugin::Setenv(3)