Quick Navigator

Search Site

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

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages

Manual Reference Pages  -  CONFIG::SETTING (3)

.ds Aq ’


Config::Setting - Perl extension for configuration files.



  use Config::Setting;
  my $stg = Config::Setting->new;
  $stg->get("section", "key");


This module provides an OO interface to a file full of settings. Settings are assumed to be contained in collections (known as sections). Each setting has a key and a value. The value of a setting may refer to other settings using a similiar syntax to variables in perl.

Whilst this module can be used directly it is anticipated that it will be subclassed. This way policy regarding the location and layout of the settings can be determined for your project.


new ( ) The constructor. Takes no arguments.
is_configured ( ) Returns true if more than one configuration file has been found and read.
provider ( ) Returns an object which can be used to collect the contents of files. The default returns a Config::Setting::FileProvider object. You probably want to override this method when you set up your subclass, in order to set the policy for file locations.
parser ( ) Returns a parser object. The default is the Config::Setting::IniParser object. You may want to override this in a subclass if you wish to use an alternative format for your configuration files.
sections ( ) Return a list of which sections are available from this object.
keylist ( SECTION ) Return a list of keys that SECTION contains.
has ( SECTION, KEY ) Returns true if SECTION contains KEY.
expand ( ) Internal use only.
get ( SECTION, KEY ) Return the value of KEY in SECTION. If the value contains any variables of the form ${word}, they will be fully expanded in the return value.

When trying to replace a variable word, first, word will be looked up as a key in the current section. If not found, it will then be looked up sequentially in all the other sections. If still not found, it will be replaced with an empty string.

Expansion is recursive, so an expanded variable can contain other variables.


It would be useful to know where each setting derived from, in order to help debugging.


Dominic Mitchell, <cpan (at)>


Config::Setting::FileProvider, Config::Setting::IniParser, Config::Setting::XMLParser.
Search for    or go to Top of page |  Section 3 |  Main Index

perl v5.20.3 CONFIG::SETTING (3) 2016-03-17

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