dare-laravel-api

/dare-laravel-api

Padrões DARE para APIs REST em Laravel 11 + PHP 8.3. Strict Types, FormRequests, Services, Resources, Repositories, Eloquent + casts, tratamento global de exceções, testes Pest, PHPStan/Larastan nível 8.

Como usar

/dare-laravel-api                          # audita projeto Laravel
/dare-laravel-api scaffold users           # gera CRUD com camadas
/dare-laravel-api migrate-controllers      # extrai lógica de Controllers para Services

Stack canônica

• PHP 8.3 com declare(strict_types=1); em todo arquivo
• Laravel 11.x modo API
• PostgreSQL 16 ou MySQL 8
• Pest para testes (ou PHPUnit 11)
• PHPStan + Larastan nível 8
• Pint para formatação
• Sanctum para auth

Layered Design

Camada	Pasta Laravel
Handler	app/Http/Controllers/
Service	app/Services/
Repository	app/Repositories/
Model	app/Models/
Presenter	app/Http/Resources/

Controllers (Handler)

<?php declare(strict_types=1);

namespace App\Http\Controllers;

use App\Http\Requests\StoreUserRequest;
use App\Http\Resources\UserResource;
use App\Services\RegisterUser;

final class UserApiController extends Controller
{
    public function __construct(private RegisterUser $service) {}

    public function store(StoreUserRequest $request): UserResource
    {
        $user = $this->service->execute($request->validated());
        return new UserResource($user);
    }
}

Regras:

• Apenas: recebe → valida via FormRequest → chama Service → retorna Resource
• NUNCA: query Eloquent, lógica de negócio, validação inline

FormRequests

final class StoreUserRequest extends FormRequest
{
    public function authorize(): bool { return $this->user()->can('create', User::class); }

    public function rules(): array {
        return [
            'email' => ['required', 'email', 'unique:users,email'],
            'password' => ['required', 'string', 'min:12'],
        ];
    }
}

Services

Uma operação por classe: