Tutorial Lengkap Model Laravel untuk Pemula

Waktu membaca : 5 menit

Tutorial laravel kali ini akan Membahas model/eloquent di laravel 12, jika Anda mencari best practice, artikel ini adalah peta jalan Anda. Di dunia pengembangan web modern, khususnya dengan kerangka kerja (framework) seperti Laravel, interaksi dengan database adalah inti dari hampir setiap aplikasi. Masalah utama yang sering dihadapi adalah bagaimana mengelola data database secara efisien, aman, dan mudah diubah. Pendekatan SQL mentah sering kali menghasilkan kode yang berulang (redundant) dan sulit dipertahankan. Di sinilah Eloquent ORM (Object-Relational Mapper) Laravel masuk sebagai solusi elegan.

Eloquent memungkinkan Anda berinteraksi dengan database layaknya bekerja dengan objek PHP. Dengan kata lain, setiap tabel di database Anda memiliki “Model” yang sesuai yang digunakan untuk berinteraksi dengan tabel tersebut. Alih-alih menulis query SQL yang rumit, Anda cukup memanggil metode-metode pada Model Anda. Ini bukan hanya tentang kemudahan, ini tentang menerapkan best practice dalam arsitektur aplikasi Anda. Tujuan pembaca dari artikel ini adalah Memahami best practice menggunakan model/eloquent di laravel sehingga Anda bisa membangun aplikasi yang bersih, teruji, dan berkinerja tinggi. Mari kita selami lebih dalam bagaimana Model Eloquent dapat merevolusi cara Anda Menggunakan model di laravel.

Daftar Isi

Fondasi Model Eloquent: Konvensi dan Struktur

Model Eloquent adalah sebuah kelas yang secara default berada di direktori app/Models. Laravel sangat menganut prinsip convention over configuration—konvensi di atas konfigurasi. Mengikuti konvensi ini sangat penting untuk memaksimalkan potensi Eloquent.

Menciptakan Model Baru dengan Artisan

Langkah pertama dalam perjalanan Model Anda adalah membuatnya. Anda dapat melakukannya dengan perintah Artisan, alat baris perintah (command line tool) yang luar biasa dari Laravel:

php artisan make:model Post -m

php artisan make:model Post -m

Opsi -m (migration) secara otomatis membuat file migrasi database yang sesuai, mempercepat alur kerja (workflow) Anda.

Konvensi Penamaan (N+1 Query Issue Prevention)

Mengapa konvensi itu penting? Karena konvensi inilah yang membuat Eloquent “pintar”.

Model: Gunakan bentuk tunggal (Singular) dan huruf awal kapital (PascalCase), contoh: Post, User, Comment.
Tabel: Gunakan bentuk jamak (Plural) dan huruf kecil (snake_case), contoh: posts, users, comments.

Contoh Praktis: Jika Anda memiliki Model bernama Product, Eloquent secara otomatis akan mencari tabel bernama products. Jika Anda ingin menggunakan nama tabel yang berbeda (misalnya, tabel_produk), Anda harus secara eksplisit mendefinisikannya:

use Illuminate\Database\Eloquent\Model;

class Product extends Model 
{ 

  protected $table = 'tabel_produk'; // Override konvensi default

}

use Illuminate\Database\Eloquent\Model;

class Product extends Model 
{ 

  protected $table = 'tabel_produk'; // Override konvensi default

}

Properti Penting: fillable dan hidden

Keamanan adalah prioritas. Dua properti ini sangat vital dalam fitur unggulan model di laravel terkait keamanan data:

$fillable: Mendefinisikan kolom-kolom tabel yang dapat diisi secara massal (Mass-Assignment), misalnya saat menggunakan metode create() atau update(). Ini adalah lapisan pertahanan pertama terhadap serangan Mass-Assignment.
$hidden: Mendefinisikan kolom-kolom yang harus disembunyikan saat Model dikonversi menjadi array atau JSON, sangat berguna untuk menyembunyikan data sensitif seperti password (password) atau token (remember_token).

use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    protected $fillable = [
        'name',
        'email',
        'password',
    ];

    protected $hidden = [
        'password',
        'remember_token',
    ];
}

use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    protected $fillable = [
        'name',
        'email',
        'password',
    ];

    protected $hidden = [
        'password',
        'remember_token',
    ];
}

Fitur Unggulan Model: Relasi Tabel yang Efisien

Salah satu kekuatan terbesar Eloquent adalah bagaimana ia menangani relasi tabel (relationships). Relasi memungkinkan Anda mengakses data terkait dari tabel lain semudah mengakses properti pada Model. Ini adalah kunci untuk menyelesaikan masalah N+1 Query Problem.

Berbagai Tipe Relasi Dasar

Eloquent mendukung berbagai tipe relasi database. Berikut adalah yang paling umum:

One-to-One (Satu ke Satu): Gunakan metode hasOne() atau belongsTo().
- Contoh: Satu User memiliki satu Profile.
One-to-Many (Satu ke Banyak): Gunakan metode hasMany() atau belongsTo().
- Contoh: Satu Post memiliki banyak Comment. Satu Comment dimiliki oleh satu Post.
Many-to-Many (Banyak ke Banyak): Gunakan metode belongsToMany(). Membutuhkan tabel perantara (pivot table).
- Contoh: Satu Post dapat memiliki banyak Tag, dan satu Tag dapat melekat pada banyak Post.

Mengatasi N+1 Query Problem dengan Eager Loading

N+1 Query Problem adalah momok performa di ORM mana pun. Itu terjadi ketika Anda mengambil koleksi Model, lalu di dalam perulangan (loop), Anda mengambil relasi untuk setiap Model secara terpisah.

Praktik Buruk (Lazy Loading):

$posts = Post::all(); // 1 query 
foreach ($posts as $post) { 
  echo $post->user->name; // N query (satu untuk setiap post) 
} // Total: 1 + N Query (N+1)

$posts = Post::all(); // 1 query 
foreach ($posts as $post) { 
  echo $post->user->name; // N query (satu untuk setiap post) 
} // Total: 1 + N Query (N+1)

Praktik Terbaik (Eager Loading):

Untuk mencegah masalah ini dan meningkatkan performa secara drastis, gunakan metode with():

$posts = Post::with('user')->get(); // Hanya 2 query!
foreach ($posts as $post) { 
  echo $post->user->name; // Tidak ada query tambahan di dalam loop 
} // Total: 2 Query!

$posts = Post::with('user')->get(); // Hanya 2 query!
foreach ($posts as $post) { 
  echo $post->user->name; // Tidak ada query tambahan di dalam loop 
} // Total: 2 Query!

Menerapkan Eager Loading adalah praktik wajib bagi setiap Programer yang serius tentang kinerja.

Interaksi Data: Query dan Modifikasi Tingkat Lanjut

Model Eloquent menyediakan antarmuka yang kuat dan mudah dibaca untuk melakukan query tabel menggunakan model di laravel, melampaui sekadar all() atau find().

Metode Query Dasar yang Efisien

Mengambil Koleksi Data:

$activeUsers = User::where('status', 'active') 
->orderBy('created_at', 'desc')
->limit(10) 
->get(); // Mengembalikan Collection

$activeUsers = User::where('status', 'active') 
->orderBy('created_at', 'desc')
->limit(10) 
->get(); // Mengembalikan Collection

Mengambil Satu Record:

$post = Post::where('slug', $slug)->first(); // Mengembalikan Model tunggal 
$postOrFail = Post::findOrFail($id); // Jika tidak ditemukan, otomatis melempar 404

$post = Post::where('slug', $slug)->first(); // Mengembalikan Model tunggal 
$postOrFail = Post::findOrFail($id); // Jika tidak ditemukan, otomatis melempar 404

Aksesor, Mutator, dan Casting Lanjutan

Ini adalah fitur yang memungkinkan Anda memodifikasi cara data disimpan ke database (Mutator) dan cara data diambil dari Model (Aksesor), tanpa memengaruhi logika di Membuat Controller Anda.

Attribute Casting

Casting adalah cara untuk secara otomatis mengonversi tipe data kolom database ke tipe data PHP yang umum (integer, string, boolean) atau tipe data khusus (Carbon date, collections) saat diakses pada Model.

use Illuminate\Database\Eloquent\Model;

class Event extends Model
{
    // Konversi kolom 'options' ke array secara otomatis
    protected $casts = [
        'options' => 'array',
        'is_active' => 'boolean',
        'start_date' => 'datetime',
    ];
}

use Illuminate\Database\Eloquent\Model;

class Event extends Model
{
    // Konversi kolom 'options' ke array secara otomatis
    protected $casts = [
        'options' => 'array',
        'is_active' => 'boolean',
        'start_date' => 'datetime',
    ];
}

Accessors & Mutators (Cara Laravel 10/11/12)

Sejak Laravel 9, cara mendefinisikan Aksesor dan Mutator telah disederhanakan menggunakan objek Attribute. Ini sangat bersih dan mengikuti prinsip Single Responsibility.

use Illuminate\Database\Eloquent\Casts\Attribute;
use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    // Aksesor & Mutator baru untuk nama depan
    protected function firstName(): Attribute
    {
        return Attribute::make(
            get: fn (string $value) => ucfirst($value), // Saat Mengambil
            set: fn (string $value) => strtolower($value), // Saat Menyimpan
        );
    }
}

use Illuminate\Database\Eloquent\Casts\Attribute;
use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    // Aksesor & Mutator baru untuk nama depan
    protected function firstName(): Attribute
    {
        return Attribute::make(
            get: fn (string $value) => ucfirst($value), // Saat Mengambil
            set: fn (string $value) => strtolower($value), // Saat Menyimpan
        );
    }
}

Fat Models, Skinny Controllers (Model Gemuk, Controller Kurus)

Ini adalah prinsip arsitektur penting:

Controller seharusnya hanya menangani permintaan (request), validasi, dan mengembalikan respons (response).
Model (atau lapisan Service) seharusnya menampung semua logika bisnis dan interaksi database.

Contoh Kasus: Filter Kompleks

Daripada menulis baris panjang where() di Controller, Anda dapat memindahkannya ke dalam Model menggunakan Query Scopes.

// app/Models/Post.php
class Post extends Model
{
    // Local Scope
    public function scopePublished($query)
    {
        return $query->where('is_published', true);
    }
}

// app/Http/Controllers/PostController.php (Skinny Controller)
class PostController extends Controller
{
    public function index()
    {
        // Jauh lebih bersih!
        $posts = Post::published()->with('user')->paginate(10);
        return view('posts.index', compact('posts'));
    }
}

// app/Models/Post.php
class Post extends Model
{
    // Local Scope
    public function scopePublished($query)
    {
        return $query->where('is_published', true);
    }
}

// app/Http/Controllers/PostController.php (Skinny Controller)
class PostController extends Controller
{
    public function index()
    {
        // Jauh lebih bersih!
        $posts = Post::published()->with('user')->paginate(10);
        return view('posts.index', compact('posts'));
    }
}

Query Scopes adalah cara yang elegan untuk membuat Query Anda dapat digunakan kembali (reusable) dan Controller Anda tetap kurus.

Kesimpulan: Model sebagai Pilar Aplikasi Anda

Anda kini telah Memahami model/eloquent di laravel 12 dari dasar hingga teknik optimasi tingkat lanjut. Model Eloquent bukan hanya alat untuk interaksi database, ia adalah pilar arsitektur aplikasi Laravel Anda.

Poin-Poin Kunci yang Harus Diingat:

Konvensi: Ikuti penamaan singular/plural untuk Model/Tabel.
Keamanan: Selalu gunakan $fillable dan $hidden untuk mencegah Mass-Assignment.
Performa: Mutlak terapkan Eager Loading (with()) untuk mengatasi N+1 Query Problem.
Keterbacaan & Reusabilitas: Gunakan Local Scopes (scope…()) untuk query yang kompleks dan dapat digunakan kembali.
Arsitektur: Terapkan prinsip Fat Model, Skinny Controller.

Dengan menguasai Model Eloquent dan menerapkan best practice ini, Anda tidak hanya menulis kode yang berfungsi, tetapi juga membangun aplikasi yang mudah dipelihara, aman, dan berkinerja tinggi.

Post Views: 16