Invokable Controller di Laravel: Cara Kerja, Contoh Kode, dan Kapan Memakainya
Ada satu fitur Laravel yang sering dilewatkan developer pemula: invokable controller. Padahal kalau dipakai di tempat yang tepat, kode jadi lebih bersih dan lebih mudah dibaca.
Artikel ini menjelaskan apa itu invokable controller, kapan sebaiknya dipakai, dan bagaimana cara implementasinya di Laravel 12.
Apa Itu Invokable Controller?
Invokable controller adalah controller yang hanya punya satu method: __invoke(). Karena hanya ada satu aksi, Anda tidak perlu menyebutkan nama method saat mendaftarkan route.
Ini berbeda dengan controller biasa yang bisa punya banyak method seperti index(), store(), update(), dll.
Buat invokable controller lewat Artisan:
php artisan make:controller ShowDashboardController --invokable
Hasilnya:
<?php
namespace AppHttpControllers;
use IlluminateHttpRequest;
class ShowDashboardController extends Controller
{
public function __invoke(Request $request)
{
//
}
}
Cara Mendaftarkan ke Route
Karena hanya ada satu aksi, cara daftarkan ke route cukup langsung pakai nama class-nya:
use AppHttpControllersShowDashboardController;
Route::get('/dashboard', ShowDashboardController::class);
Bandingkan dengan controller biasa yang harus sebut method-nya:
Route::get('/dashboard', [DashboardController::class, 'index']);
Lebih ringkas, dan route-nya lebih mudah dibaca, terutama kalau ada banyak route.
Contoh Kasus Nyata
Misalnya Anda punya halaman yang menampilkan laporan bulanan. Logikanya spesifik untuk satu tujuan, tidak perlu dibagi ke beberapa method:
<?php
namespace AppHttpControllersReports;
use IlluminateHttpRequest;
use AppHttpControllersController;
use AppModelsOrder;
class MonthlyReportController extends Controller
{
public function __invoke(Request $request)
{
$month = $request->query('month', now()->month);
$year = $request->query('year', now()->year);
$orders = Order::whereMonth('created_at', $month)
->whereYear('created_at', $year)
->with('customer')
->get();
return view('reports.monthly', compact('orders', 'month', 'year'));
}
}
Route-nya:
Route::get('/reports/monthly', MonthlyReportController::class)
->middleware('auth')
->name('reports.monthly');
Rapi. Satu controller, satu tujuan.
Kapan Pakai Invokable Controller?
Invokable controller cocok untuk:
- Halaman yang hanya punya satu aksi (tampil laporan, proses webhook, generate PDF)
- Action handler — satu action spesifik yang tidak perlu dibundel dengan aksi lain
- Single-purpose endpoint yang ingin dipisah dari controller utama agar tidak membesar
Tidak cocok untuk resource yang punya banyak aksi CRUD. Untuk itu tetap pakai resource controller biasa.
Dependency Injection di Invokable Controller
Sama seperti controller biasa, Anda bisa inject service lewat constructor atau langsung di method __invoke():
<?php
namespace AppHttpControllers;
use AppServicesInvoiceService;
use IlluminateHttpRequest;
class GenerateInvoiceController extends Controller
{
public function __construct(
private InvoiceService $invoiceService
) {}
public function __invoke(Request $request)
{
$validated = $request->validate([
'order_id' => 'required|exists:orders,id',
]);
$pdf = $this->invoiceService->generate($validated['order_id']);
return response()->download($pdf);
}
}
Baca Juga
- Membuat Controller di Laravel 12: Resource, Middleware, dan Best Practice
- Routing di Laravel: Panduan Lengkap dengan Contoh Kode
Kalau Anda butuh tim untuk membangun aplikasi web berbasis Laravel, dari arsitektur sampai deployment — lihat layanan pengembangan aplikasi kami.
Artikel Lainnya di Kategori Laravel
Laravel 9 November 2025
Route Laravel: Panduan Routing Laravel 12 dengan Contoh Kode
Route di Laravel adalah aturan yang menentukan kode mana yang dijalankan ketika sebuah URL diakses. Semua route untuk halaman web ditulis di routes/web.php, misalnya Route::get(‘/halo’, fn () => ‘Halo’);. Panduan ini membahas routing di Laravel 12 dari dasar: method HTTP, parameter dan validasinya, named route, route group, route ke controller, route model binding, sampai cara […]
Baca Artikel
Laravel 9 November 2025
Laravel 12: Cara Install, Versi PHP, dan Starter Kit untuk Pemula
Laravel 12 adalah versi framework PHP Laravel yang rilis 24 Februari 2025. Versi ini butuh PHP 8.2 sampai 8.5, dan cara paling aman untuk memasangnya adalah composer create-project laravel/laravel:^12.0 nama-project. Panduan ini membahas persyaratan, dua cara install (Laravel installer dan Composer), starter kit React, Vue, Svelte, dan Livewire, struktur folder, error yang paling sering muncul […]
Baca Artikel10 November 2025
Cara Membuat Custom Artisan Command di Laravel 12
Tutorial step-by-step membuat custom artisan command di Laravel 12: php artisan make:command, handle method, dan best practices.
Baca ArtikelIngin Membaca Artikel Lainnya?
Temukan lebih banyak insight dan tips tentang teknologi dan bisnis digital.
Lihat Semua Artikel