Car Ads API

Гид по запуску проекта на Yii2 с использованием Docker.

---

Шаг 1. Первый запуск (Сборка)

Если вы запускаете проект в первый раз, выполните эту команду (она соберет образы и запустит контейнеры):

docker-compose up -d --build

Для последующих запусков используйте короткую версию:

docker-compose up -d

Шаг 2: Настройка PHP и Базы данных

Выполните установку зависимостей и примените миграции (таблицы в Postgres):

docker exec -ti php bash
cd app
composer install
php yii migrate --interactive=0

Шаг 3: Перезагрузка Nginx (при необходимости)

Если вы меняли конфигурационные файлы веб-сервера:

docker exec -ti nginx nginx -s reload

Шаг 4: Тестирование в Postman

Импортируйте файл коллекции из корня проекта:

www/app/car_ads.postman_collection.json

Основные запросы:

GET /car/list?page=1 — Получить список объявлений.

GET /car/view?id=1 — Посмотреть детали одного авто.

POST /car/create — Создать новое объявление (JSON).

Архитектура проекта

Проект построен на Clean Architecture (без использования ActiveRecord для скорости):

• Entities: Чистые объекты данных (Car, CarOption).
• Mappers: Слой преобразования БД <-> Объект <-> JSON.
• Repositories: Прямая работа с SQL через Query Builder.
• UseCases: Слой бизнес-логики (сохранение с транзакциями, поиск).
• Filters (DTO): Валидация входящих данных.