nimbly / caboodle
Configuration and settings manager with autoloading from disk or AWS Secrets Manager.
Installs: 6 222
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 2
Forks: 0
Open Issues: 0
Requires
- php: ^8.0
- psr/container: ^1.0|^2.0
Requires (Dev)
- aws/aws-sdk-php: ^3.110
- php-coveralls/php-coveralls: ^2.1
- phpunit/phpunit: ^9.0
- symfony/var-dumper: ^4.3
- vimeo/psalm: ^4.0
Suggests
- aws/aws-sdk-php: For using AwsLoader to load configurations from AWS Secrets Manager.
README
A simple PSR-11 compliant configuration manager with lazy loading from files, AWS Secrets Manager, or any other source.
Installation
composer require nimbly/config
Usage
Instantiate the Config
manager with an array of LoaderInterface instances. You may specify as many loaders as you"d like - or none at all.
$config = new Config([ new FileLoader(__DIR__ . "/config") ]);
Get data from config.
$config->get("database.hostname");
Loaders
Loaders are responisble for accepting a key
, loading, and then passing the data back.
Two loaders are provided out of the box: FileLoader
and AwsLoader
but a LoaderInterface
is provided for implementing any other loader.
FileLoader
The FileLoader
will attempt to load configuration data from the local filesystem.
Instantiate the FileLoader
with a path to your configuration files.
new FileLoader("/path/to/config/files");
Configuration files should return an associative array of your configuration data.
<?php // file: config/database.php return [ "host" => "localhost", "port" => 1234, "user" => "dbuser", "password" => "dbpassword", ];
AwsLoader
The AwsLoader
will attempt to load configuration data from AWS Secrets Manager.
NOTES
- If your AWS Secrets Manager keys include dots ("."), the loader will not be able to resolve the key name properly. It is suggested that your AWS keys be of the form
prod/db/default
as suggested by AWS best practices. VersionId
andStageVersion
options are not available with this loader at this time.SecretBinary
values are not supported at this time. The loader will only look for values in theSecretString
property.
Adding loaders dynamically
You can add loaders dynamically.
$config->addLoader( new FileLoader(__DIR__ . "/config") );
Accessing values
Configuration keys can be accessed using a dot-notation syntax with the left most being the key
the loaders will use to resolve and load the configuration data.
$config->get("database.host");
The above would load the contents of the file database.php
from the configuration path passed into the Config
manager.
Your configuration files may contain nested associative arrays that can be accessed using the same dotted notation.
$config->get("database.connections.default.host");
PSR-11 note
By default, Caboodle will return a null
if an item is not found in the item store.
However, PSR-11 states that when an item is not found, it should throw an instance of NotFoundExceptionInterface
.
If you would like Caboodle to throw an exception when an item is not found, you may call the setThrowIfNotFound()
method.
$config->setThrowIfNotFound(true);
Key hinting
By default, the root key name is assumed to be everything before the first dot ("."). However, if the root key name includes a dot, you can hint the key name by using a single hash mark in place of a dot.
For example:
$config->get("prod.database#connections.default.hostname");
Manually adding values
You may also manually add new key / value pairs into the configuration manager.
$config->add("queue", [ "name" => "jobs", "host" => "localhost", "port" => 1234 ]);
Or you may assign the entire contents of the configuration data.
$config->setItems([ "key1" => "value1", "key2" => [ "key3" => "value3" ] ]);