Breeze: login, register, reset

Laravel Breeze îți dă un sistem de autentificare complet și minimal, cu cod pe care îl deții și îl poți modifica. E punctul de plecare recomandat pentru majoritatea proiectelor noi.

Instalare și ce primești

composer require laravel/breeze --dev
php artisan breeze:install blade
php artisan migrate
npm install && npm run dev

Rutele generate

• GET/POST `/register` — înregistrare.
• GET/POST `/login` — autentificare.
• POST `/logout`.
• GET/POST `/forgot-password`, `/reset-password` — resetare.
• GET `/verify-email`, etc. — verificare email.

Cum funcționează login-ul

// app/Http/Requests/Auth/LoginRequest.php (generat)
public function authenticate(): void
{
    $this->ensureIsNotRateLimited();

    if (! Auth::attempt($this->only("email", "password"), $this->boolean("remember"))) {
        RateLimiter::hit($this->throttleKey());
        throw ValidationException::withMessages(["email" => __("auth.failed")]);
    }

    RateLimiter::clear($this->throttleKey());
}

Sesiunea

După `Auth::attempt()` reușit, Laravel regenerează ID-ul de sesiune (previne fixarea) și stochează ID-ul utilizatorului. La cererile următoare, middleware-ul `auth` verifică sesiunea și populează `auth()->user()`.

Personalizare

Codul e al tău: modifici vederile din `resources/views/auth/`, adaugi câmpuri la înregistrare (modifici RegisteredUserController și migrația), schimbi redirect-urile în `RouteServiceProvider` sau în controllere.

Adăugarea unui câmp la înregistrare

// RegisteredUserController::store
$request->validate([
    "name" => ["required", "string", "max:255"],
    "nume_firma" => ["nullable", "string", "max:255"],
    "email" => ["required", "email", "unique:users"],
    "password" => ["required", "confirmed", Rules\Password::defaults()],
]);

$user = User::create([
    "name" => $request->name,
    "nume_firma" => $request->nume_firma,
    "email" => $request->email,
    "password" => Hash::make($request->password),
]);

Exercițiu

Instalează Breeze. Testează fluxul complet: înregistrare, logout, login, „am uitat parola". Apoi personalizează: adaugă un câmp la înregistrare (cu migrație și validare) și schimbă pagina unde ajungi după login.

Greșeli frecvente

• Uiți npm run dev și paginile de auth nu au stiluri.
• Modifici comportamentul de login fără să păstrezi rate limiting-ul.
• Adaugi câmp la înregistrare dar uiți să-l pui în $fillable / migrație.
• Nu rulezi migrate și tabelul users e incomplet.

De reținut

• Breeze = auth complet, cod deținut de tine.
• Rute pentru register/login/logout/reset/verify.
• Auth::attempt() + regenerarea sesiunii.
• Personalizezi vederile și controllerele direct.

Pe scurt

Breeze îți dă baza de autentificare în câteva comenzi. De acolo, codul e al tău să-l adaptezi.

Pentru proiectul didactic Laravel 11, verifică documentația starter kitului compatibil înainte de instalare.
Scenarii: parolă greșită; login valid; logout; link reset invalid; link reset folosit; login cu parola nouă.
Mail de test: fake sau log local, fără expediere externă.
Nu păstra: parole în loguri sau fixtures reale.

Documentație și surse

• Documentația Laravel 11 — versiunea aplicației demonstrative — Laravel
• OWASP Top 10 — OWASP