Help-Site Computer Manuals
Software
Hardware
Programming
Networking
  Algorithms & Data Structures   Programming Languages   Revision Control
  Protocols
  Cameras   Computers   Displays   Keyboards & Mice   Motherboards   Networking   Printers & Scanners   Storage
  Windows   Linux & Unix   Mac

Apache2::ASP::GlobalConfig
Config manager for Apache2::ASP web applications

Apache2::ASP::GlobalConfig - Config manager for Apache2::ASP web applications



NAME

Apache2::ASP::GlobalConfig - Config manager for Apache2::ASP web applications


SYNOPSIS


  my $global = Apache2::ASP::GlobalConfig->new();

  

  # Find config based on $ENV{HTTP_HOST} or `domain`:

  my $current = $global->find_current_config();

  

  # Find config for a specific domain:

  my $domain_config = $global->domain_config( 'whatever.com' );

  

  # Get a list of all web application configs:

  my @configs = $global->web_applications;


DESCRIPTION

Apache2::ASP::GlobalConfig attempts to keep all of your web applications' configuration data in one place:

Your /conf/apache2-asp-config.xml file.

It should look like this:


  <?xml version="1.0" ?>

  <config>

    <web_application>

      <domain_re>.*</domain_re>

      <do_reload_on_script_change>1</do_reload_on_script_change>

      <application_name>DefaultApp</application_name>

      <application_root>@ServerRoot@</application_root>

      <handler_root>@ServerRoot@/handlers</handler_root>

      <media_manager_upload_root>@ServerRoot@/MEDIA</media_manager_upload_root>

      <www_root>@ServerRoot@/htdocs</www_root>

      <page_cache_root>@ServerRoot@/PAGE_CACHE</page_cache_root>

      <application_state>

        <manager>Apache2::ASP::ApplicationStateManager::MySQL</manager>

        <dsn>DBI:mysql:dstack_dev:localhost</dsn>

        <password>j@p@n</password>

        <username>root</username>

      </application_state>

      <session_state>

        <manager>Apache2::ASP::SessionStateManager::SQLite</manager>

        <cookie_domain>apache2-asp.no-ip.org</cookie_domain>

        <cookie_name>session-id</cookie_name>

        <dsn>DBI:mysql:dstack_dev:localhost</dsn>

        <password>j@p@n</password>

        <username>root</username>

        <session_timeout>30</session_timeout>

      </session_state>

      <settings>

        <lib>@ServerRoot/lib</lib>

        <dsn>DBI:mysql:dbname:hostname</dsn>

        <username>my-username</username>

        <password>swordfish</password>

      </settings>

    </web_application>

  </config>

If it doesn't look like that, an exception will be thrown.

Those little @ServerRoot@ tags are replaced with the value of $ENV{APACHE2_ASP_APPLICATION_ROOT} when the XML file is loaded up and parsed.

For more information about setting up the config file and where it goes, please read the Apache2::ASP::Manual::ConfigXML manpage.


METHODS

find_current_config( )

Returns the current the Apache2::ASP::Config manpage object in use. This is determined by calling domain_config and passing in either $ENV{HTTP_HOST} or the value returned by Sys::Hostname::hostname(). See the Sys::Hostname manpage for details on how it works.

domain_config( $hostname )

Returns the the Apache2::ASP::Config manpage object whose <domain_re> matches $hostname.

web_applications( )

Returns a list of the Apache2::ASP::Config manpage objects - one per <web_application> element in the XML config file.


BUGS

It's possible that some bugs have found their way into this release.

Use RT http://rt.cpan.org/NoAuth/Bugs.html to submit bug reports.


HOMEPAGE

Please visit the Apache2::ASP homepage at http://apache2-asp.no-ip.org/ to see examples of Apache2::ASP in action.


AUTHOR

John Drago mailto:jdrago_999@yahoo.com


COPYRIGHT AND LICENSE

Copyright 2007 John Drago, All rights reserved.

This software is free software. It may be used and distributed under the same terms as Perl itself.

Programminig
Wy
Wy
yW
Wy
Programming
Wy
Wy
Wy
Wy