Download the PHP package werx/config without Composer
On this page you can find all versions of the php package werx/config. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package config
Short Description Use environment-specific configuration files in your app.
License MIT
Informations about the package config
werx\config
Use environment-specific configuration files in your app.
Features:
- Multiple Environment Support (example: local/test/prod)
- Extensible Configuration Providers
- Includes an ArrayProvider and JsonProvider out of the box
- Create your own providers by implementing
\werx\config\Providers\ProviderInterface
- Load multiple config files with a single call
Basic Usage
Recommended Directory Structure
For the default config providers, you'll need to create a directory structure somewhere in your project to hold your configuration files.
Recommended structure:
Default configs go in the root config
directory. There must also sub-directories for each environment (local/test/prod) if you want to override the default setting when running in different environments.
Using ArrayProvider
Create a .php file in your config directory that returns an array of config values.
Get an instance of the ArrayProvider
class, passing the path to your config directory to the constructor.
Using JsonProvider
Create a .json file in your config directory that returns an array of config values.
Get an instance of the JsonProvider
class, passing the path to your config directory to the constructor.
Loading A Configuration Group
In this example, you would be loading the array from config.php
in your config directory.
Get A Configuration Value
Get A Default Value
If a configuration item doesn't exist, $config->get()
will return null. You can override the default return value by passing the new default as the 2nd parameter.
Loading Environment-Specific Configuration Group
In this example, you would be loading the array from config.php
and test/config.php
. Keys from test/config.php
will merge with the keys from config.php
.
Note: The merge strategy is similar to that of PHP's native
array_merge
strategy in that keys in the environment-specific config with the same name as those in the default config replace the ones in the default. This merge is recursive, so nested keys follow the same logic as well.
Loading Multiple Configuration Groups
If you have more than one configuration group to load, you can call load()
multiple times, or you can pass an array of config groups.
Avoiding Collisions On Config Property Names
By default, if a configuration property name is found in multiple config files, the config value will be replaced each time that property name is found in a config file. If you prefer, you can tell the loader to index the config container with the name of the config group to prevent name collisions. This is accomplished by passing true
as the second parameter to load()
.
Then to retrieve your indexed property name, call the "magic" method named the same as the config file you loaded.
As with the
get()
method, the seond parameter above is the default value if the config item doesn't exist.
Or you can return all of the items in the 'email' config group as an array by not passing any parameters.
Installation
This package is installable and autoloadable via Composer as werx/config. If you aren't familiar with the Composer Dependency Manager for PHP, you should read this first.
Contributing
Unit Testing
Coding Standards
This library uses PHP_CodeSniffer to ensure coding standards are followed.
I have adopted the PHP FIG PSR-2 Coding Standard EXCEPT for the tabs vs spaces for indentation rule. PSR-2 says 4 spaces. I use tabs. No discussion.
To support indenting with tabs, I've defined a custom PSR-2 ruleset that extends the standard PSR-2 ruleset used by PHP_CodeSniffer. You can find this ruleset in the root of this project at PSR2Tabs.xml
Executing the codesniffer command from the root of this project to run the sniffer using these custom rules.
$ ./codesniffer