Contoh Implementasi Pivot Table Laravel Eloquent Relationship

Jasa Software Developer Jombang – Dalam pengembangan aplikasi menggunakan Laravel, sering kali kita perlu menghubungkan dua tabel yang saling memiliki banyak data. Laravel menyediakan fitur relasi many-to-many untuk kondisi tersebut. Saat menggunakan relasi many-to-many, kita membutuhkan tabel tambahan yang disebut pivot table. Artikel ini menjelaskan cara membuat dan menggunakan pivot table di Laravel dengan bahasa yang lebih mudah dipahami dan tanpa istilah yang rumit.

Apa Itu Pivot Table di Laravel?

Pivot table adalah tabel khusus yang digunakan untuk menyimpan hubungan antara dua tabel. Tabel ini tidak menyimpan data utama, tetapi hanya menyimpan informasi tentang bagaimana dua tabel saling terhubung.

Contoh hubungan yang menggunakan pivot table:

• User bisa memiliki banyak role.
• Role bisa dimiliki oleh banyak user.

Karena kedua tabel saling memiliki banyak hubungan, maka diperlukan pivot table untuk mencatat koneksi tersebut.

Nama pivot table biasanya menggunakan gabungan nama kedua tabel. Misalnya:

• users
• roles
• pivot table → role_user

Struktur Pivot Table Sederhana

Isi pivot table biasanya seperti ini:

Setiap baris menunjukkan hubungan antara user tertentu dan role tertentu.

Contoh Kasus: User dan Role

Untuk mempermudah penjelasan, kita gunakan contoh umum: relasi user dan role.

Tujuan:

• Membuat user bisa memiliki lebih dari satu role.
• Role juga bisa digunakan oleh beberapa user.

Untuk itu, kita membutuhkan tiga tabel:

1. users
2. roles
3. role_user (pivot table)

1. Membuat Tabel Roles

Pertama, buat migration untuk tabel roles:

php artisan make:migration create_roles_table

php artisan make:migration create_roles_table

Isi migration:

Schema::create('roles', function (Blueprint $table) {
    $table->id();
    $table->string('name');
    $table->timestamps();
});

Schema::create('roles', function (Blueprint $table) {
    $table->id();
    $table->string('name');
    $table->timestamps();
});

2. Membuat Pivot Table role_user

php artisan make:migration create_role_user_table

php artisan make:migration create_role_user_table

Isi migration:

Schema::create('role_user', function (Blueprint $table) {
    $table->unsignedBigInteger('user_id');
    $table->unsignedBigInteger('role_id');

    $table->foreign('user_id')->references('id')->on('users')->onDelete('cascade');
    $table->foreign('role_id')->references('id')->on('roles')->onDelete('cascade');
});

Schema::create('role_user', function (Blueprint $table) {
    $table->unsignedBigInteger('user_id');
    $table->unsignedBigInteger('role_id');

    $table->foreign('user_id')->references('id')->on('users')->onDelete('cascade');
    $table->foreign('role_id')->references('id')->on('roles')->onDelete('cascade');
});

Pada pivot table, kita tidak membuat kolom id. Pivot table biasanya cukup dengan dua foreign key saja.

3. Membuat Relasi di Model

Laravel menggunakan method belongsToMany() untuk relasi many-to-many.

Model User

class User extends Model
{
    public function roles()
    {
        return $this->belongsToMany(Role::class);
    }
}

class User extends Model
{
    public function roles()
    {
        return $this->belongsToMany(Role::class);
    }
}

Model Role

class Role extends Model
{
    public function users()
    {
        return $this->belongsToMany(User::class);
    }
}

class Role extends Model
{
    public function users()
    {
        return $this->belongsToMany(User::class);
    }
}

Dengan relasi ini, Laravel akan otomatis mencari pivot table bernama role_user.

Baca juga: Cara Memilih Jasa Software Developer di Sidoarjo yang Profesional dan Berpengalaman

4. Menambahkan Data ke Pivot Table

Laravel menyediakan beberapa method untuk mengelola data di pivot table.

Menambahkan role ke user

$user = User::find(1);
$user->roles()->attach(2);

$user = User::find(1);
$user->roles()->attach(2);

Menambahkan beberapa role sekaligus:

$user->roles()->attach([1, 2, 3]);

$user->roles()->attach([1, 2, 3]);

Menghapus role dari user

$user->roles()->detach(2);

$user->roles()->detach(2);

Menghapus semua role dari user:

$user->roles()->detach();

$user->roles()->detach();

Sinkronisasi role

$user->roles()->sync([1, 3]);

$user->roles()->sync([1, 3]);

sync() hanya menyimpan role yang ada di array tersebut, role lainnya akan dihapus.

5. Menambahkan Kolom Tambahan pada Pivot Table

Kadang kita butuh informasi tambahan, misalnya siapa yang memberikan role atau kapan diberikan.

Tambahkan kolom di migration pivot:

$table->string('assigned_by')->nullable();
$table->timestamps();

$table->string('assigned_by')->nullable();
$table->timestamps();

Model User Diperbarui

public function roles()
{
    return $this->belongsToMany(Role::class)->withPivot('assigned_by')->withTimestamps();
}

public function roles()
{
    return $this->belongsToMany(Role::class)->withPivot('assigned_by')->withTimestamps();
}

Mengakses Data Pivot

$user = User::with('roles')->find(1);

foreach ($user->roles as $role) {
    echo $role->pivot->assigned_by;
}

$user = User::with('roles')->find(1);

foreach ($user->roles as $role) {
    echo $role->pivot->assigned_by;
}

6. Contoh Penggunaan di Controller

Berikut contoh menambahkan role ke user dari controller:

public function assignRole(Request $request, $user_id)
{
    $user = User::findOrFail($user_id);

    $user->roles()->attach($request->role_id, [
        'assigned_by' => auth()->user()->name
    ]);

    return response()->json([
        'message' => 'Role berhasil ditambahkan'
    ]);
}

public function assignRole(Request $request, $user_id)
{
    $user = User::findOrFail($user_id);

    $user->roles()->attach($request->role_id, [
        'assigned_by' => auth()->user()->name
    ]);

    return response()->json([
        'message' => 'Role berhasil ditambahkan'
    ]);
}

7. Mengambil Data Relasi

Mendapatkan role milik user

$user = User::with('roles')->find(1);
return $user->roles;

$user = User::with('roles')->find(1);
return $user->roles;

Mendapatkan user yang memiliki role tertentu

$role = Role::with('users')->find(2);
return $role->users;

$role = Role::with('users')->find(2);
return $role->users;

8. Fitur Tambahan yang Berguna

Laravel menyediakan beberapa fitur tambahan untuk mengelola pivot table:

syncWithoutDetaching()

Menambahkan role tanpa menghapus role lain.

$user->roles()->syncWithoutDetaching([2, 4]);

$user->roles()->syncWithoutDetaching([2, 4]);

withTimestamps()

Menyimpan waktu kapan relasi dibuat dan diupdate.

Using Custom Pivot Model

Jika pivot table semakin kompleks, kita bisa membuat pivot model khusus, namun fitur ini tidak dibahas detail dalam artikel ini karena fokusnya untuk pemahaman dasar.

9. Best Practice Saat Menggunakan Pivot Table

Berikut beberapa hal yang disarankan:

✔ Gunakan nama pivot table sesuai konvensi Laravel

Agar Laravel bisa mengenali otomatis.

✔ Hanya tambahkan kolom penting

Jika terlalu banyak kolom, pertimbangkan membuat model pivot sendiri.

✔ Gunakan foreign key

Agar data lebih aman dan relasi tidak mudah rusak.

✔ Gunakan eager loading (with())

Untuk menghindari query terlalu banyak saat mengambil data relasi.

Kesimpulan

Pivot table adalah bagian penting dalam membuat relasi many-to-many di Laravel. Dengan pivot table, kita bisa menghubungkan dua tabel yang saling memiliki banyak data. Laravel menyediakan fitur-fitur lengkap melalui belongsToMany() sehingga proses pengelolaan relasi menjadi lebih mudah.

Dalam artikel ini, kita telah mempelajari:

• Apa itu pivot table
• Cara membuat pivot table
• Cara mendefinisikan relasi di model
• Cara menambahkan, menghapus, dan mengelola data pivot
• Cara menambahkan kolom tambahan
• Contoh implementasi di controller
• Cara mengambil data relasi

Dengan memahami konsep pivot table, kamu bisa membuat aplikasi yang lebih terstruktur dan mudah dikembangkan. Relasi many-to-many menjadi lebih mudah karena Laravel telah menyediakan sintaks yang sederhana dan jelas.