Overview
Kode aplikasi yang tidak konsisten akan semakin sulit dipelihara saat fitur bertambah dan lebih banyak developer terlibat. Controller yang terlalu besar, validasi yang tersebar, dan query yang ditulis langsung di template membuat perubahan berisiko serta menyulitkan pengujian. Artikel ini menunjukkan pola awal untuk membangun proyek Laravel yang terstruktur tanpa membuat abstraksi berlebihan.
Tujuan utamanya adalah memisahkan tanggung jawab: route menentukan endpoint, controller mengoordinasikan request, Form Request memvalidasi input, model mengelola interaksi data, dan service/action digunakan bila proses bisnis memang cukup kompleks.
Prerequisites
- PHP 8.2+ sebagai baseline Laravel 11/12.
- Composer 2.x.
- Proyek Laravel baru.
- MySQL/MariaDB jika fitur membutuhkan penyimpanan data.
- Git dan pemahaman dasar route, controller, model, migration, dan Blade.
Step-by-step tutorial
1. Buat aplikasi dan repository
composer create-project laravel/laravel katalog-produk
cd katalog-produk
git init
git add .
git commit -m "chore: initial Laravel project"
Sebelum commit, periksa .gitignore dan pastikan .env tidak ikut dilacak.
2. Gunakan konvensi penamaan yang konsisten
Gunakan nama model singular seperti Product, controller berakhiran Controller, nama route yang deskriptif, serta migration yang menjelaskan perubahan tabel. Hindari menamai komponen berdasarkan preferensi pribadi yang berbeda-beda di setiap modul. Konsistensi mempermudah code review dan onboarding developer baru.
3. Buat komponen yang diperlukan
php artisan make:model Product -m
php artisan make:controller ProductController --resource
php artisan make:request StoreProductRequest
php artisan make:request UpdateProductRequest
Contoh migration:
Schema::create('products', function (Blueprint $table) {
$table->id();
$table->string('name');
$table->string('sku')->unique();
$table->unsignedInteger('price');
$table->boolean('is_active')->default(true);
$table->timestamps();
});
Tipe price di atas hanya contoh untuk nominal integer. Pilih tipe yang sesuai dengan aturan bisnis, mata uang, dan kebutuhan perhitungan aplikasi.
4. Pusatkan validasi dengan Form Request
Contoh aturan pada StoreProductRequest:
public function authorize(): bool
{
return true; // Ganti dengan aturan otorisasi sesuai aplikasi.
}
public function rules(): array
{
return [
'name' => ['required', 'string', 'max:255'],
'sku' => ['required', 'string', 'max:100', 'unique:products,sku'],
'price' => ['required', 'integer', 'min:0'],
'is_active' => ['sometimes', 'boolean'],
];
}
authorize() bernilai true hanya bila proses ini memang boleh dilakukan oleh semua pengguna yang mencapai request tersebut. Untuk aplikasi nyata, gunakan Policy atau Gate jika hak akses bergantung pada peran atau kepemilikan data.
5. Buat controller yang fokus
public function index(): View
{
$products = Product::query()->latest()->paginate(15);
return view('products.index', compact('products'));
}
public function store(StoreProductRequest $request): RedirectResponse
{
Product::create($request->validated());
return to_route('products.index')
->with('status', 'Produk berhasil dibuat.');
}
Tambahkan $fillable pada model dengan field yang memang boleh diisi:
protected $fillable = ['name', 'sku', 'price', 'is_active'];
Jangan menggunakan $request->all() untuk mass assignment karena input yang tidak diharapkan dapat ikut diproses.
6. Definisikan route dan view
Route::resource('products', ProductController::class)
->only(['index', 'store', 'create', 'show', 'edit', 'update', 'destroy']);
Pastikan setiap method yang didaftarkan tersedia dan tindakan update/delete dilindungi otorisasi. Simpan template di resources/views dan hindari menempatkan logika bisnis panjang dalam Blade.
7. Tambahkan test
php artisan make:test ProductManagementTest
php artisan test
Test setidaknya memeriksa validasi, otorisasi, penyimpanan, dan respons yang diharapkan. Gunakan database khusus testing agar pengujian tidak mengubah data development atau production.
Troubleshooting
- Mass assignment exception: periksa
$fillableatau$guarded, lalu gunakan data tervalidasi. - Route tidak ditemukan: jalankan
php artisan route:listdan periksa nama route serta cache. - Tabel belum tersedia: pastikan koneksi benar dan migration sudah dijalankan.
- Controller terlalu besar: pindahkan proses bisnis yang kompleks ke service/action dan lindungi refactor dengan test.
- Pagination lambat: tinjau query, index database, eager loading, serta jumlah record yang diambil.
Best practices
Gunakan Form Request untuk validasi, Policy/Gate untuk otorisasi, transaksi untuk operasi multi-tabel yang harus atomik, dan pagination untuk daftar data. Buat service hanya ketika ada logika bisnis kompleks atau digunakan bersama. Hindari abstraksi yang tidak menambah kejelasan, dan jangan menampilkan exception internal kepada pengguna.
Related articles
- Memahami Struktur Folder Laravel
- Merancang Database Laravel
- CRUD Laravel yang Terstruktur
- Laravel Testing
Last tested
Tanggal penyusunan: 19 Oktober 2026. Contoh mengikuti pola umum Laravel modern tetapi belum dieksekusi pada proyek tertentu. Uji kode, namespace, dan test pada versi Laravel yang dipilih sebelum digunakan di production.