Конфигурация ядра

Документ описывает, где хранятся конфигурации, что задаётся через .env, что через PHP-конфиги, а что зашито в коде. Понимание этого критично для деплоя и отладки.

1. Типы конфигурации

2. Переменные окружения (.env)

Файл .env (загружается vlucas/phpdotenv, не коммитится). Эталон — .env.example.

Обязательные:

Опциональные (есть дефолт в params.php):

3. Файлы config/*.php

3.1. config/params.php

Общие параметры (читаются из .env):

return [
    'adminEmail'    => $_ENV['ADMIN_EMAIL'],
    'senderEmail'   => $_ENV['SENDER_EMAIL'],
    'senderName'    => $_ENV['SENDER_NAME'],
];

3.2. config/db.php

Параметры подключения к MySQL:

return [
    'class'     => 'yii\db\Connection',
    'dsn'       => $_ENV['DB_DSN'],
    'username'  => $_ENV['DB_USERNAME'],
    'password'  => $_ENV['DB_PASSWORD'],
    'charset'   => 'utf8',
];

3.3. config/web.php

Основная конфигурация веб-приложения. Содержит:

• Пути к модулям — перечисление $diConfigs (файлы modules/*/config/di.php).
• Middleware — on beforeRequest (PassportAuth + RBAC).
• Компоненты:
  • request: парсеры (JSON, multipart), cookieValidationKey.
  • response: JSON, UTF-8.
  • cache: yii\caching\FileCache.
  • user: identityClass = YiiIdentity, autoLogin/Session = false.
  • errorHandler: JsonErrorHandler.
  • mailer: SMTP-транспорт из .env.
  • log: fileTarget, уровни error/warning, exclude 404.
  • db: коннекшен из db.php.
  • urlManager: pretty URLs, rules (модули + ядро).
• Параметры (params).
• Dev-блок: при YII_ENV_DEV добавляет модули debug и gii.

Что задаётся в коде (жёстко):

• defaultPageSize = 20, pageSizeLimit = [1, 1000] (в BaseController).
• Charset таблиц: ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci (в миграциях).
• showScriptName = false, enablePrettyUrl = true.

3.4. config/console.php

Конфигурация для консольных команд (php yii ...). Отличается от web.php:

• Нет beforeRequest middleware.
• Свои компоненты: Redis-кэш (вместо FileCache), нет модулей (только projects + tasks DI).
• controllerMap: email-send, migrate (с миграциями).

3.5. config/modules.php

Реестр модулей — список ['class', 'controllerNamespace']:

'auth' => ['class' => 'modules\\passport\\auth\\Module', 'controllerNamespace' => …],
'tasks', 'projects', 'rbac', 'feedback'

3.6. config/container.php

DI-контейнер ядра. Регистрирует:

• Репозитории (синглтоны):
  • DbRoleRepository, DbUserRepository, DbUserRoleRepository, DbUserRoleSearch, DbTransactionManager.
• Хендлеры (синглтоны): все хендлеры ролей, пользователей, user-role.
• Redis (новая инстанция при каждом $container->get(Redis::class)).
• NotificationHub + каналы (PushChannel → Redis, EmailChannel → SENDER_EMAIL/NAME, TelegramChannel).
• IEventDispatcher (синглтон GlobalEventDispatcher).

3.7. config/migration_namespaces.php

Пространства имён для миграций (используется при php yii migrate):

'core\\infrastructure\\migrations',
'modules\\rbac\\infrastructure\\migrations',
'modules\\tasks\\infrastructure\\migrations',
'modules\\projects\\infrastructure\\migrations',
'modules\\feedback\\infrastructure\\migrations',

3.8. config/test.php и config/test_db.php

Конфигурации для тестов. test_db.php может переопределять db.

4. Что задаётся в коде (жёстко) и почему

5. Миграции