Feature-Driven архитектура
Назначение и когда использовать
Feature — автономный бизнес-модуль с routes, контроллерами, шаблонами, assets, migrations и tests. Используйте feature для каждого bounded context; не раскладывайте связанные сценарии по глобальным папкам.
Создание и регистрация
php bin/console make:feature Blog
Ожидаемая структура:
app/Features/Blog/
├── Controllers/ ├── templates/ ├── routes.php
├── migrations/ ├── assets/ └── tests/
FeatureManager получает featuresPath, а FeatureRegistry сканирует непосредственные подкаталоги. FeatureManager::getFeatures(), getFeature(string $name), getRegistry(), getMigrationPaths() позволяют инспектировать результат. При старте bootFeatures() подключает routes и namespace шаблонов.
Для production скомпилируйте manifest:
php bin/console feature:list
php bin/console feature:cache
# после изменения структуры:
php bin/console feature:clear && php bin/console feature:cache
Lifecycle
Discovery → manifest (или cache) → bootFeatures() → routes/templates → HTTP request → feature test. Миграции feature собираются мигратором из migration paths.
Troubleshooting
- Feature не видна: имя каталога должно быть прямым потомком
app/Features. - Старые routes: очистите feature cache.
- Namespace шаблона: используйте имя feature, например
Blog::index.