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 Tue, 04 Jun 2002 10:11:42 GMT
stas        2002/06/04 03:11:42

  Modified:    src/docs/2.0/user/config config.pod
  Log:
  documenting the added MODPERL2 define and extending on IfDefine in general
  
  Revision  Changes    Path
  1.15      +58 -0     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.14
  retrieving revision 1.15
  diff -u -r1.14 -r1.15
  --- config.pod	4 Jun 2002 10:01:49 -0000	1.14
  +++ config.pod	4 Jun 2002 10:11:42 -0000	1.15
  @@ -454,8 +454,66 @@
   
   
   
  +=head1 Server Startup Define Option Retrieval
   
  +Inside I<httpd.conf> one can do conditional configuration based on the
  +define options passed at the server startup. For example:
   
  +  <IfDefine PERLDB>
  +      <Perl>
  +          use Apache::DB ();
  +          Apache::DB->init;
  +      </Perl>
  +    
  +      <Location />
  +          PerlFixupHandler Apache::DB
  +      </Location>
  +  </IfDefine>
  +
  +So only when the server is started as:
  +
  +  % httpd C<-DPERLDB> ...
  +
  +The configuration inside C<IfDefine> will have an effect. If you want
  +to have some configuration section to have an effect if a certain
  +define wasn't defined use C<!>, for example here is the opposite of
  +the previous example:
  +
  +  <IfDefine !PERLDB>
  +      # ...
  +  </IfDefine>
  +
  +If you need to access any of the startup defines in the Perl code you
  +use C<Apache::exists_config_define>. For example in a startup file you
  +can say:
  +
  +  use Apache::ServerUtil ();
  +  if (Apache::exists_config_define("PERLDB")) {
  +      require Apache::DB;
  +      Apache::DB->init;
  +  }
  +
  +=head2 MODPERL2 Define
  +
  +When running under mod_perl 2.0 a special configuration define
  +C<MODPERL2> is enabled internally, as if the server had been started
  +with C<-DMODPERL2>. For example this can be used to write a
  +configuration file which needs to do something different whether it's
  +running under mod_perl 1.0 or 2.0:
  +
  + <IfDefine MODPERL2>
  +     # 2.0 configuration
  + </IfDefine>
  + <IfDefine !MODPERL2>
  +     # else
  + </IfDefine>
  +
  +From within Perl code this can be tested with
  +C<Apache::exists_config_define()>, for example:
  +
  +  if (Apache::exists_config_define("MODPERL2")) {
  +      # some 2.0 specific code
  +  }
   
   
   =head1 Retrieving Server Startup Options
  
  
  

---------------------------------------------------------------------
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