https://github.com/phpgt/config
Manage configuration with ini files and environment variables.
https://github.com/phpgt/config
config configuration configuration-file deployment environment-variables ini phpgt
Last synced: about 1 year ago
JSON representation
Manage configuration with ini files and environment variables.
- Host: GitHub
- URL: https://github.com/phpgt/config
- Owner: phpgt
- License: mit
- Created: 2016-02-15T19:10:33.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2024-07-29T15:11:11.000Z (almost 2 years ago)
- Last Synced: 2025-04-19T23:45:21.018Z (about 1 year ago)
- Topics: config, configuration, configuration-file, deployment, environment-variables, ini, phpgt
- Language: PHP
- Homepage: https://www.php.gt/config
- Size: 247 KB
- Stars: 0
- Watchers: 2
- Forks: 2
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Manage configuration with ini files and environment variables.
Manage your project configuration by defining defaults, that can be overridden by ini files and environment variables.
Also provides functionality for generating ini files from the CLI.
Documentation: https://php.gt/docs/config
***
## Example usage - loading project configuration:
A project's configuration can be split across multiple files. The following example shows how a secret can be supplied through the environment, which is used to override the default value defined within config.ini, and also shows how other named config files can be used.
nginx.conf:
```
location ~ \.php$ {
fastcgi_pass unix:/var/run/php/php7.1-fpm.sock;
fastcgi_param database_password super-secret-passw0rd;
include fastcgi_params;
}
```
config.ini:
```ini
[app]
namespace = MyApp
debug = true
logging = verbose
[database]
host = db.example.com
schema = local_shop
username = admin
password = admin_pass
[shopapi]
key = jungfnyyguvffubhgvat
secret = guvfvfnybpnyfubcgurerfabguvatsbelbhurer
```
config.dev.ini:
```ini
[database]
host = localhost
```
example.php:
```php
// Load config.ini
$config = new Config("/path/to/project");
// Note that the database password is overriden in the environment (from nginx)
// and the host is overridden by the development ini file.
echo $config->get("database.host"); // localhost
echo $config->get("database.port"); // 6612
echo $config->get("database.password"); // super-secret-passw0rd
```
## Example usage - generating configuration files:
Sometimes it's useful to generate config files on-the-fly, such as from Continuous Integration scripts. Below shows a quick example of how to generate a `config.deploy.ini` file with a few key-values that will override the default.
```
vendor/bin/config-generate deploy "shopapi.key=test-api-key" "database.schema=local_shop_$BRANCH_NAME"
```
The above command will create a `config.deploy.ini` file (note the first argument of "deploy") and provide overrides for two ini keys using dot notation. Note that because this command will be run within a continuous integration setting, we are expecting there to be a $BRANCH_NAME variable set for us, allowing us to use a schema name containing the current branch.