Kas yra valdikliai Laravel-e?

Question

Accepted Answer

**Valdikliai** susieja susijusią užklausos tvarkymo logiką į klases. Vietoje visos logikos maršruto uždaruose, valdikliai tvarko programos veiksmus (pvz., visas su vartotoju susijusias operacijas) į metodus — laikydami maršrutus švarūs ir kodą organizuotą.

## Bazinis valdiklis

```php
<?php
class UserController extends Controller {
    public function index() {
        return User::all();              // list users
    }
    public function show(User $user) {   // route model binding — auto-fetch by id
        return $user;
    }
    public function store(Request $request) {
        $validated = $request->validate(['name' => 'required', 'email' => 'required|email']);
        return User::create($validated);  // create
    }
}
```

Sukurkite naudodami Artisan: `php artisan make:controller UserController`. Kiekvienas metodas tvarko vieną veiksmą, o maršrutai nukreipia į juos.

## Išteklių valdikliai (RESTful CRUD)

```php
// generate a controller with all 7 RESTful methods stubbed
// php artisan make:controller PostController --resource

Route::resource('posts', PostController::class);   // maps routes to the methods:
// index() create() store() show() edit() update() destroy()
```

**Išteklių valdiklis** turi standartinių CRUD metodų, suporuotų su `Route::resource` konvenciniu RESTful maršrutavimui — minimalus šabloninis kodas tipiškiems CRUD ištekliams.

## Priklausomybės injektavimas valdikliuose

```php
class OrderController extends Controller {
    // type-hinted dependencies are AUTO-INJECTED by Laravel's service container
    public function __construct(private OrderService $orders) {}

public function store(Request $request, Mailer $mailer) {   // method injection too
        // $request and $mailer are resolved & injected automatically
    }
}
```

Laravel paslaugų konteineris **automatiškai injektuoja** tipo patarimus su priklausomybėmis į valdiklio konstruktorius ir metodus (įskaitant `Request`) — švariai, išbandomas kodas.

## Laikykite valdiklius plonais

```text
✓ Controllers should handle HTTP concerns (validate input, call services, return responses)
✗ Business logic belongs in SERVICES/models, not bloated controllers ("thin controllers")
```

## Kodėl tai svarbu

Valdikliai yra pagrindiniai Laravel statybiniai blokai — jie organizuoja užklausos tvarkymo logiką į kohezyvias klases, kurios būtinos bet kuriai programai, viršijančiai nereikšmingus maršrutus.

Suprati, kaip kurti valdiklius, susieti maršrutus su jų metodais ir ypač naudoti **išteklių valdiklius** su `Route::resource` (konvenciniams RESTful CRUD su minimaliu šabloniniu kodu) yra kasdieninės žinios, reikalingos Laravel programoms kurti.

Pagrindinė Laravel ypatybė yra **automatinis priklausomybės injektavimas** į valdiklius per paslaugų konterį — tipo patarimus su priklausomybėmis (paslaugas, užklausą, pašto siuntėjus) yra išsprendžiamos ir automatiškai injektuojamos, suteikdamos švarų, išbandytą, nestipriai suporuotą kodą.

Tolygiai svarbi yra geroji praktika laikyti valdiklius **plonais** — tvarkyti tik HTTP problemas (patvirtinimą, paslaugų iškviečimą, atsako grąžinimą) ir verslo logiką suporuoti paslaugoms/modeliams, kurie laiką kodą prižiūrimą ir išbandytą.

Valdikliai kartu su maršrutavimu ir modeliais sudaro Laravel užklausos tvarkymo griaučius, todėl jie yra pagrindiniai gerai organizuotoms, profesionalionālems Laravel programoms kurti.