# Тестовое задание

**Версия php** 8.5

**Laravel** 12

Контейнер с приложением работает на frankenphp

**На хост машине**

```bash
make help
make build
make install # копирует .env.example в рабочий .env, для удобства,так же запускает миграции
make run # заполнит базу и запустит тесты
```

Необходимо задать переменные окружения

```dotenv
DB_CONNECTION=mysql
DB_HOST=mysql
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=laravel
DB_PASSWORD=secret
```

Так же необходимо настроить сервисы, например через внешние .env
Сейчас доступы хардкод в compose.yaml

```yaml
  mysql:
    image: mysql:8.4.8
    container_name: laravel_mysql
    restart: unless-stopped
    ports:
      - "127.0.0.1:3306:3306"
    environment:
      MYSQL_ROOT_PASSWORD: secret
      MYSQL_DATABASE: laravel
      MYSQL_USER: laravel
      MYSQL_PASSWORD: secret
    volumes:
      - mysql:/var/lib/mysql
    networks:
      - laravel_network
    healthcheck:
      test: [ "CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-psecret" ]
      timeout: 10s
      retries: 5
      start_period: 30s
      interval: 30s
  phpmyadmin:
    image: phpmyadmin/phpmyadmin
    container_name: laravel_phpmyadmin
    restart: unless-stopped
    ports:
      - "127.0.0.1:8585:80"
    environment:
      PMA_HOST: mysql
      PMA_PORT: 3306
      PMA_USER: laravel
      PMA_PASSWORD: secret
      PMA_ARBITRARY: 1
    depends_on:
      mysql:
        condition: service_healthy
    networks:
      - laravel_network
```

## Маршруты

**/api namespace**

```php
Route::prefix('tasks')->name('tasks.')->group(function () {
    Route::get('/', [TaskController::class, 'index'])->name('index');
    Route::post('/', [TaskController::class, 'store'])->name('store');
    Route::get('/{task}', [TaskController::class, 'show'])->name('show');
    Route::match(['put', 'patch'], '/{task}', [TaskController::class, 'update'])->name('update');
    Route::delete('/{task}', [TaskController::class, 'destroy'])->name('destroy');
});
```

Роуты не защищал, установлен пакет laravel/sanctum, можно настроить токены\

Родительский контроллер использует AuthorizesRequests, можно реализовать Policy

```php
<?php

namespace App\Http\Controllers;

use Illuminate\Foundation\Auth\Access\AuthorizesRequests;
use Illuminate\Routing\Controller as BaseController;

abstract class Controller extends BaseController
{
    use AuthorizesRequests;
}
```

Пример реализации

```php
// в конструкторе контроллера
public function __construct()
{
    $this->authorizeResource(Task::class, 'task');
}
```

**Тесты**

[Feature](laravel/tests/Feature/TaskControllerTest.php)

[Unit](laravel/tests/Unit/QueryFilterPipelineTest.php)

**Расширение фильтров**

[Конфиг](laravel/config/filters.php)

Фильтры должны реализовывать FilterInterface для работы в Pipeline

Requests содержащие фильтры должны реализовывать RequestFilterInterface

### Документация API

[Task](docs/task.md)