Используем много конфигураций в одном приложении

Сегодняшняя статья является переводом "Manage application configuration in different modes" из Cookbook. При создании нашего приложения единственным параметром который мы можем передать в Yii::createWebApplication - является ссылка на файл конфигурации, согласно которому оно и будет работать. С другой стороны было бы отлично если приложение могло бы использовать разные конфигурационные файлы для некоторых случаев. Например, может потребоваться применять различные конфигурационные файлы при работе в обычном режиме, в режиме разработки и режиме тестирования; В крупных командах разработчики часто работают со своим собственным слепком базы данных, параметрами и конфигурацией. В этом руководстве вы получите практические знания по всем выше перечисленным ситуациям и научитесь использовать разные конфигурационные файлы для своих нужд.

---

Прежде чем начать, мы должны отметить что конфигурация приложения в Yii хранится в виде PHP файла (protected/config/main.php). В результате мы можем разместить в нем любой рабочий PHP скрипт что сделает нашу конфигурацию более "умной", чем простое возвращение массива из параметров и значений.

Во-первых, создаем файл main.php с конфигурацией приложения по умолчанию которую мы хотим использовать.

Во-вторых, создаем файл dev.php который будет содержать в себе конфигурацию разработчиков. К примеру в этой конфигурации мы можем использовать другую базу данных, выводить дебагер на экран и многое другое. Поскольку основные параметры приложения у нас находятся в main.php файле, то dev.php должен просто наследовать файл main.php и переопределять необходимые параметры конфигурации. Для того чтобы осуществить наследование мы используем CMap:: mergeArray. Файл dev.php будет выглядеть следующим образом:

<?php
return CMap::mergeArray(
    require(dirname(__FILE__).'/main.php'), 
    array(
        'components'=>array(
            'db'=>array(
                // define DB connection used for development
            ),
        ),
    )
);

В начале мы подключили файл main.php который содержит в себе конфигурацию по умолчанию, после этого в виде массива указали конфигурацию для dev.php. (в примере выше показано как использовать индивидуальную конфигурацию DB отличную от main.php). В конечном итоге происходит возврат результата слияния этих двух массивов. Имейте ввиду что мы не должны использовать array_merge() или array_merge_recursive() функции.

Аналогичным образом мы можем создать с вами тестовую конфигурацию и сохранить её в файле test.php

Для того чтобы запустить приложения в разных режимах (обычный режим, режим разработчика, режим тестирования) мы должны с вами в файле index.php в метод Yii::createWebApplication передать название соответствующего файла конфигурации. Что бы спасти вас от постоянного изменения файла index.php что бы запускать приложение под новой конфигурацией - мы можем создать отдельный загрузочный файл для каждого из сценариев. Например, мы можем создать index.php, index_dev.php, index_test.php которые будут полностью идентичны кроме значения в Yii::createWebApplication (для index_dev.php вы укажите "dev.php", для index.php - "main.php" и т.д).

Теперь что бы загрузить наше приложение в обычном режиме в браузере мы используем index.php (localhost/index.php), для загрузки конфигурации разработчиков в браузере мы используем index_dev.php (localhost/index_dev.php) соответственно.

Подсказка: Используя описанную выше технику вы также можете использовать разные параметры (указанные через Yii::app()->params) для различных режимов загрузки.

Ссылка на "Manage application configuration in different modes"  (Англ.)

// берем переменную окружения

defined('APPLICATION_ENV')

    || define('APPLICATION_ENV', (getenv('APPLICATION_ENV') ? getenv('APPLICATION_ENV') : 'production'));

...

// конфиг по имени нашей переменной окружения

$config=dirname(__FILE__).'/protected/config/' . APPLICATION_ENV . '.php';

<?php



$config = array();



$config['basePath'] = dirname(__FILE__).DIRECTORY_SEPARATOR.'..';

$config['name'] = 'DbHelp.ru';

$config['defaultController'] = 'post'; 

$config['preload'] = array('log');



$config['import'][] = 'application.models.*';

$config['import'][] = 'application.components.*';



и т.д.



return $config;