Apache::PerlVINC - Allows versioning of modules among directories or v-hosts.
# include the module. this line must be here. PerlModule Apache::PerlVINC # set the include path PerlINC /home/dave/site/files/modules # make sure VINC reloads the modules PerlFixupHandler Apache::PerlVINC # aptionally have VINC unload versioned modules PerlCleanupHandler Apache::PerlVINC # reloads Stuff::Things for all requests PerlVersion Stuff/Things.pm <Location /Spellcheck> SetHandler perl-script PerlHandler Spellcheck # reload version of this module found in PerlINC line PerlVersion Spellcheck.pm </Location>
PerlModule Apache::PerlVINC <Location /Spellcheck> SetHandler perl-script PerlHandler Spellcheck PerlFixupHandler Apache::PerlVINC # only reload for requests in /Spellcheck PerlINC /home/steve/site/files/modules PerlVersion Spellcheck.pm # makes PerlVINC load this version </Location>
With this module you can run two copies of a module without having to worry about which version is being used. Suppose you have two
Location that want to each use their own version of
Spellcheck.pm. Durning the FixUp phase,
Apache::PerlVINC will tweak
@INC and reload
Spellcheck. Optionally, it will unload that version if you specify
Apache::PerlVINC as a PerlCleanUpHandler.
As you can guess, this module slows things down a little because it unloads and reloads on a per-request basis. Hence, this module should only be used in a development environment, not a mission critical one.
Takes only one argument: the path to be prepended to
@INC. In v0.1, this was stored internally as an array. This is no longer the case. However, it still works somewhat as expected in that subsequent calls to
PerlINCwill not overwrite the previous ones, provided they are not in the same config section (see BUGS). They will both be prepended to
@INC. Note that
@INCis not changed for the entire request, so dont count on that path being in
@INCfor your scripts.
This directives specifies the files you want reloaded. Depending on where this directive sits, files will be loaded (and perhaps unloaded). Ie. if this sits in a
Locationsection, the files will only be reloaded on requests to that location. If this lies in a server section, all requests to the server or v-host will have these files reloaded.
Under some setups,
PerlModule'ing PerlVINC will cause the server to silently crash on startup. Upgrading
Apache::ExtUtils to v/1.04 might fix the problem. As of this writing, the current version of mod_perl (1.24) does not contain this version of
Apache::ExtUtils. Until the next version is released, you will have to obtain it from the latest cvs snapshot.
PerlINC directive is used twice in the same config section, the first call will be overwritten. Ie.
PerlINC /qwe PerlINC /poi <Location /asdf/> PerlINC /zxc </Location>
For requests outside of /asdf/, @INC will contain /poi. Inside /asdf/ @INC will contain /zxc and /poi. This is kinda sucky, I know, and I hope to fix for the next release.
Doug MacEachern <email@example.com> Dave Moore <firstname.lastname@example.org>
This library is free software. You can redistribute it and/or modify it under the same terms as Perl itself.