Apakah pengawal dalam Laravel?

Question

Accepted Answer

**Pengawal** mengelompokkan logik pengendalian permintaan yang berkaitan ke dalam kelas. Daripada meletakkan semua logik dalam penutupan rute, pengawal menorganisir tindakan aplikasi (contohnya semua operasi yang berkaitan dengan pengguna) ke dalam kaedah — menjaga laluan tetap bersih dan kod teratur.

## Pengawal asas

```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
    }
}
```

Jana dengan Artisan: `php artisan make:controller UserController`. Setiap kaedah menangani satu tindakan, dan laluan menunjuk kepadanya.

## Pengawal sumber (CRUD RESTful)

```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()
```

Sewu **pengawal sumber** mempunyai kaedah CRUD standard, dipasangkan dengan `Route::resource` untuk perutean RESTful konvensional — kod boilerplate minimum untuk sumber CRUD khas.

## Suntikan kebergantungan dalam pengawal

```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
    }
}
```

Kontena perkhidmatan Laravel **secara automatik menyuntik** kebergantungan yang diberi petunjuk jenis ke dalam pembina dan kaedah pengawal (termasuk `Request`) — kod yang bersih dan boleh diuji.

## Jaga pengawal tetap nipis

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

## Mengapa Penting

Pengawal adalah blok bangunan teras Laravel — mereka mengoganisir logik pengendalian permintaan ke dalam kelas yang kohesif, yang penting untuk sebarang aplikasi di luar laluan remeh.

Memahami cara membuat pengawal, memetakan laluan ke kaedah mereka, dan terutamanya menggunakan **pengawal sumber** dengan `Route::resource` (untuk CRUD RESTful konvensional dengan kod boilerplate minimum) adalah pengetahuan harian untuk membina aplikasi Laravel.

Ciri utama Laravel adalah **suntikan kebergantungan automatik** ke dalam pengawal melalui kontena perkhidmatan — kebergantungan yang diberi petunjuk jenis (perkhidmatan, permintaan, penghantar mel) diselesaikan dan disuntik secara automatik, memungkinkan kod yang bersih, boleh diuji, dan longgar-gandeng.

Sama pentingnya ialah amalan terbaik menjaga pengawal **nipis** — mengendalikan hanya kebimbangan HTTP (pengesahan, memanggil perkhidmatan, mengembalikan respons) dan mewakilkan logik perniagaan kepada perkhidmatan/model, yang mengekalkan kod boleh diselenggara dan boleh diuji.

Pengawal, bersama dengan perutean dan model, membentuk tulang belakang pengendalian permintaan Laravel, menjadikan mereka asas untuk membina aplikasi Laravel yang teratur dengan baik dan profesional.