⚡ Esora Документация

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.