README

Build configuration array from config files for different app parts.

Installation

Install the package with composer:

composer require alejan/yii2-configloader

Features

You can use this extension to solve some or all of the following tasks:

Build Yii2 configuration arrays for different app parts
Load environment variables from a .env file
Get config options from environment variables
Load environment and local configuration overrides

Usage

1. Initializing

Override the index.php file like this

<?php

use alejan\yii2confload\Config;

require(__DIR__ . '/../../vendor/autoload.php');
require(__DIR__ . '/../../vendor/yiisoft/yii2/Yii.php');
require(__DIR__ . '/../../common/config/bootstrap.php');
require(__DIR__ . '/../config/bootstrap.php');

$config = new Config(__DIR__ . '/../../config', ['db', 'params']);

(new yii\web\Application($config->frontend))->run();

2. Loading configuration

If you override index.php like example from paragraph 1 this extension will be load configuration from such files in configuration folder

main.php - Load as default common config file if file exist
db.php - Setted when create new Config object. Load if file exist
params.php - Setted when create new Config object. Load if file exist
frontend.php - Setted when call $config->frontend. When call $config->backend will be load backend.php
frontend_dev.php - Load if file exist. The 'dev' part is defined by the variable YII_ENV
local_frontend.php - Load if file exist
local_frontend_dev.php - Load if file exist

2.1 Local configuration

By default local configuration files are not loaded. To activate this feature you can either set the ENABLE_LOCALCONF environment variable (either in your server environment or in .env):

ENABLE_LOCALCONF=1

alejan / yii2-configloader

Maintainers

Details