GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  CGI::BUILDER::CONF (3)

.ds Aq ’

NAME

CGI::Builder::Conf - Add user editable configuration files to your WebApp

CONTENTS

SYNOPSIS



  use CGI::Builder
  qw| CGI::Builder::Conf
    | ;
 
  # in the instance script
  $webapp = My::WebApp->new( conf_file => /path/to/conf_file.mml )
  $webapp = My::WebApp->new( conf_file => [ /path/to/conf_file.mml,
                                            /other_conf_file.mml ]
                           , conf_mml_options => .... )
 
  # optionally in the CBB
  My::WebApp->conf_mml_options ( .... );   # IO::Util::load_mml options



DESCRIPTION

This Extension adds another way to pass arguments to the new method: a user editable MML file (see Minimal Markup Language (MML) in IO::Util). This is useful when you want to give to other people (e.g. your client) the possibility to configure their own application instance, but you don’t want to give them the possibility to edit and run a potentially unsecure perl script.

You can do so by passing to the new method the full path to a list of conf_file; the mixed structure of their data will be loaded as the default arguments for that instance (see OPTIONS in Class::constr).

<B>Important NoteB>: Please notice that the data contained in the conf_file is tainted however, so treat that with care (e.g. as they were query parameters).

PROPERTY AND GROUP ACCESSORS

    conf_file

This property access and sets the full path to the MML configuration files. You can pass a single path or a list of paths: in that case the data in the next file will override the previous one. You will usually set it with the new() method or by overriding the property.

    conf_mml_options

This is a Class property group accessor, which allows you to define the IO::Util::load_mml options used to load the conf_file. By default it has a true optional option (i.e. it won’t croak for missing conf_file), and a ’TRIM_BLANKS’ filter.

    conf_options

Deprecated alias for conf_mml_options.

SUPPORT

See SUPPORT in CGI::Builder.

AUTHOR and COPYRIGHT

X 2004 by Domizio Demichelis.

All Rights Reserved. This module is free software. It may be used, redistributed and/or modified under the same terms as perl itself.

POD ERRORS

Hey! <B>The above document had some coding errors, which are explained below:B>
Around line 104: Non-ASCII character seen before =encoding in ’X’. Assuming ISO8859-1
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 CGI::BUILDER::CONF (3) 2006-03-25

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.