Apa itu controllers dalam Laravel?

Question

Accepted Answer

**Controllers** mengelompokkan logika penanganan permintaan terkait ke dalam kelas. Daripada menempatkan semua logika dalam route closures, controllers mengorganisir tindakan aplikasi (misalnya semua operasi terkait pengguna) ke dalam metode — menjaga rute tetap bersih dan kode terorganisir.

## Sebuah controller dasar

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

Buat satu dengan Artisan: `php artisan make:controller UserController`. Setiap metode menangani satu tindakan, dan rute menunjuk ke mereka.

## Resource controllers (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()
```

Sebuah **resource controller** memiliki metode CRUD standar, dipasangkan dengan `Route::resource` untuk perutean RESTful konvensional — boilerplate minimal untuk sumber daya CRUD tipikal.

## Dependency injection dalam controllers

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

Konten service Laravel **secara otomatis menginjeksi** dependensi yang di-type-hint ke dalam konstruktor controller dan metode (termasuk `Request`) — kode yang bersih dan dapat diuji.

## Jaga controllers tetap tipis

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

## Mengapa ini penting

Controllers adalah blok bangunan inti Laravel — mereka mengorganisir logika penanganan permintaan ke dalam kelas yang kohesif, yang penting untuk aplikasi apa pun di luar rute trivial.

Memahami cara membuat controllers, memetakan rute ke metode mereka, dan khususnya menggunakan **resource controllers** dengan `Route::resource` (untuk CRUD RESTful konvensional dengan boilerplate minimal) adalah pengetahuan sehari-hari untuk membangun aplikasi Laravel.

Fitur kunci Laravel adalah **dependency injection otomatis** ke dalam controllers melalui service container — dependensi yang di-type-hint (layanan, permintaan, mailers) diselesaikan dan diinjeksi secara otomatis, memungkinkan kode yang bersih, dapat diuji, dan longgar.

Sama pentingnya adalah praktik terbaik menjaga controllers **tipis** — menangani hanya masalah HTTP (validasi, memanggil layanan, mengembalikan respons) dan mendelegasikan logika bisnis ke services/models, yang membuat kode dapat dirawat dan diuji.

Controllers, bersama dengan routing dan models, membentuk tulang punggung penanganan permintaan Laravel, menjadikan mereka fundamental untuk membangun aplikasi Laravel yang terorganisir dengan baik dan profesional.