Tutorial Laravel: Bagaimana Cara Membuat Pivot Table? Simak Yuk!

27 September 2025

Tutorial Laravel: Bagaimana Cara Membuat Pivot Table? Simak Yuk!

Laravel adalah framework PHP populer yang menyediakan Eloquent ORM untuk memudahkan interaksi dengan database. Dengan Eloquent, pengembang dapat mendefinisikan relasi antar model seperti one-to-one, one-to-many, dan many-to-many. Pada relasi many-to-many, diperlukan pivot table sebagai penghubung antar tabel relasi. Pada Tutorial Laravel kali ini, kita akan membahas tentang pivot table, sebuah fitur penting dalam Eloquent untuk mengelola relasi many-to-many. Memahami pivot table akan sangat membantu dalam menyederhanakan pengelolaan database yang kompleks. Selanjutnya, kita akan menjelajahi langkah demi langkah cara membuat dan menggunakan pivot table di Laravel. Informasi lebih detail tentang relasi Many-to-Many dapat ditemukan pada panduan lengkap Laravel Eloquent.

Catatan: pivot table dalam konteks Laravel berbeda dengan PivotTable pada Excel. Di Laravel, pivot table hanyalah tabel perantara di database untuk relasi many-to-many.

Apa Itu Pivot Table dan Kapan Digunakan?

Pivot table adalah tabel perantara (intermediate table) yang menghubungkan dua model dengan relasi many-to-many. Misalnya, relasi antara tabel users dan roles menggunakan tabel pivot role_user yang berisi kolom user_id dan role_id. Setiap pengguna dapat memiliki banyak peran, dan setiap peran dapat dimiliki oleh banyak pengguna, sehingga diperlukan pivot table untuk memetakan relasi tersebut. Pivot table biasanya hanya menyimpan kolom foreign key dari kedua tabel, serta dapat menyertakan kolom data tambahan seperti status atau tanggal_dibuat jika diperlukan.

Contoh situasi many-to-many antara lain:

Tabel users ↔ roles dihubungkan oleh pivot role_user, memungkinkan satu pengguna memiliki banyak peran.
Tabel posts ↔ tags dihubungkan oleh pivot post_tag, cocok untuk menandai artikel dengan beberapa tag.
Tabel orders ↔ products dihubungkan oleh pivot order_product, dapat digunakan untuk mencatat quantity pesanan.
Tabel books ↔ authors dihubungkan oleh pivot author_book, digunakan jika satu buku ditulis oleh beberapa penulis.
Tabel students ↔ courses dihubungkan oleh pivot course_student, berguna untuk mencatat mata kuliah yang diambil setiap mahasiswa.

Pivot table penting digunakan saat sebuah model dapat berhubungan dengan banyak model lainnya (relasi many-to-many). Pivot table memudahkan dalam menyimpan informasi tambahan pada relasi tersebut. Misalnya, kolom created_at pada pivot dapat mencatat kapan relasi dibuat, atau kolom status menandai status khusus relasi. Dengan pivot table, data hubungan antar model menjadi lebih terstruktur dan mudah dikelola.

Cara Membuat Pivot Table Pada Laravel

Langkah pertama adalah membuat migrasi untuk pivot table. Jalankan perintah berikut di terminal Laravel:

php artisan make:migration create_role_user_table --create=role_user

Perintah di atas akan menghasilkan file migrasi baru di database/migrations (nama berawalan timestamp). Buka file migrasi tersebut untuk menambahkan struktur pivot table. Misalkan kita membuat tabel pivot role_user, berikut contoh struktur migrasinya:

Schema::create('role_user', function (Blueprint $table) {
    $table->id();
    $table->foreignId('user_id')->constrained()->onDelete('cascade');
    $table->foreignId('role_id')->constrained()->onDelete('cascade');
    $table->timestamps();
});

Perintah $table->foreignId(...)->constrained()->onDelete('cascade') otomatis menambahkan foreign key ke tabel terkait. $table->id() membuat kolom primary key id. $table->timestamps() menambahkan kolom created_at dan updated_at. Dalam contoh di atas, opsi onDelete('cascade') memastikan data pivot dihapus otomatis jika data pada tabel induk dihapus. Jika tidak memerlukan kolom id, kamu dapat menggunakan $table->primary(['user_id','role_id']) untuk membuat primary key secara komposit dari kedua kolom foreign key.

Pastikan konfigurasi database di file .env sudah benar, lalu jalankan migrasi menggunakan php artisan migrate. Perintah ini akan membuat tabel pivot di database sesuai struktur migrasi yang sudah ditulis.

Mendefinisikan Relasi Many-to-Many di Laravel

Setelah pivot table tersedia, selanjutnya definisikan relasi many-to-many di model Eloquent. Jika belum memiliki model Role, buat dengan perintah php artisan make:model Role. Selanjutnya, di model User, tambahkan method roles() sebagai berikut untuk mendefinisikan relasi ke model Role:

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

Di model Role, tambahkan method users() sebagai relasi inverse ke model User:

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

Laravel secara otomatis menentukan nama tabel pivot berdasarkan urutan alfabet dari nama model terkait. Dalam contoh ini, tabel role_user dipilih karena role lebih besar dari user menurut urutan alfabet. Laravel juga secara default mengasumsikan nama foreign key user_id dan role_id sesuai nama model. Jika ingin menggunakan nama pivot table khusus atau foreign key berbeda, sebutkan sebagai parameter kedua (dan ketiga, keempat untuk custom foreign key) di belongsToMany(). Contoh: return $this->belongsToMany(Role::class, 'nama_tabel_pivot');.

Mengakses Data Melalui Pivot Table

Setelah relasi didefinisikan, kamu dapat mengakses data melalui model Eloquent. Berdasarkan Tutorial Laravel, setelah relasi didefinisikan, kamu dapat mengakses data melalui model Eloquent. Misalnya, untuk mendapatkan semua peran (roles) dari pengguna dengan id=1:

$user = User::find(1);
$roles = $user->roles; // Mengambil semua peran pengguna

Hasil $user->roles adalah koleksi objek Role yang terhubung dengan pengguna tersebut. Kamu dapat melakukan loop untuk memproses masing-masing data role. Selain itu, kamu dapat menggunakan eager loading untuk efisiensi query. Misalnya:

$user = User::with('roles')->find(1);
foreach ($user->roles as $role) {
    echo $role->pivot->created_at . "\n";
}

Cara ini akan memuat semua data roles beserta data pivot-nya dalam satu query database. Setiap objek Role yang diambil melalui relasi memiliki properti pivot untuk mengakses kolom-kolom pada tabel pivot. Misalnya, jika tabel pivot memiliki kolom status, kamu dapat mengaksesnya melalui $role->pivot->status setelah mendefinisikan withPivot('status') di model (lihat bagian berikutnya).

Jika pivot table memiliki kolom tambahan, tambahkan withPivot() pada definisi relasi untuk memuat kolom tersebut. Misalnya, jika tabel pivot memiliki kolom status, definisikan relasi di model User seperti di bawah ini:

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

Dengan begitu, kamu dapat mengakses nilai status melalui $role->pivot->status ketika iterasi role. Jika tabel pivot juga memiliki kolom timestamp (created_at dan updated_at), tambahkan withTimestamps() dalam definisi relasi agar Laravel secara otomatis mengisi kolom tersebut saat attach() atau sync() dipanggil.

Menambahkan Data ke Pivot Table

Dalam banyak Tutorial Laravel, Laravel menyediakan beberapa metode untuk menambah atau memperbarui data pada pivot table. Berikut contoh penggunaannya:

attach(): Menambahkan relasi baru ke pivot table. Misalnya:

$user->roles()->attach($roleId);

sync(): Melakukan sinkronisasi relasi. Menghapus relasi yang tidak ada dalam array dan menambahkan relasi baru sehingga pivot table sesuai dengan array ID yang diberikan:


$user->roles()->sync([$roleId1, $roleId2]);

updateExistingPivot(): Memperbarui data kolom pada baris pivot tertentu. Contoh, mengubah kolom status:

$user->roles()->updateExistingPivot($roleId, ['status' => 'active']);

detach(): Menghapus relasi pada pivot table. Misalnya:

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

toggle(): Menambahkan atau menghapus relasi pivot secara otomatis berdasarkan keberadaan sebelumnya. Jika ID belum ada di pivot, akan ditambahkan; jika sudah ada, akan dihapus. Contoh:

$user->roles()->toggle([$roleId]);

Semua metode di atas memudahkan pengelolaan relasi many-to-many tanpa perlu menulis query SQL manual. Misalnya, attach() hanya menambah baris pivot, sedangkan sync() lebih canggih karena secara otomatis menyesuaikan data pivot dengan yang diberikan. Jika hanya ingin menambah relasi tambahan tanpa menghapus yang sudah ada, gunakan syncWithoutDetaching().

Mengelola Pivot Table dengan Kolom Tambahan

Untuk menambahkan kolom khusus (misalnya status) pada pivot table, sertakan kolom tersebut saat membuat migrasi pivot:

Schema::create('role_user', function (Blueprint $table) {
    $table->id();
    $table->foreignId('user_id')->constrained()->onDelete('cascade');
    $table->foreignId('role_id')->constrained()->onDelete('cascade');
    $table->string('status');
    $table->timestamps();
});

Setelah migrasi dijalankan, gunakan withPivot('status') pada definisi relasi di model agar kolom status tersebut dapat diakses Eloquent. Dengan begitu, kamu bisa menyimpan dan mengambil nilai status untuk setiap pasangan pengguna-peran. Selain tipe data string, kamu juga dapat menggunakan tipe data lain (integer, boolean, JSON, dll.) sesuai kebutuhan. Misalnya, kolom boolean is_active atau kolom expires (datetime) dapat ditambahkan di pivot table. Jangan lupa menjalankan migrasi ulang (migrate:refresh) jika ingin memperbarui struktur tabel yang sudah ada.

Penggunaan Pivot Table untuk Fungsi Lain

Selain sebagai penghubung entitas, pivot table juga sering digunakan untuk menyimpan informasi tambahan atau log khusus tentang relasi. Misalnya, untuk mencatat kapan pengguna terakhir memiliki peran tertentu, kita dapat menambahkan kolom last_accessed pada tabel pivot. Kemudian gunakan attach() dengan parameter kolom pivot tambahan:

$user->roles()->attach($roleId, ['last_accessed' => now()]);

Penambahan data di atas akan mengisi kolom last_accessed di tabel role_user dengan waktu saat relasi dibuat. Teknik serupa dapat digunakan untuk mencatat status, tanggal kadaluarsa, atau informasi lain sesuai kebutuhan. Misalnya, jika ingin menambahkan kolom expires atau activated_by, tinggal sertakan pada array kedua attach().

Contoh Implementasi Pivot Table pada Controller dan Seeder

Untuk memperjelas penggunaannya dalam aplikasi nyata, berikut contoh implementasi pivot table di controller dan seeder. Misalnya, kita ingin menambahkan peran baru ke pengguna:

public function assignRole($userId, $roleId)
{
    $user = User::findOrFail($userId);
    // Menambahkan relasi baru di pivot
    $user->roles()->attach($roleId);
    return response()->json(['success' => true]);
}

Pada contoh di atas, kita mengambil User berdasarkan ID, lalu menggunakan method attach() untuk menghubungkan peran (role) ke pengguna tersebut. Method attach() akan menambahkan baris baru pada tabel role_user.

Berikut contoh seeder untuk mengisi data pivot pada tabel role_user:

public function run()
{
    // Misalnya, user dengan ID 1 diberikan peran dengan ID 2 dan 3
    DB::table('role_user')->insert([
        ['user_id' => 1, 'role_id' => 2, 'created_at' => now(), 'updated_at' => now()],
        ['user_id' => 1, 'role_id' => 3, 'created_at' => now(), 'updated_at' => now()],
    ]);
}

Dengan seeder di atas, pivot table role_user langsung terisi data relasi. Biasanya, kamu juga dapat menggunakan attach() atau sync() dalam seeder untuk menyisipkan data ke pivot secara otomatis.

Berikut contoh penggunaan sync() di controller untuk memperbarui relasi berdasarkan input form:

public function updateRoles(Request $request, $id)
{
    $user = User::findOrFail($id);
    // Sinkronkan role berdasarkan input role_ids dari form
    $user->roles()->sync($request->input('role_ids', []));
    return redirect()->back();
}

Dengan sync(), relasi yang tidak termasuk dalam array role_ids akan dihapus dari pivot, sedangkan yang baru ditambahkan otomatis. Ini memudahkan update daftar peran tanpa perlu detach manual.

Kesimpulan

Banyak Tutorial Laravel menekankan bahwa pivot table sangat berguna dalam pengembangan aplikasi modern. Dengan pivot table, kamu dapat menyimpan relasi dengan cara yang lebih fleksibel dan terstruktur. Misalnya, kolom tambahan di pivot memungkinkan fitur khusus seperti penentuan status atau pencatatan waktu secara otomatis. Pivot table juga menjaga agar basis data tetap ter-normalisasi tanpa menyimpan data berulang. Cobalah terapkan pivot table dalam fitur nyata seperti manajemen peran (roles) atau sistem tagging artikel untuk memahami manfaatnya lebih jauh. Eksplorasi lebih lanjut fitur Laravel lainnya seperti eager loading, event, dan pivot model agar aplikasi semakin optimal dan efisien Kelas Fullstack CodePolitan

Jika kamu tertarik mengembangkan kemampuan lebih jauh dalam web development, CodePolitan menawarkan KelasFullstack: kursus online belajar Fullstack Web Developer dari A sampai Z. Kelas ini cocok untuk kamu yang ingin memiliki karir bagus, menguasai skill yang dibutuhkan industri, mendapatkan gaji tinggi, dan mampu membuat website atau aplikasi untuk mengembangkan bisnis online sendiri.

Beberapa keunggulan KelasFullstack CodePolitan:

Materi pembelajaran menyeluruh: frontend (HTML, CSS, JavaScript) dan backend (PHP, Laravel).
Proyek nyata: peserta membuat aplikasi web riil, seperti toko online atau blog.
Support industri: materi sesuai kebutuhan skill developer profesional.
Sertifikat resmi setelah lulus untuk portofolio.

Referensi