Download the PHP package theiconic/config without Composer
On this page you can find all versions of the php package theiconic/config. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download theiconic/config
More information about theiconic/config
Files in theiconic/config
Package config
Short Description configuration handler for file based configuration
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 config
theiconic/config
General purpose config manager for file-based configuration.
Setup
Concepts
Spaces
Configuration is grouped into configuration spaces. Spaces are managed by the configuration factory.
Multi-file & multi-section configuration
A configuration space can read configuration from several files. The configuration is merged and then flattened by section.
Placeholders
During parsing, pre-defined placeholders will be replaced with the configured replacement values.
Example
So the basic setup looks something like this (modified example based on alice):
Multi-section config format
Configuration files must contain configuration sections. This is the sections in .ini files and the first level array/object items in .php or .json config files.
No sections are pre-selected by default. You will need to explicitly state the sections in code, like so:
Sections will be merged in the order specified, i.e. entries in later sections will override those in earlier sections.
Caching
All configuration is parsed into multidimensional PHP arrays. The arrays are then stored in cache files so that expensive parsing is bypassed.
Cache keys are determined based on
- the list of source files names
- the list on section names.
Cache is automatically validated based on file modification timestamps. Hence, the cache will automatically update itself whenever any of the source configuration files changes.
Parsing
Extendable parsers are used to parse different file formats. Currently implemented parsers are:
- Ini (for .ini files)
- Json (for .json files)
- Php (for .php files)
- Autodetect (automatically picks the right parser based on extension)
- Dummy (for unit tests etc.)
Accessing configuration values
Configuration can be accessed via dot-paths. These paths are dynamically resolved against the internal array-representation of configuration. This allows retrieving individual entries as well as collections of entries.
You can also retrieve the configuration as a flat array of dot-path to value mappings:
Using environment variables
There is no explicit functionality to handle environment variables, however they can be dynamically used in the configurations via the placeholders mechanism:
With these few lines in place, a configuration file could look like this:
License
THE ICONIC config library for PHP is released under the MIT License.
