perl-docs-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From s...@apache.org
Subject cvs commit: modperl-docs/src/docs/2.0/user/config config.pod
Date Sun, 19 Oct 2003 19:19:33 GMT
stas        2003/10/19 12:19:33

  Modified:    src/docs/2.0/user/config config.pod
  Log:
  document ways to modify @INC
  
  Revision  Changes    Path
  1.48      +57 -3     modperl-docs/src/docs/2.0/user/config/config.pod
  
  Index: config.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/2.0/user/config/config.pod,v
  retrieving revision 1.47
  retrieving revision 1.48
  diff -u -u -r1.47 -r1.48
  --- config.pod	14 Oct 2003 18:36:56 -0000	1.47
  +++ config.pod	19 Oct 2003 19:19:32 -0000	1.48
  @@ -1179,11 +1179,65 @@
   META: need help to write the tutorial section on this with examples.
   
   
  -=head1 General Issues
  +=head1 Adjusting C<@INC>
  +
  +You can always adjust contents of C<@INC> before the server
  +starts. There are several ways to do that.
  +
  +=over
  +
  +=item * I<startup.pl>
  +
  +In L<the startup file|/Startup_File> you can use the C<lib> pragma
  +like so:
  +
  +  use lib qw(/home/httpd/project1/lib /tmp/lib);
  +  use lib qw(/home/httpd/project2/lib);
  +
  +=item * I<httpd.conf>
  +
  +In I<httpd.conf> you can use the C<PerlSwitches> directive to pass
  +arguments to perl as you do from the command line, e.g.:
  +
  +  PerlSwitches -I/home/httpd/project1/lib -I/tmp/lib
  +  PerlSwitches -I/home/httpd/project2/lib
   
  -=head2 Is There a Way to Modify C<@INC> on a Per-VirtualHost
  +=back
   
  -You can, using the L<PerlOptions +Parent|/C_Parent_> option.
  +=head2 C<PERL5LIB> and C<PERLLIB> Environment Variables
  +
  +The effect of the C<PERL5LIB> and C<PERLLIB> environment variables on
  +C<@INC> is described in the I<perlrun> manpage. mod_perl 2.0 doesn't
  +do anything special about them.
  +
  +It's important to remind that both C<PERL5LIB> and C<PERLLIB> are
  +ignored when the taint mode (C<PerlSwitches -T>) is in effect. Since
  +you want to make sure that your mod_perl server is running under the
  +taint mode, you can't use the C<PERL5LIB> and C<PERLLIB> environment
  +variables.
  +
  +=head2 Modifying C<@INC> on a Per-VirtualHost
  +
  +If Perl used with mod_perl was built with ithreads support one can
  +specify different C<@INC> values for different VirtualHosts, using a
  +combination of C<L<PerlOptions +Parent|/C_Parent_>> and
  +C<L<PerlSwitches|/C_PerlSwitches_>>. For example:
  +
  +  <VirtualHost ...>
  +      ServerName dev1
  +      PerlOptions +Parent
  +      PerlSwitches -I/home/dev1/lib/perl
  +      PerlModule Apache2
  +  </VirtualHost>
  +
  +  <VirtualHost ...>
  +      ServerName dev2
  +      PerlOptions +Parent
  +      PerlSwitches -I/home/dev2/lib/perl
  +      PerlModule Apache2
  +  </VirtualHost>
  +
  +=head1 General Issues
   
   
   =head1 Maintainers
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-cvs-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-cvs-help@perl.apache.org


Mime
View raw message