Download the PHP package sonata/framework without Composer

Sonata Framework

Минималистичный PHP-фреймворк для быстрых API: роутинг на атрибутах, DI-контейнер, DTO-валидация и кеш роутинга.

Установка

Быстрый старт

Минимальная точка входа с роутингом и DI:

Атрибуты (теги)

Используются для маршрутизации и документации:

• #[Controller(prefix: '/api')] — объявляет контроллер и префикс.
• #[Route(path: '/users', method: 'GET', summary: '...', description: '...')] — маршрут метода.
• #[From('json'|'query'|'formData')] — источник данных для DTO.
• #[Inject] — внедрение зависимости в конструктор.
• #[Response(ClassName::class, isArray: true)] — тип ответа для OpenAPI.
• #[Tag('Имя', 'Описание')] — группа в документации.
• #[NoAuth] — пометка метода/контроллера, который не требует авторизации (используется middleware).

Пример:

Команды

В приложении можно добавить команды, которые используют встроенный кеш:

• cache:build — построить кеш маршрутов (через RoutesCache).
• cache:clear — очистить кеш маршрутов.

Middleware

Фреймворк поддерживает цепочку middleware для обработки запроса до контроллера.

Пример подключения:

Middleware получает контекст:

• controller — класс контроллера
• action — метод контроллера
• uri, method
• route

Пример NoAuth

Логика

• Роутинг: Router сканирует контроллеры и строит маршруты по атрибутам. Поддерживаются параметры вида /users/{id}.
• DI: Container автосвязывает зависимости по типам, #[Inject] позволяет указывать явные идентификаторы.
• Валидация: DTO наследуется от ParamsDTO и валидируется через symfony/validator.
• Кеш: RoutesCache кеширует список маршрутов, OpenApiCache — OpenAPI-спеку.

MediaHelper

Утилита для загрузки изображений, видео и документов из $_FILES.

Пример:

Настройки через env:

• MEDIA_UPLOAD_BASE — базовая папка загрузки (по умолчанию /upload-next).

Переменные окружения

• SONATA_BASE_PATH — базовая директория приложения (для сканирования и кешей).
• APP_ENV — режим (dev/prod), влияет на кеши.