Salah satu hal yang langsung saya sadari ketika belajar Laravel lebih dalam adalah betapa mudahnya controller menjadi gemuk (fat controller) jika tidak disiplin dari awal.
Masalah yang Saya Temui
Di proyek pertama, satu method controller bisa berisi 40–50 baris: validasi input, query database, format response JSON, hingga penanganan error — semuanya campur aduk. Ini membuat kode sulit dibaca dan sangat sulit di-test.
Solusi Pertama: Form Request
Laravel memiliki kelas FormRequest yang dirancang khusus untuk memisahkan logika validasi dari controller. Caranya:
php artisan make:request StoreOrderRequest
Lalu isi aturan validasinya di sana:
public function rules(): array
{
return [
'customer_id' => ['required', 'exists:customers,id'],
'items' => ['required', 'array', 'min:1'],
'items.*.sku' => ['required', 'string'],
'items.*.qty' => ['required', 'integer', 'min:1'],
];
}
Controller jadi tinggal menerima data yang sudah tervalidasi:
public function store(StoreOrderRequest $request): JsonResponse
{
$order = Order::create($request->validated());
// ...
}
Solusi Kedua: API Resource
Untuk formatting output JSON, saya pakai JsonResource. Ini memastikan struktur response API selalu konsisten, tidak peduli perubahan apapun di model.
php artisan make:resource OrderResource
Hasilnya controller menjadi sangat ramping dan setiap bagian punya tanggung jawabnya sendiri.
Takeaway
Separation of Concerns bukan hanya konsep abstrak — di Laravel, ia sudah disediakan alat konkretnya: FormRequest untuk input, Resource untuk output. Manfaatkan keduanya sejak awal.