Download the PHP package nimbly/caboodle without Composer
On this page you can find all versions of the php package nimbly/caboodle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download nimbly/caboodle
More information about nimbly/caboodle
Files in nimbly/caboodle
Package caboodle
Short Description Configuration and settings manager with autoloading from disk or AWS Secrets Manager.
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package caboodle
Caboodle
A simple PSR-11 compliant configuration manager with lazy loading from files, AWS Secrets Manager, or any other source.
Installation
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.
Get data from config.
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.
Configuration files should return an associative array of your configuration data.
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/defaultas suggested by AWS best practices. VersionIdandStageVersionoptions are not available with this loader at this time.SecretBinaryvalues are not supported at this time. The loader will only look for values in theSecretStringproperty.
Adding loaders dynamically
You can add loaders dynamically.
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.
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.
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.
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:
Manually adding values
You may also manually add new key / value pairs into the configuration manager.
Or you may assign the entire contents of the configuration data.
