---
name: "Config::Onion::Simple"
section: "3pm"
platform: "linux"
package: "libconfig-onion-perl"
version: "1.007-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Config::Onion::Simple"
---

# Config::Onion::Simple(3pm)

Simple interface to a Config::Onion singleton

## NAME

Config::Onion::Simple - Simple interface to a Config::Onion singleton

## VERSION

version 1.007

## SYNOPSIS

```
  use Config::Onion::Simple qw( cfg cfg_obj );
  cfg_obj->load('myapp');
  my $setting = cfg->{setting};
```

## DESCRIPTION

It is often useful for a single master configuration to be shared across multiple modules in an application.  Config::Onion::Simple provides an interface to do this without requiring any of those modules to know about each other.

## EXPORTABLE FUNCTIONS

Config::Onion::Simple exports nothing by default.  The following functions are exported only on request.

### cfg

Returns a reference to the complete configuration hash managed by the Config::Onion singleton.  This hash should be treated as read-only, as any changes will be lost if the configuration is altered using the underlying Config::Onion instance's methods.

Calling `"cfg"` is equivalent to calling `"cfg_obj->get"`.

### cfg\_obj

Returns a reference to the Config::Onion singleton.  Use this object's methods to make any changes to the configuration.

## SEE ALSO

Config::Onion

## AUTHOR

Dave Sherohman \<dsheroh@cpan.org\>

## COPYRIGHT AND LICENSE

This software is copyright (c) 2012 by Lund University Library.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.