Artikel ini menjelaskan syarat dokumen, langkah pendaftaran NPWP online 2026 via Coretax langkah demi langkah, konsep NIK yang kini berfungsi sebagai NPWP, sampai apa yang harus dilakukan setelah kartu elektronik terbit. Panduan ini untuk wajib pajak orang pribadi WNI, yang merupakan kasus paling umum.

Kenapa Daftar NPWP Sekarang Lewat Coretax

Coretax adalah sistem inti administrasi perpajakan milik Direktorat Jenderal Pajak yang beroperasi penuh sejak 1 Januari 2025, berdasarkan PMK Nomor 81 Tahun 2024. Sistem ini menggantikan ereg.pajak.go.id dan DJP Online, serta menyatukan layanan daftar NPWP, lapor SPT, dan bayar pajak dalam satu portal.

Perubahan terbesarnya adalah integrasi NIK sebagai NPWP. Sejak 1 Juli 2024, NIK pada KTP otomatis berfungsi sebagai NPWP 16 digit. Artinya, bagi WNI yang NIK-nya valid di Dukcapil, proses “membuat NPWP” pada praktiknya adalah mengaktivasi NIK agar berfungsi penuh sebagai identitas perpajakan di Coretax. NPWP lama berformat 15 digit masih berlaku selama masa transisi, tetapi seluruh layanan kini berjalan di atas Coretax.

Satu kabar baik: seluruh proses pendaftaran NPWP online gratis. DJP menegaskan tidak ada biaya apa pun, dan masyarakat diminta waspada terhadap pihak yang meminta bayaran dengan janji mempercepat penerbitan NPWP.

Syarat Dokumen Membuat NPWP Online

Sebelum membuka portal Coretax, siapkan dulu dokumen dan data berikut agar proses tidak terhenti di tengah jalan.

1. e-KTP yang masih berlaku. NIK di dalamnya adalah kunci utama karena akan diaktivasi sebagai NPWP.
2. Kartu Keluarga (KK) terbaru. Data KK dipakai untuk melengkapi formulir pendaftaran.
3. Alamat email aktif. Dipakai untuk verifikasi dan menerima kartu NPWP elektronik.
4. Nomor HP aktif. Dipakai untuk menerima kode OTP via SMS.
5. Perangkat dengan kamera. Untuk swafoto yang akan dicocokkan dengan data Dukcapil.
6. Data pekerjaan dan sumber penghasilan. Misalnya karyawan, pekerja bebas, atau usahawan.

Satu hal yang sering membuat pendaftaran gagal: data KTP dan KK tidak sinkron dengan database Dukcapil. Jika alamat berbeda, nama tidak persis sama, atau status perkawinan belum diperbarui, validasi otomatis akan menolak. Pastikan data kependudukanmu sudah benar sebelum mendaftar, perbaiki dulu ke Disdukcapil bila ada yang tidak sesuai.

Langkah-Langkah Cara Membuat NPWP Online 2026 via Coretax

Berikut alur pendaftaran untuk wajib pajak orang pribadi di portal Coretax.

1. Buka coretaxdjp.pajak.go.id di browser HP atau laptop.
2. Klik menu Daftar di Sini untuk memulai pendaftaran baru.
3. Pilih jenis wajib pajak Perorangan.
4. Saat ditanya kepemilikan NIK, pilih Ya, lalu pilih opsi Aktivasi NIK agar NIK langsung berfungsi sebagai NPWP 16 digit.
5. Isi formulir data diri: nama lengkap, tempat dan tanggal lahir, status perkawinan, pekerjaan, dan Klasifikasi Lapangan Usaha (KLU) sesuai pekerjaanmu.
6. Isi alamat wajib pajak: alamat domisili, alamat korespondensi, dan alamat sesuai KTP. Jika domisili sama dengan KTP, gunakan opsi salin alamat.
7. Masukkan email aktif dan nomor HP aktif, lalu verifikasi keduanya dengan kode OTP yang dikirim sistem.
8. Lakukan swafoto dengan pencahayaan cukup dan wajah menghadap kamera. Sistem mencocokkan fotomu dengan database Dukcapil.
9. Baca kembali seluruh data, centang pernyataan bahwa data sudah benar, lalu klik Kirim Pengajuan atau Submit Application.
10. Tunggu notifikasi berhasil dan cek email yang kamu daftarkan.

Setelah pengajuan terkirim, kartu NPWP elektronik dalam format PDF beserta petunjuk login akun Coretax biasanya dikirim ke email dalam 1 sampai 3 hari kerja. Simpan baik-baik file PDF tersebut karena berfungsi sebagai kartu NPWP digital resmi.

Perbedaan Coretax dan eReg Pajak

Banyak yang masih bingung membedakan dua sistem ini karena namanya mirip. Tabel berikut merangkum perbedaannya agar kamu tidak salah alamat.

Intinya: jika kamu menemukan tutorial lama yang mengarahkan ke ereg.pajak.go.id, abaikan dan pakai Coretax. Sistem lama sudah tidak memproses pendaftaran baru sejak 1 Januari 2025.

Wajib Pajak Perorangan vs Badan: Mana yang Kamu Butuhkan

Panduan ini fokus pada wajib pajak orang pribadi, yaitu individu seperti karyawan, freelancer, dan pemilik usaha perorangan. Untuk kategori ini, aktivasi NIK sudah cukup dan prosesnya paling sederhana.

Jika kamu mendaftarkan badan usaha (PT, CV, yayasan), dokumennya lebih banyak: akta pendirian perusahaan, NPWP penanggung jawab (direktur atau komisaris), KTP penanggung jawab, surat keterangan domisili usaha, dan dokumen izin usaha seperti NIB. Alurnya tetap lewat Coretax dengan memilih jenis wajib pajak badan, tetapi verifikasi dokumennya lebih ketat. Untuk kebutuhan pribadi seperti melamar kerja atau membuka rekening, kategori perorangan adalah pilihan yang benar.

Masalah Umum Saat Daftar dan Solusinya

Empat kendala paling sering muncul saat pendaftaran NPWP online beserta cara mengatasinya.

Pertama, OTP tidak kunjung datang. Tunggu beberapa menit karena antrean SMS kadang padat, pastikan nomor HP aktif dan punya pulsa atau sinyal yang baik, lalu minta kirim ulang kode. Kedua, data ditolak karena tidak cocok dengan Dukcapil. Ini tanda ada perbedaan antara KTP/KK dan database kependudukan; perbaiki dulu ke Disdukcapil, jangan memaksa mengulang dengan data yang sama.

Ketiga, swafoto gagal terverifikasi berulang kali. Coba di ruangan terang, lepaskan masker dan kacamata hitam, dan pastikan wajah memenuhi bingkai kamera. Keempat, email konfirmasi tidak masuk. Periksa folder spam atau promosi, pastikan alamat email diketik benar, dan tunggu hingga 3 hari kerja sebelum menghubungi KPP.

Setelah NPWP Terbit: Yang Perlu Kamu Lakukan

NPWP yang sudah aktif membuka akses ke seluruh layanan Coretax dengan akun yang sama. Kamu bisa melaporkan SPT Tahunan, membayar pajak, dan mengurus administrasi perpajakan lain tanpa membuat akun terpisah. Simpan kredensial login Coretax di tempat aman dan jangan dibagikan ke siapa pun.

Bagi karyawan, serahkan nomor NPWP ke bagian HRD atau keuangan perusahaan agar pemotongan PPh 21 berjalan dengan tarif normal. Tanpa NPWP yang terdaftar, pemotongan pajak atas penghasilan bisa dikenakan tarif lebih tinggi. Bagi pelaku usaha, NPWP adalah syarat dasar mengurus perizinan lanjutan; misalnya pengajuan KUR BRI 2026 untuk modal usaha mensyaratkan dokumen identitas perpajakan yang valid.

Perlu diingat juga kewajiban setelah memiliki NPWP: melaporkan SPT Tahunan setiap tahun meski penghasilanmu belum kena pajak. Kewajiban ini berlaku sejak NPWP diterbitkan, jadi catat tenggatnya agar tidak terkena denda keterlambatan lapor.

Kapan Kamu Wajib Punya NPWP

Secara umum, NPWP wajib dimiliki oleh setiap orang pribadi yang sudah memenuhi syarat subjektif dan objektif sebagai wajib pajak, misalnya sudah berpenghasilan di atas batas Penghasilan Tidak Kena Pajak (PTKP) atau menjalankan usaha. Namun dalam praktiknya, NPWP juga dibutuhkan jauh sebelum itu: melamar pekerjaan formal, membuka rekening tertentu, mengajukan kredit bank, mengurus paspor untuk keperluan tertentu, sampai mengikuti lelang pemerintah.

Bagi mahasiswa tingkat akhir, memiliki NPWP sejak dini adalah langkah antisipatif yang cerdas. Prosesnya gratis dan kini bisa selesai dari HP, jadi tidak ada alasan menundanya sampai terdesak kebutuhan. Simpan nomor NPWP dan file kartu elektroniknya di tempat yang mudah ditemukan, misalnya di folder dokumen penting di HP, karena nomor ini akan ditanyakan berulang kali sepanjang kariermu.

FAQ Cara Membuat NPWP Online 2026

1. Apakah ereg.pajak.go.id masih bisa dipakai untuk daftar NPWP?
Tidak. Sejak Coretax beroperasi penuh pada 1 Januari 2025, situs ereg.pajak.go.id sudah tidak aktif untuk pendaftaran wajib pajak baru. Satu-satunya jalur resmi adalah coretaxdjp.pajak.go.id.

2. Saya sudah punya NIK, apakah masih perlu daftar NPWP?
NIK memang sudah terintegrasi sebagai NPWP 16 digit, tetapi kamu tetap perlu melakukan aktivasi NIK lewat Coretax agar bisa memakai layanan perpajakan seperti lapor SPT. Tanpa aktivasi, NIK-mu belum terdaftar sebagai wajib pajak aktif di sistem.

3. Berapa biaya membuat NPWP online?
Gratis, tidak dipungut biaya apa pun. Jika ada pihak yang meminta bayaran untuk membuatkan NPWP, itu bukan jalur resmi dan patut dicurigai sebagai penipuan.

4. Berapa lama NPWP terbit setelah daftar?
Kartu NPWP elektronik (PDF) umumnya dikirim ke email dalam 1 sampai 3 hari kerja setelah data tervalidasi. Jika melebihi itu, periksa folder spam email atau hubungi KPP terdekat.

5. Bagaimana jika verifikasi wajah (swafoto) selalu gagal?
Pastikan pencahayaan cukup, wajah tidak tertutup masker atau kacamata hitam, dan foto tidak blur. Jika tetap gagal, kemungkinan data foto di Dukcapil sudah lama; kamu bisa memperbarui data biometrik ke Disdukcapil setempat lalu mencoba lagi.

6. Saya sudah punya NPWP lama, apakah perlu daftar ulang di Coretax?
Tidak perlu mendaftar ulang. Data NPWP lama sudah termigrasi ke sistem Coretax. Yang perlu kamu lakukan adalah membuat akun Coretax dan melakukan aktivasi memakai NIK serta data NPWP lamamu, agar bisa mengakses seluruh layanan perpajakan digital. Setelah aktivasi berhasil, nomor identitas perpajakanmu mengikuti format 16 digit berbasis NIK.

Kesimpulan

Cara membuat NPWP online 2026 intinya hanya tiga tahap besar: buka coretaxdjp.pajak.go.id dan pilih Aktivasi NIK, lengkapi data diri lalu verifikasi lewat OTP dan swafoto, kemudian tunggu kartu elektronik dikirim ke email. Siapkan e-KTP, KK, email, dan nomor HP aktif sebelumnya, dan pastikan datamu sinkron dengan Dukcapil agar validasi berjalan mulus.

NPWP adalah pintu masuk ke banyak urusan resmi, dari urusan pajak tahunan sampai pengajuan pembiayaan usaha. Kalau kamu berencana memakai NPWP untuk mengembangkan usaha, baca juga panduan KUR BRI 2026: syarat, tabel angsuran, dan cara pengajuan untuk UMKM yang sudah terjadwal terbit di blog ini.

Artikel ini memandu kamu mengecek status penerima PIP 2026 dari HP langkah demi langkah, menjelaskan arti setiap status yang muncul, merinci jadwal pencairan tiga termin tahun 2026, besaran bantuan per jenjang, sampai cara aktivasi rekening bagi penerima baru. Semua langkah mengacu pada portal resmi Kementerian Pendidikan Dasar dan Menengah (Kemendikdasmen).

Apa Itu Program Indonesia Pintar (PIP)

PIP adalah bantuan tunai pendidikan dari pemerintah untuk peserta didik dari keluarga kurang mampu. Tujuannya sederhana: memastikan anak usia sekolah tetap bisa belajar tanpa terkendala biaya. Penerima PIP umumnya berasal dari keluarga pemegang Kartu Indonesia Pintar (KIP), peserta Program Keluarga Harapan (PKH), yatim piatu, atau siswa yang diusulkan sekolah dan dinas pendidikan karena kondisi ekonominya.

Dana PIP disalurkan langsung ke rekening siswa penerima melalui bank penyalur, bukan lewat perantara. Karena penyaluran dilakukan bertahap dalam tiga termin sepanjang tahun, status tiap siswa bisa berbeda-beda. Inilah alasan kenapa mengecek status secara mandiri itu penting: kamu tidak perlu menunggu kabar dari sekolah untuk tahu apakah dana sudah masuk atau belum.

Perlu dicatat, sejak penataan kementerian, urusan pendidikan dasar dan menengah kini berada di bawah Kemendikdasmen, sehingga portal resmi PIP beralamat di pip.kemendikdasmen.go.id. Jika kamu menemukan tautan lama berdomain kemendikbud, pastikan tujuan akhirnya adalah situs resmi yang sama.

Syarat Umum Penerima PIP 2026

Sebelum mengecek, pastikan kamu memahami siapa saja yang berhak menerima PIP. Kriteria umumnya adalah peserta didik jenjang SD, SMP, SMA/SMK, atau pendidikan kesetaraan (Paket A/B/C) yang berasal dari keluarga miskin atau rentan miskin. Indikator yang dipakai antara lain kepemilikan KIP, terdaftar sebagai penerima PKH atau bansos lain, berstatus yatim/piatu/yatim piatu, atau diusulkan oleh sekolah berdasarkan pertimbangan khusus.

Data siswa diambil dari Data Pokok Pendidikan (Dapodik) yang diisi oleh sekolah. Artinya, jika data di Dapodik belum lengkap atau belum diperbarui, status penerima bisa belum muncul meski siswa sebenarnya memenuhi syarat. Kalau kamu yakin memenuhi syarat tetapi namamu tidak ditemukan, langkah yang benar adalah konfirmasi ke pihak sekolah atau dinas pendidikan setempat, bukan mengulang pengecekan berkali-kali.

Cara Cek Penerima PIP 2026 Lewat HP

Pengecekan dilakukan di portal resmi dan bisa dikerjakan sepenuhnya dari HP. Siapkan dua data ini sebelum mulai: NISN (Nomor Induk Siswa Nasional, 10 digit) dan NIK (Nomor Induk Kependudukan siswa, 16 digit). Keduanya biasanya tercantum di rapor, kartu pelajar, atau Kartu Keluarga.

1. Buka browser di HP (Chrome, Safari, atau browser lain), lalu kunjungi pip.kemendikdasmen.go.id.
2. Gulir halaman sampai menemukan bagian Cari Penerima PIP.
3. Masukkan NISN siswa pada kolom yang tersedia.
4. Masukkan NIK siswa sesuai data kependudukan.
5. Selesaikan verifikasi keamanan dengan menjawab soal perhitungan matematika sederhana atau mengisi kode captcha yang muncul di layar.
6. Klik tombol Cek Penerima PIP, lalu tunggu beberapa detik.
7. Baca hasil yang ditampilkan sistem.

Jika siswa tercatat sebagai penerima, sistem menampilkan nama, sekolah, wilayah, bank penyalur, dan status pencairan dana. Jika tidak tercatat, akan muncul keterangan bahwa siswa belum berstatus sebagai penerima pada pengecekan tersebut.

Tips agar pengecekan berhasil: pastikan NISN dan NIK diketik tanpa spasi dan sesuai persis dengan data di Kartu Keluarga. Kesalahan satu digit saja membuat data tidak ditemukan. Jika NISN tidak hafal, kamu bisa mencarinya dulu di situs referensi data Kemendikdasmen dengan kata kunci nama, tempat lahir, dan nama ibu kandung.

Memahami Arti Status Hasil Pengecekan

Hasil pengecekan tidak selalu berarti dana sudah cair. Berikut arti status yang umum muncul agar kamu tidak salah tafsir.

Status “belum ada keterangan dana masuk” bukan berarti gagal. Pencairan PIP 2026 dilakukan bertahap hingga Desember, jadi penerima termin akhir memang baru menerima di penghujung tahun. Selama namamu tercatat sebagai penerima, dana akan disalurkan sesuai jadwal terminnya.

Jadwal Pencairan PIP 2026: Tiga Termin

Penyaluran dana PIP 2026 dibagi ke dalam tiga termin sepanjang tahun. Berikut jadwalnya berdasarkan informasi penyaluran resmi.

Karena artikel ini tayang pada November 2026, pencairan yang sedang berjalan adalah termin ketiga. Jika statusmu menunjukkan penerima tetapi dana belum masuk, kemungkinan besar penyaluranmu dijadwalkan pada termin ini. Jadwal termin dapat berubah mengikuti kebijakan pemerintah, jadi pengecekan berkala tetap disarankan.

Besaran Bantuan PIP 2026 per Jenjang

Nominal bantuan berbeda menurut jenjang pendidikan dan disalurkan per semester. Berikut rinciannya.

Catatan penting: siswa baru atau siswa kelas akhir pada jenjang SD dan SMP menerima setengah dari nominal tahunan (Rp225.000 untuk SD, Rp375.000 untuk SMP), begitu juga siswa kelas akhir SMA/SMK yang menerima Rp900.000. Mulai tahun 2026, peserta didik TK juga mulai menerima bantuan PIP sebesar Rp450.000 per tahun. Dana ini khusus untuk kebutuhan pendidikan seperti buku, seragam, dan perlengkapan sekolah.

Bank Penyalur dan Cara Aktivasi Rekening

Dana PIP disalurkan melalui bank penyalur resmi: BRI untuk jenjang SD dan SMP, BNI untuk SMA dan SMK, serta BSI yang melayani seluruh jenjang. Rekening yang dipakai adalah rekening SimPel (Simpanan Pelajar) atas nama siswa.

Bagi penerima baru yang belum memiliki rekening aktif, wajib melakukan aktivasi terlebih dahulu. Caranya: datangi bank penyalur terdekat dengan membawa Surat Keputusan (SK) pemberian PIP atau surat keterangan dari sekolah, Kartu Keluarga, dan KTP orang tua atau wali. Petugas bank akan mengaktifkan rekening SimPel siswa. Setelah rekening aktif, dana bantuan akan masuk sesuai jadwal termin dan bisa ditarik atau dicek mutasinya. Penerima di bawah umur wajib didampingi orang tua atau wali saat aktivasi.

Kesalahan Umum Cara Cek Penerima PIP 2026 dan Solusinya

Banyak pengecekan gagal bukan karena datanya tidak ada, melainkan karena kesalahan teknis yang sebenarnya mudah diperbaiki. Pertama, salah ketik NISN atau NIK. NISN selalu 10 digit dan NIK 16 digit; pastikan tidak ada spasi atau angka yang tertukar. Salin dari Kartu Keluarga bila perlu.

Kedua, captcha tidak terbaca. Soal matematika di portal kadang tampil kecil di layar HP. Perbesar tampilan browser (zoom) sebelum menjawab, lalu klik cek ulang jika jawaban ditolak. Ketiga, situs tidak bisa dibuka atau lambat. Pada jam sibuk, terutama awal periode pencairan, trafik portal melonjak. Coba lagi di luar jam sibuk, misalnya pagi hari, atau gunakan mode desktop di browser HP.

Keempat, data tidak ditemukan padahal merasa berhak. Selain memastikan ketikan benar, ingat bahwa data berasal dari Dapodik. Jika sekolah belum memasukkan atau memperbarui datamu, portal tidak akan menampilkannya. Solusinya adalah meminta operator sekolah memeriksa dan memperbaiki data Dapodik, bukan mengulang pengecekan tanpa henti.

FAQ Cek Penerima PIP 2026

1. Apakah cek PIP harus pakai NISN dan NIK sekaligus?
Ya. Portal resmi meminta NISN (10 digit) dan NIK (16 digit) siswa beserta verifikasi keamanan. Tanpa kedua data yang valid, sistem tidak bisa menemukan data penerima.

2. Saya sudah cek tetapi nama tidak ditemukan, apa yang harus dilakukan?
Pertama, pastikan NISN dan NIK diketik benar tanpa spasi. Jika tetap tidak ditemukan, kemungkinan data belum tervalidasi di Dapodik atau kamu belum masuk kuota termin berjalan. Konfirmasikan ke pihak sekolah atau dinas pendidikan setempat untuk memastikan status usulanmu.

3. Kapan dana PIP termin 3 tahun 2026 cair?
Termin ketiga disalurkan pada periode Oktober sampai Desember 2026. Pencairan tidak serentak, melainkan bertahap per wilayah dan per jenjang, jadi pantau status di portal resmi secara berkala.

4. Apakah dana PIP bisa hangus jika tidak segera diambil?
Dana yang sudah masuk ke rekening SimPel aman tersimpan di rekening siswa. Namun penerima baru yang belum aktivasi rekening tidak akan menerima transfer dana sampai aktivasi selesai. Segera aktivasi begitu namamu tercatat sebagai penerima.

5. Apakah siswa madrasah bisa menerima PIP?
Bisa. Siswa madrasah di bawah Kementerian Agama juga tercakup dalam skema bantuan dengan besaran yang sama, mengikuti ketentuan penyaluran yang berlaku.

6. Apakah penerima PIP bisa juga mendapat KIP Kuliah?
Bisa, karena keduanya adalah program berbeda di jenjang yang berbeda. PIP menyasar siswa sekolah, sedangkan KIP Kuliah menyasar mahasiswa. Selama kamu memenuhi syarat di masing-masing jenjang, keduanya tidak saling menggugurkan. Justru riwayat sebagai penerima PIP sering menjadi nilai tambah saat pengajuan KIP Kuliah karena datamu sudah tercatat di sistem bantuan pendidikan.

Kesimpulan

Cara cek penerima PIP 2026 lewat HP hanya butuh tiga langkah inti: buka pip.kemendikdasmen.go.id, masukkan NISN dan NIK, lalu baca statusnya. Pahami jadwal tiga termin dan arti tiap status agar kamu tidak panik ketika dana belum masuk, dan segera aktivasi rekening SimPel kalau kamu penerima baru.

Buat kamu yang sudah lulus SMA dan melanjutkan ke perguruan tinggi, ada bantuan sejenis di jenjang kuliah. Baca juga panduan cara daftar KIP Kuliah 2026 yang sudah terbit di blog ini untuk memahami syarat, jadwal, dan alur pendaftarannya.

Artikel ini membahas tuntas cara membuat form validasi di Laravel 12, mulai dari metode $request->validate() yang paling cepat, daftar aturan validasi yang paling sering dipakai, cara membuat pesan error kustom dalam Bahasa Indonesia, sampai merapikan kode memakai Form Request class. Di akhir ada contoh menampilkan error di Blade dan tips memakai validasi untuk REST API.

Kenapa Validasi Form Itu Wajib

Validasi adalah proses memastikan data yang dikirim pengguna memenuhi syarat sebelum diproses lebih lanjut. Tanpa validasi, aplikasi rentan terhadap tiga masalah besar. Pertama, data tidak konsisten, misalnya kolom email berisi teks biasa atau tanggal lahir berisi angka acak. Kedua, celah keamanan, karena input berbahaya bisa lolos ke database. Ketiga, pengalaman pengguna yang buruk, karena kesalahan baru ketahuan belakangan tanpa penjelasan yang jelas.

Laravel menyelesaikan ketiga masalah ini dengan sistem validasi yang ekspresif. Kamu cukup mendeklarasikan aturan dalam bentuk array, dan Laravel otomatis memeriksa input, mengembalikan pengguna ke form sebelumnya bila ada yang salah, lengkap dengan pesan error dan input lama yang sudah terisi. Semua ini terjadi tanpa kamu menulis logika pengecekan manual yang panjang.

Cara Kerja $request->validate() untuk Form Validasi Laravel 12

Cara tercepat memvalidasi form adalah memanggil metode validate() pada objek $request di dalam controller. Perhatikan contoh berikut untuk form pembuatan artikel.

<?php

namespace App\Http\Controllers;

use App\Models\Post;
use Illuminate\Http\Request;

class PostController extends Controller
{
    public function create()
    {
        return view('posts.create');
    }

    public function store(Request $request)
    {
        $validated = $request->validate([
            'title'       => 'required|string|min:5|max:100',
            'slug'        => 'required|string|unique:posts,slug',
            'body'        => 'required|string|min:20',
            'category_id' => 'required|exists:categories,id',
            'published_at'=> 'nullable|date',
        ]);

        Post::create($validated);

        return redirect('/posts')->with('success', 'Artikel berhasil disimpan.');
    }
}

Ada tiga hal penting dari kode di atas. Pertama, aturan ditulis sebagai string yang dipisahkan karakter pipe (|), misalnya required|string|min:5. Kedua, metode validate() mengembalikan array $validated yang hanya berisi field yang lolos aturan, sehingga aman langsung dipakai untuk Post::create(). Ketiga, jika validasi gagal, Laravel otomatis mengembalikan (redirect back) pengguna ke halaman form sebelumnya sambil membawa pesan error dan input lama, jadi kamu tidak perlu menulis logika itu sendiri.

Kalau kamu mengikuti seri Laravel di blog ini dari tutorial CRUD Laravel 12, pola di atas akan terasa familiar karena melengkapi proses store dan update yang sudah dibahas di sana.

Aturan Form Validasi Laravel 12 yang Paling Sering Dipakai

Laravel menyediakan puluhan aturan validasi siap pakai. Berikut tabel aturan yang paling sering dipakai dalam form validasi Laravel 12 beserta artinya.

Aturan unique dan exists sangat berguna karena langsung memeriksa ke database tanpa query manual. Contoh unique:users,email memastikan tidak ada dua pengguna dengan email yang sama, sedangkan exists:categories,id memastikan kategori yang dipilih benar-benar ada.

Untuk form edit data, aturan unique perlu pengecualian agar data milik sendiri tidak dianggap duplikat. Caranya dengan menambahkan ID yang dikecualikan, contoh: unique:posts,slug,10 (mengabaikan baris ber-ID 10) atau memakai sintaks lengkap Rule::unique('posts')->ignore($post->id).

Membuat Pesan Error Kustom Bahasa Indonesia

Secara bawaan, pesan error validasi Laravel berbahasa Inggris, misalnya “The title field is required.” Untuk aplikasi berbahasa Indonesia, kamu bisa menggantinya dengan pesan kustom lewat parameter kedua metode validate().

$validated = $request->validate(
    [
        'title'    => 'required|string|min:5|max:100',
        'email'    => 'required|email|unique:users,email',
        'password' => 'required|string|min:8|confirmed',
    ],
    [
        'title.required'      => 'Judul wajib diisi.',
        'title.min'           => 'Judul minimal :min karakter.',
        'title.max'           => 'Judul maksimal :max karakter.',
        'email.required'      => 'Alamat email wajib diisi.',
        'email.email'         => 'Format email tidak valid.',
        'email.unique'        => 'Email ini sudah terdaftar, silakan pakai email lain.',
        'password.required'   => 'Kata sandi wajib diisi.',
        'password.min'        => 'Kata sandi minimal :min karakter.',
        'password.confirmed'  => 'Konfirmasi kata sandi tidak sama.',
    ]
);

Kunci array pesan memakai format {nama_field}.{nama_aturan}, sehingga kamu bisa mengatur pesan berbeda untuk tiap kombinasi field dan aturan. Placeholder seperti :min dan :max otomatis diganti Laravel dengan angka dari aturan yang dipakai, jadi pesan tetap dinamis.

Jika pesan kustom dipakai di banyak form, pendekatan yang lebih rapi adalah menerjemahkan seluruh file bahasa validasi. Salin file lang/en/validation.php menjadi lang/id/validation.php, ubah isinya ke Bahasa Indonesia, lalu set 'locale' => 'id' di config/app.php. Dengan begitu seluruh aplikasi memakai pesan Bahasa Indonesia tanpa mengulang array pesan di setiap controller.

Merapikan Kode dengan Form Request Class

Ketika aturan validasi mulai banyak, menaruhnya di controller membuat metode store() terlihat penuh. Solusi resminya adalah Form Request: class khusus yang menampung aturan validasi, pesan kustom, dan logika otorisasi. Buat dengan Artisan:

php artisan make:request StorePostRequest

Perintah itu menghasilkan file app/Http/Requests/StorePostRequest.php. Isi dengan aturan dan pesanmu:

<?php

namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;

class StorePostRequest extends FormRequest
{
    public function authorize(): bool
    {
        return true;
    }

    public function rules(): array
    {
        return [
            'title'       => 'required|string|min:5|max:100',
            'slug'        => 'required|string|unique:posts,slug',
            'body'        => 'required|string|min:20',
            'category_id' => 'required|exists:categories,id',
        ];
    }

    public function messages(): array
    {
        return [
            'title.required'  => 'Judul wajib diisi.',
            'title.min'       => 'Judul minimal :min karakter.',
            'slug.unique'     => 'Slug ini sudah dipakai artikel lain.',
            'body.required'   => 'Isi artikel wajib diisi.',
            'category_id.exists' => 'Kategori yang dipilih tidak valid.',
        ];
    }
}

Metode authorize() menentukan apakah pengguna boleh melakukan request ini; kembalikan true untuk mengizinkan semua, atau tulis logika izin di sana. Lalu pakai class ini sebagai type-hint di controller:

use App\Http\Requests\StorePostRequest;

public function store(StorePostRequest $request)
{
    $validated = $request->validated();

    Post::create($validated);

    return redirect('/posts')->with('success', 'Artikel berhasil disimpan.');
}

Validasi berjalan otomatis sebelum kode di dalam metode dieksekusi. Controller menjadi bersih dan hanya fokus pada logika bisnis. Pola Form Request ini juga dipakai di form autentikasi seperti pada tutorial login dan register dengan Breeze, sehingga layak kamu kuasai sejak awal.

Membuat Aturan Validasi Sendiri

Kadang aturan bawaan tidak cukup, misalnya kamu ingin menolak judul yang mengandung kata terlarang tertentu. Laravel 12 menyediakan perintah Artisan untuk membuat rule kustom.

php artisan make:rule NoSpamWord

Perintah itu membuat class app/Rules/NoSpamWord.php. Implementasikan logika di metode validate():

<?php

namespace App\Rules;

use Closure;
use Illuminate\Contracts\Validation\ValidationRule;

class NoSpamWord implements ValidationRule
{
    public function validate(string $attribute, mixed $value, Closure $fail): void
    {
        $kataTerlarang = ['gratis', 'promo', 'diskon'];

        foreach ($kataTerlarang as $kata) {
            if (str_contains(strtolower($value), $kata)) {
                $fail('Kolom :attribute mengandung kata yang tidak diizinkan.');
                return;
            }
        }
    }
}

Pakai rule kustom ini seperti aturan biasa dengan membuat instance-nya di array aturan:

use App\Rules\NoSpamWord;

$request->validate([
    'title' => ['required', 'string', 'min:5', new NoSpamWord],
]);

Perhatikan bahwa aturannya ditulis sebagai array (bukan string pipe) ketika dicampur dengan objek rule. Placeholder :attribute otomatis diganti dengan nama field. Rule kustom cocok untuk logika bisnis yang spesifik dan dipakai di banyak form.

Menampilkan Error di Blade

Pesan error yang dihasilkan validasi tersedia di view lewat variabel $errors. Pola yang umum dipakai adalah menampilkan ringkasan di atas form dan pesan per field di bawah inputnya.

@if ($errors->any())
    <div class="alert alert-danger">
        <ul>
            @foreach ($errors->all() as $error)
                <li>{{ $error }}</li>
            @endforeach
        </ul>
    </div>
@endif

<form method="POST" action="/posts">
    @csrf

    <label for="title">Judul</label>
    <input type="text" name="title" id="title" value="{{ old('title') }}">
    @error('title')
        <small class="text-danger">{{ $message }}</small>
    @enderror

    <label for="body">Isi Artikel</label>
    <textarea name="body" id="body">{{ old('body') }}</textarea>
    @error('body')
        <small class="text-danger">{{ $message }}</small>
    @enderror

    <button type="submit">Simpan</button>
</form>

Directive @error('title') hanya merender isinya jika field title memiliki pesan error, dan variabel $message berisi teks error tersebut. Fungsi old('title') mengisi kembali input dengan nilai yang dikirim pengguna sebelumnya, sehingga mereka tidak perlu mengetik ulang seluruh form hanya karena satu field salah. Kombinasi ketiganya menghasilkan form yang ramah pengguna dengan sedikit kode.

Tips Validasi untuk REST API

Untuk endpoint API, perilaku bawaan validate() yang me-redirect kurang cocok karena klien API mengharapkan respons JSON. Laravel menanganinya otomatis: jika request memiliki header Accept: application/json, kegagalan validasi mengembalikan respons JSON berisi pesan error dengan status 422, tanpa redirect. Jadi aturan yang sama bisa dipakai ulang untuk API.

Untuk struktur API yang lebih terkontrol, validasi juga bisa dilakukan manual dengan Validator::make() agar kamu mengatur sendiri format responsnya. Pembahasan lengkap pola ini ada di artikel cara membuat REST API dengan Laravel yang sudah terbit di blog ini.

Kesimpulan

Form validasi Laravel 12 memberimu tiga lapis kemudahan: $request->validate() untuk kebutuhan cepat, pesan error kustom Bahasa Indonesia agar pengguna paham kesalahannya, dan Form Request class untuk kode yang rapi dan bisa dipakai ulang. Aturan seperti required, unique, exists, dan confirmed mencakup sebagian besar kebutuhan form sehari-hari tanpa query manual.

Mulailah dengan menerapkan validasi pada satu form yang sudah kamu buat, misalnya form tambah artikel dari seri CRUD, lalu pindahkan aturannya ke Form Request saat form mulai kompleks. Kalau kamu ingin mendalami alur autentikasi yang juga mengandalkan validasi berat, baca juga tutorial Laravel 12 membuat fitur login dan register dengan Breeze sebagai latihan berikutnya.

Kalau kamu belum familier dengan dasar Git seperti commit dan push, baca dulu Tutorial Git dan GitHub untuk Pemula: Dari Instalasi sampai Push Pertama. Artikel ini mengasumsikan kamu sudah bisa membuat repository, commit perubahan, dan push ke GitHub, lalu fokus sepenuhnya pada dunia branching.

Git Branching Pemula: Kenapa Butuh Branch

Branch adalah cabang dari riwayat commit yang memungkinkanmu bekerja secara terisolasi. Analogi paling pas: branch main adalah jalan tol yang harus selalu mulus dan bisa dipakai, sedangkan branch fitur adalah jalan kecil tempatmu bereksperimen. Bila eksperimenmu gagal, jalan tol tetap aman. Bila berhasil, kamu menggabungkannya kembali ke jalan tol dengan terkendali.

Tanpa branch, semua orang commit langsung ke main dan risiko tabrakan sangat tinggi. Dengan branch, setiap fitur atau perbaikan bug dikerjakan di cabangnya sendiri, diuji sampai yakin, baru digabung. Inilah fondasi kolaborasi modern yang dipakai dari startup kecil sampai perusahaan teknologi raksasa.

Satu hal yang perlu diluruskan: membuat branch di Git itu murah dan instan, tidak seperti membuat salinan folder secara manual. Branch hanyalah penanda yang menunjuk ke sebuah commit, jadi jangan ragu membuatnya untuk setiap pekerjaan, sekecil apa pun itu.

Membuat dan Berpindah Branch

Perintah dasarnya sederhana. Untuk melihat daftar branch yang ada, jalankan git branch. Branch yang aktif ditandai bintang. Untuk membuat branch baru sekaligus pindah ke sana, cara modernnya memakai git switch -c.

# Lihat branch yang ada
git branch
# * main

# Buat branch baru "fitur-login" dan langsung pindah ke sana
git switch -c fitur-login

# Verifikasi posisi
git branch
#   main
# * fitur-login

Perintah lama git checkout -b fitur-login melakukan hal yang sama dan masih banyak dipakai di tutorial lama, jadi kenali keduanya. Namun untuk pemula, biasakan git switch karena lebih jelas maksudnya: switch untuk berpindah, sedangkan checkout versi lama punya terlalu banyak fungsi ganda yang membingungkan.

Setelah pindah branch, semua commit yang kamu buat hanya tercatat di branch tersebut. Branch main tidak tersentuh sama sekali sampai kamu memutuskan untuk merge. Untuk kembali ke main, cukup jalankan git switch main. Kamu bisa berpindah bolak-balik dengan aman selama tidak ada perubahan yang belum di-commit.

Merge: Menggabungkan Branch Kembali

Setelah pekerjaan di branch fitur selesai dan sudah di-commit, saatnya menggabungkannya ke main. Alurnya selalu sama: pindah dulu ke branch tujuan, lalu merge branch sumber ke dalamnya.

# 1. Pindah ke branch tujuan (main)
git switch main

# 2. Pastikan main dalam kondisi terbaru
git pull origin main

# 3. Gabungkan branch fitur-login ke main
git merge fitur-login

Bila tidak ada konflik, Git melakukan fast-forward merge: penanda main tinggal dimajukan ke commit terbaru dari branch fitur. Riwayatnya tetap linear dan bersih. Inilah skenario ideal yang terjadi bila tidak ada orang lain yang mengubah baris yang sama selama kamu bekerja.

Setelah merge berhasil dan sudah di-push, branch fitur yang sudah tidak dipakai sebaiknya dihapus agar daftar branch tetap rapi.

# Hapus branch lokal yang sudah di-merge
git branch -d fitur-login

# Hapus branch di remote (GitHub)
git push origin --delete fitur-login

Flag -d hanya mau menghapus branch yang sudah di-merge, sehingga aman dari kecelakaan. Bila kamu yakin ingin menghapus branch yang belum di-merge, barulah pakai -D dengan penuh kesadaran.

Simulasi Merge Conflict dan Cara Me-resolve

Merge conflict terjadi saat dua branch mengubah baris yang sama pada file yang sama, sehingga Git tidak bisa memutuskan versi mana yang benar. Ini bukan error yang harus ditakuti, melainkan Git yang meminta keputusanmu secara eksplisit. Mari simulasikan supaya kamu mengalaminya di lingkungan aman.

Pertama siapkan skenario konfliknya. Buat file catatan.txt di branch main, commit, lalu buat branch fitur-a yang mengubah baris pertama file itu dan commit. Kembali ke main, ubah baris pertama yang sama dengan isi berbeda, dan commit juga.

# Di main: buat file awal
echo "Baris pertama versi awal" > catatan.txt
git add catatan.txt
git commit -m "Tambah catatan awal"

# Buat branch fitur-a dan ubah baris pertama
git switch -c fitur-a
echo "Baris pertama versi fitur A" > catatan.txt
git add catatan.txt
git commit -m "Ubah baris pertama di fitur-a"

# Kembali ke main dan ubah baris pertama yang sama
git switch main
echo "Baris pertama versi main" > catatan.txt
git add catatan.txt
git commit -m "Ubah baris pertama di main"

# Coba merge: KONFLIK!
git merge fitur-a

Git akan melaporkan CONFLICT (content): Merge conflict in catatan.txt dan menghentikan proses merge. Buka file tersebut dan kamu akan melihat penanda konflik seperti ini.

<<<<<<< HEAD
Baris pertama versi main
=======
Baris pertama versi fitur A
>>>>>>> fitur-a

Bagian antara <<<<<<< HEAD dan ======= adalah versimu saat ini (main), sedangkan antara ======= dan >>>>>>> fitur-a adalah versi dari branch yang di-merge. Tugasmu sederhana: edit file menjadi versi final yang benar, lalu hapus semua penanda konfliknya.

# Setelah mengedit file menjadi versi final:
# "Baris pertama versi gabungan yang benar"

# Tandai konflik selesai
git add catatan.txt

# Selesaikan merge dengan commit
git commit -m "Resolve conflict: gabungkan perubahan main dan fitur-a"

Kunci menghadapi konflik adalah tetap tenang dan baca penandanya baik-baik. Konflik hampir selalu hanya soal beberapa baris, bukan seluruh file. Editor modern seperti VS Code bahkan menampilkan tombol Accept Current Change dan Accept Incoming Change sehingga kamu cukup klik. Setelah terbiasa, menyelesaikan konflik hanya butuh waktu satu dua menit.

Alur Pull Request Sederhana untuk Kolaborasi Tim

Di tim profesional, merge langsung ke main dari lokal biasanya dilarang. Sebagai gantinya dipakai pull request (PR), yaitu permintaan peninjauan sebelum kode digabung. Alurnya memberi lapisan keamanan berupa review dari rekan tim dan pengecekan otomatis.

Alur sederhananya begini. Pertama, push branch fiturmu ke GitHub dengan git push origin fitur-login. Kedua, buka halaman repository di GitHub dan klik tombol Compare and pull request yang muncul otomatis. Ketiga, tulis deskripsi perubahan dengan jelas: apa yang diubah dan kenapa. Keempat, minta rekan tim me-review. Mereka bisa memberi komentar per baris kode dan meminta perbaikan sebelum menyetujui.

Kelima, setelah disetujui, klik Merge pull request di GitHub. GitHub menawarkan tiga mode merge: Create a merge commit yang jujur mencatat riwayat, Squash and merge yang memadatkan semua commit branch menjadi satu commit rapi di main, dan Rebase and merge yang menempelkan commit satu per satu. Untuk pemula, squash and merge paling rapi karena satu fitur menjadi satu commit di main.

Keenam, hapus branch fitur dari GitHub setelah di-merge dan sinkronkan lokalmu dengan git switch main lalu git pull. Siklus ini berulang untuk setiap fitur. Mungkin terdengar panjang, tetapi setelah dua tiga kali praktik, alurnya menjadi kebiasaan yang hanya butuh beberapa menit.

Git Branching Pemula: Aturan Main yang Disarankan

Supaya branching tetap rapi saat tim membesar, ikuti beberapa konvensi sederhana. Pertama, beri nama branch yang deskriptif dengan awalan jenis pekerjaannya, misalnya fitur/login-google, perbaikan/bug-tombol-kirim, atau docs/update-readme. Hindari nama seperti branch-baru atau coba-coba yang tidak memberi informasi apa pun.

Kedua, buat branch dari main yang terbaru. Sebelum membuat branch baru, selalu git switch main lalu git pull dulu supaya titik berangkatmu mutakhir. Ketiga, jaga branch tetap pendek umur: semakin lama branch hidup terpisah, semakin besar peluang konfliknya. Usahakan satu branch selesai dan di-merge dalam hitungan hari, bukan minggu.

Keempat, commit kecil dan sering dengan pesan yang jelas di setiap branch. Riwayat commit yang granular memudahkan review dan memudahkan melacak kapan bug muncul. Kelima, jangan pernah commit langsung ke main bila sudah bekerja dalam tim. Jadikan branch dan pull request sebagai satu-satunya jalan menuju main, tanpa pengecualian.

Cheat Sheet Perintah Git Branching

Tabel berikut merangkum semua perintah penting dari artikel ini untuk ditempel di catatanmu.

Perintah git log --oneline --graph --all layak mendapat perhatian khusus karena menampilkan visualisasi cabang yang sangat membantu memahami apa yang terjadi. Jalankan sesekali untuk melihat bagaimana branch-branchmu bercabang dan bergabung kembali.

Langkah Selanjutnya

Kamu sekarang menguasai inti git branching pemula: membuat dan berpindah branch dengan switch, menggabungkan dengan merge, menyelesaikan merge conflict tanpa panik, sampai alur pull request yang dipakai tim profesional. Kombinasikan dengan dasar commit dan push yang sudah kamu kuasai, dan kamu siap berkolaborasi di proyek tim sungguhan.

Satu konvensi yang dipakai hampir semua tim profesional adalah pola penamaan branch yang konsisten, misalnya fitur/login-google, fix/bug-validasi, atau hotfix/crash-checkout. Nama seperti ini membuat isi branch langsung terbaca dari daftar branch tanpa harus membuka commit-nya. Biasakan juga menghapus branch lokal yang sudah di-merge dan tidak dipakai lagi agar daftar branch tetap bersih. Dua kebiasaan sederhana ini membuat kolaborasimu terlihat profesional sejak hari pertama.

Praktik terbaik berikutnya adalah membiasakan alur ini di proyek pribadimu sendiri, misalnya proyek Laravel yang sedang kamu bangun. Setiap selesai satu bab dari Tutorial Git dan GitHub untuk Pemula, buat branch baru untuk latihan bab berikutnya. Kebiasaan kecil inilah yang membedakan developer yang siap kerja tim dengan yang hanya bisa ngoding sendirian.

Composer adalah dependency manager untuk PHP, artinya tugasnya mengunduh, memperbarui, dan mengatur library yang dibutuhkan proyekmu beserta seluruh dependensinya. Tanpa Composer, kamu harus mengunduh library satu per satu secara manual dan pusing mengatur versi yang cocok. Dengan Composer, satu perintah cukup untuk menyelesaikan semuanya dengan aman dan konsisten.

Cara Menggunakan Composer Laravel: Pengenalan dan Fungsi

Analogi paling pas untuk Composer adalah manajer paket seperti Play Store, tetapi untuk kode PHP. Saat proyekmu butuh fitur tertentu, misalnya manajemen hak akses pengguna, kamu tidak perlu menulisnya dari nol. Kamu cukup meminta Composer menginstal package yang sudah teruji oleh komunitas, dan Composer mengurus sisanya: mengunduh versi yang cocok, memastikan tidak bentrok dengan package lain, dan mendaftarkannya agar bisa dipakai.

Tiga file adalah jantung cara kerja Composer. File composer.json berisi daftar package yang dibutuhkan proyek beserta versinya, dan file ini wajib masuk version control seperti Git. File composer.lock mencatat versi persis yang terinstal saat ini agar semua anggota tim memakai versi identik. Folder vendor berisi kode package yang diunduh, dan folder ini tidak boleh masuk Git karena bisa dibuat ulang kapan saja dengan satu perintah.

Setiap proyek Laravel yang kamu buat dengan laravel new sebenarnya sudah memakai Composer di balik layar. Jadi kemungkinan besar kamu sudah menjadi pengguna Composer tanpa sadar. Artikel ini membuatmu memahaminya secara sadar dan percaya diri.

Menginstal Composer di Windows

Bila kamu mengikuti Cara Install XAMPP dan Menjalankan Program PHP Pertama, PHP sudah tersedia di komputermu dan Composer bisa langsung dipasang. Unduh installer resmi dari getcomposer.org, tepatnya file Composer-Setup.exe untuk Windows.

Jalankan installer dan pada langkah pemilihan PHP, arahkan ke file php.exe milik XAMPP yang biasanya ada di C:\xampp\php\php.exe. Installer akan mendaftarkan Composer ke PATH Windows sehingga perintah composer bisa dijalankan dari terminal mana pun. Selesaikan wizard sampai akhir, lalu tutup dan buka kembali terminal agar perubahan PATH terbaca.

Untuk pengguna yang memakai PHP terpisah atau Laragon, prinsipnya sama: tunjukkan installer ke php.exe yang aktif dipakai. Bila kamu memakai lebih dari satu versi PHP, pastikan Composer menunjuk ke versi yang sama dengan yang dipakai proyekmu untuk menghindari konflik dependensi.

Verifikasi: Memastikan Composer Terpasang Benar

Buka Command Prompt atau PowerShell baru, lalu jalankan perintah berikut.

composer --version

Bila muncul tulisan seperti Composer version 2.x.x, instalasi berhasil. Angka 2 di depan menandakan Composer versi 2 yang jauh lebih cepat dan hemat memori dibanding versi 1. Bila perintah tidak dikenali, berarti PATH belum terbaca: tutup semua jendela terminal, buka yang baru, dan coba lagi. Bila masih gagal, ulangi instalasi dan pastikan opsi penambahan ke PATH tidak dilewatkan.

Perintah berguna kedua untuk verifikasi adalah composer diagnose, yang memeriksa koneksi ke repositori package dan memberi tahu bila ada masalah jaringan atau konfigurasi. Jalankan sesekali bila instalasi package gagal tanpa pesan yang jelas.

Memahami composer.json dan composer.lock

Buka file composer.json di proyek Laravel-mu dan perhatikan strukturnya. Bagian require berisi package wajib beserta batasan versinya, sedangkan require-dev berisi package khusus pengembangan seperti testing yang tidak ikut ke production.

{
    "require": {
        "php": "^8.2",
        "laravel/framework": "^12.0",
        "spatie/laravel-permission": "^6.0"
    },
    "require-dev": {
        "phpunit/phpunit": "^11.0"
    }
}

Tanda ^ (caret) artinya boleh memakai versi minor dan patch terbaru selama versi major-nya sama. Jadi ^12.0 mengizinkan 12.1 atau 12.9, tetapi tidak 13.0. Aturan ini menjaga kompatibilitas sambil tetap mendapat perbaikan bug otomatis.

File composer.lock dibuat otomatis saat pertama kali dependensi diinstal. Ia mengunci versi persis setiap package termasuk dependensi transitifnya. Saat rekan tim menjalankan composer install, Composer membaca file lock ini sehingga semua orang mendapat versi yang identik. Inilah kenapa composer.lock wajib di-commit ke Git, sedangkan folder vendor tidak.

Empat Perintah Composer yang Wajib Dikuasai

Hampir semua pekerjaan Composer sehari-hari hanya memakai empat perintah berikut. Pahami perbedaannya baik-baik karena tertukar memakainya adalah sumber bug klasik.

composer require dipakai untuk menambah package baru ke proyek. Perintah ini mengunduh package, menambahkannya ke composer.json, dan memperbarui composer.lock sekaligus.

composer require spatie/laravel-permission

composer update dipakai untuk menaikkan versi package yang sudah ada ke versi terbaru sesuai batasan di composer.json. Hati-hati: perintah tanpa argumen ini memperbarui SEMUA package sekaligus, yang berisiko bila ada perubahan breaking. Untuk aman, sebutkan nama package-nya secara spesifik.

composer update spatie/laravel-permission

composer remove adalah kebalikan dari require: menghapus package dari proyek, composer.json, dan composer.lock sekaligus.

composer remove spatie/laravel-permission

composer install dipakai saat kamu baru meng-clone proyek dari Git. Perintah ini membaca composer.lock dan mengunduh versi persis yang terkunci, sehingga lingkunganmu identik dengan tim. Inilah perintah pertama yang harus dijalankan setiap menerima proyek Laravel dari orang lain, sebelum php artisan migrate atau perintah lainnya.

Selain empat perintah utama, ada dua perintah bantu yang berguna untuk audit. Perintah composer show menampilkan daftar package yang terinstal beserta versinya, sedangkan composer outdated menunjukkan package mana yang sudah punya versi lebih baru tersedia. Keduanya bersifat read-only sehingga aman dijalankan kapan saja tanpa mengubah apa pun di proyekmu.

Autoload PSR-4: Cara Composer Menemukan Class-mu

Salah satu keajaiban Composer yang jarang disadari pemula adalah autoloading. Dulu developer PHP harus menulis require manual untuk setiap file class. Composer menghilangkan kebutuhan itu lewat standar PSR-4 yang memetakan namespace ke struktur folder.

Lihat bagian autoload di composer.json proyek Laravel.

"autoload": {
    "psr-4": {
        "App\\": "app/",
        "Database\\Factories\\": "database/factories/"
    }
}

Artinya class App\Models\Post otomatis dipetakan ke file app/Models/Post.php. Selama kamu mengikuti konvensi penamaan ini, kamu tidak pernah perlu menulis require manual. Setiap kali menambah namespace baru, jalankan composer dump-autoload agar peta autoload dibuat ulang.

Pemahaman ini menjelaskan kenapa perintah Artisan seperti make:model selalu menaruh file di lokasi yang tepat. Framework dan Composer sudah sepakat soal konvensi, dan tugasmu hanyalah mengikutinya.

Cara Menggunakan Composer Laravel: Studi Kasus Install Package Nyata

Mari praktikkan alur lengkap dengan package nyata yang populer: spatie/laravel-permission untuk manajemen role dan permission. Package ini dipakai ribuan proyek production dan menjadi contoh sempurna.

Langkah pertama, instal package-nya di proyek Laravel-mu.

composer require spatie/laravel-permission

Composer akan mengunduh package beserta dependensinya, lalu memperbarui composer.json dan composer.lock. Perhatikan outputnya: Composer memberitahu versi persis yang dipasang dan apakah ada dependensi tambahan yang ikut diunduh.

Langkah kedua, publikasikan file konfigurasi dan migrasinya memakai Artisan.

php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider"
php artisan migrate

Perintah pertama menyalin file konfigurasi package ke proyekmu sehingga bisa disesuaikan, sedangkan yang kedua membuat tabel roles, permissions, dan tabel pivotnya di database. Pola dua langkah ini, install lalu publish, berlaku untuk hampir semua package Laravel.

Langkah ketiga, pasang trait-nya ke model User agar bisa memakai fitur role.

// app/Models/User.php
namespace App\Models;

use Spatie\Permission\Traits\HasRoles;
use Illuminate\Foundation\Auth\User as Authenticatable;

class User extends Authenticatable
{
    use HasRoles;

    // ... kode model lainnya
}

Sekarang kamu bisa menulis kode seperti $user->assignRole('admin') atau memeriksa dengan $user->hasRole('admin') di mana saja. Satu perintah Composer tadi telah memberimu sistem manajemen hak akses yang butuh berminggu-minggu bila ditulis dari nol. Inilah alasan kenapa ekosistem package PHP begitu powerful.

Kesalahan Umum Saat Memakai Composer

Pertama, menjalankan composer update tanpa argumen di proyek production lalu kaget ada package yang berubah perilaku. Di production, selalu pakai composer install yang membaca file lock, bukan update. Kedua, meng-commit folder vendor ke Git sehingga repository membengkak dan konflik tidak perlu terjadi. Pastikan vendor/ ada di file .gitignore, yang untungnya sudah bawaan di proyek Laravel baru.

Ketiga, lupa menjalankan composer install setelah clone proyek lalu bingung kenapa php artisan error Class not found. Keempat, konflik versi saat require package lama ke Laravel baru. Baca pesan error Composer baik-baik karena ia biasanya menjelaskan package mana yang meminta versi PHP atau Laravel yang berbeda, lalu cari versi package yang mendukung versimu.

Kelima, memakai perintah Composer dengan user root di Linux tanpa flag yang tepat sehingga file vendor terkunci permission-nya. Di Windows masalah ini jarang terjadi, tetapi di VPS atau WSL, jalankan Composer sebagai user biasa, bukan root.

Keenam, menjalankan perintah Composer di folder yang salah sehingga muncul error bahwa file composer.json tidak ditemukan. Selalu pastikan terminalmu berada di root proyek Laravel, yaitu folder yang berisi file composer.json dan artisan, sebelum menjalankan perintah apa pun.

Langkah Selanjutnya

Kamu sekarang bisa menginstal Composer, memakai empat perintah intinya dengan tepat, memahami peran composer.json dan composer.lock, serta memasang package nyata sampai bisa dipakai di kode. Ini adalah fondasi workflow PHP modern yang dipakai di setiap proyek profesional.

Satu kebiasaan yang layak dibangun mulai sekarang adalah mengeksplorasi Packagist, direktori resmi tempat semua package PHP terdaftar. Sebelum menulis kode sendiri untuk kebutuhan umum seperti manipulasi tanggal, ekspor Excel, atau kirim email, cari dulu di Packagist, siapa tahu sudah ada package matang yang terawat. Untuk menjaga proyek tetap sehat, jalankan composer outdated sesekali guna melihat package mana yang punya versi baru, lalu perbarui satu per satu sambil membaca changelog-nya. Kebiasaan kecil ini menghindarkanmu dari package kedaluwarsa yang diam-diam menyimpan celah keamanan.

Package yang baru saja dipasang paling terasa manfaatnya saat dipadukan dengan sistem autentikasi. Lanjutkan ke Tutorial Laravel 12: Membuat Fitur Login dan Register dengan Breeze untuk melengkapi proyekmu dengan login yang aman. Dan bila kamu ingin mengulang dasar membangun aplikasi dari nol sebelum menambah package, Tutorial Laravel 12: Membuat CRUD Sederhana dari Nol untuk Pemula adalah tempat latihan yang tepat.

Di akhir artikel ini kamu akan bisa membuat dua komponen paling umum di web modern: deretan kartu produk yang rapi dan navbar responsif yang menyesuaikan layar HP. Semua contoh memakai CSS murni tanpa framework, supaya kamu benar-benar paham cara kerja di balik layarnya sebelum memakai bantuan seperti Bootstrap atau Tailwind.

CSS Flexbox dan Grid: Dua Senjata Layout Modern

Sebelum praktik, pahami dulu perbedaan filosofi keduanya lewat analogi sederhana. Flexbox itu seperti mengatur antrean: elemen disusun dalam satu baris atau satu kolom, dan kamu mengatur jarak serta perataannya di sepanjang jalur itu. Grid itu seperti mengatur ubin lantai: kamu membagi area menjadi baris dan kolom, lalu menempatkan elemen ke petak-petak yang tersedia.

Aturan praktisnya: pakai Flexbox untuk komponen satu dimensi seperti navbar, deretan tombol, atau kartu yang sejajar horizontal. Pakai Grid untuk layout dua dimensi seperti galeri foto, dashboard, atau keseluruhan kerangka halaman. Keduanya bisa digabung: Grid untuk kerangka besar halaman, Flexbox untuk mengatur isi di dalam setiap petaknya.

Kedua teknologi ini didukung penuh semua browser modern, jadi kamu tidak perlu khawatir soal kompatibilitas untuk proyek baru. Mari mulai dari Flexbox.

Flexbox: Mengatur Layout Satu Dimensi

Flexbox bekerja dengan dua peran: flex container (wadah) dan flex item (isi di dalamnya). Kamu mengubah sebuah elemen menjadi flex container cukup dengan satu baris: display: flex. Seketika itu juga semua anak langsungnya menjadi flex item yang tersusun horizontal dari kiri ke kanan.

<div class="container">
  <div class="kotak">1</div>
  <div class="kotak">2</div>
  <div class="kotak">3</div>
</div>

.container {
  display: flex;
  gap: 12px; /* jarak antar item */
}

.kotak {
  width: 80px;
  height: 80px;
  background-color: orange;
  color: white;
  display: flex;
  align-items: center;
  justify-content: center;
  font-size: 24px;
  border-radius: 8px;
}

Properti gap memberi jarak seragam antar item tanpa margin manual yang merepotkan. Perhatikan juga trik di class .kotak: ia sendiri menjadi flex container kecil agar angka di dalamnya rata tengah sempurna, teknik yang sangat sering dipakai untuk membuat tombol, badge, dan avatar.

Properti Penting Flexbox yang Wajib Hafal

Kekuatan Flexbox ada pada properti-propertinya. Berikut empat yang paling sering dipakai, semuanya ditulis di flex container.

justify-content mengatur perataan item sepanjang sumbu utama (horizontal bila arah default). Nilainya antara lain flex-start (rapat kiri), center (tengah), flex-end (rapat kanan), space-between (ujung ke ujung dengan jarak merata), dan space-around.

align-items mengatur perataan sepanjang sumbu silang (vertikal bila arah default). Nilai populernya stretch (default, item melar setinggi container), center, flex-start, dan flex-end. Kombinasi justify-content: center dan align-items: center adalah cara termudah membuat konten tepat di tengah layar.

flex-direction mengubah arah susunan. Nilai defaultnya row (horizontal kiri ke kanan). Ubah menjadi column untuk susunan vertikal ke bawah, yang sering dipakai untuk layout mobile atau tumpukan form.

flex-wrap menentukan apa yang terjadi bila item tidak muat satu baris. Nilai default nowrap memaksa semua item berdesakan, sedangkan wrap memindahkan kelebihan item ke baris baru dengan rapi.

.navbar {
  display: flex;
  justify-content: space-between; /* logo kiri, menu kanan */
  align-items: center;             /* sejajar vertikal */
  padding: 16px 24px;
}

.formulir {
  display: flex;
  flex-direction: column; /* input tersusun ke bawah */
  gap: 12px;
  max-width: 400px;
}

Contoh .navbar di atas adalah pola paling klasik di web: logo di kiri dan menu di kanan hanya dengan satu baris justify-content: space-between. Hafalkan pola ini karena kamu akan menuliskannya berkali-kali.

CSS Grid: Mengatur Layout Dua Dimensi

Kalau Flexbox mengatur antrean, Grid mengatur petak. Kamu mengubah elemen menjadi grid container dengan display: grid, lalu mendefinisikan kolomnya dengan grid-template-columns. Fungsi repeat() mempermudah penulisan kolom yang berulang.

<div class="galeri">
  <div class="foto">1</div>
  <div class="foto">2</div>
  <div class="foto">3</div>
  <div class="foto">4</div>
  <div class="foto">5</div>
  <div class="foto">6</div>
</div>

.galeri {
  display: grid;
  grid-template-columns: repeat(3, 1fr); /* 3 kolom sama lebar */
  gap: 16px;
}

.foto {
  background-color: #1a3a6e;
  color: white;
  height: 120px;
  display: flex;
  align-items: center;
  justify-content: center;
  font-size: 24px;
  border-radius: 8px;
}

Satuan 1fr artinya satu fraksi dari ruang yang tersedia, sehingga tiga kolom 1fr selalu sama lebar mengikuti lebar container. Ini jauh lebih elegan dibanding menghitung persen manual. Properti gap di Grid memberi jarak antar baris sekaligus antar kolom dalam satu deklarasi.

Untuk membuat item melintasi beberapa kolom, pakai grid-column: span 2 pada itemnya. Teknik ini berguna untuk membuat kartu unggulan yang lebih lebar dari kartu biasa.

.foto-unggulan {
  grid-column: span 2; /* selebar 2 kolom */
}

Fungsi minmax() membuat grid responsif tanpa media query: grid-template-columns: repeat(auto-fill, minmax(200px, 1fr)) otomatis mengatur jumlah kolom mengikuti lebar layar, dengan tiap kolom minimal 200 piksel. Satu baris ini menggantikan banyak kode responsif manual.

Studi Kasus: Layout Kartu Produk Responsif

Sekarang gabungkan pengetahuanmu menjadi komponen nyata: deretan kartu produk untuk toko online. Setiap kartu berisi gambar, nama produk, harga, dan tombol beli. Kita pakai Grid untuk deretannya dan Flexbox untuk isi tiap kartu.

<div class="daftar-produk">
  <div class="kartu">
    <div class="gambar-produk">Gambar</div>
    <h3>Kopi Arabika 200g</h3>
    <p class="harga">Rp45.000</p>
    <button>Beli</button>
  </div>
  <!-- duplikasi .kartu untuk produk lain -->
</div>

.daftar-produk {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(220px, 1fr));
  gap: 20px;
  padding: 20px;
}

.kartu {
  border: 1px solid #ddd;
  border-radius: 12px;
  padding: 16px;
  display: flex;              /* Flexbox di dalam kartu */
  flex-direction: column;     /* isi tersusun ke bawah */
  gap: 8px;
}

.gambar-produk {
  background-color: #f0f0f0;
  height: 140px;
  border-radius: 8px;
  display: flex;
  align-items: center;
  justify-content: center;
  color: #999;
}

.kartu .harga {
  font-weight: bold;
  color: #e67e22;
  font-size: 18px;
}

.kartu button {
  margin-top: auto; /* dorong tombol ke bawah kartu */
  padding: 10px;
  border: none;
  border-radius: 8px;
  background-color: #1a3a6e;
  color: white;
  cursor: pointer;
}

Perhatikan trik margin-top: auto pada tombol: ia mendorong tombol ke dasar kartu sehingga semua tombol sejajar walau deskripsi produk berbeda panjang. Ini contoh sempurna kolaborasi Grid di luar dan Flexbox di dalam. Coba ubah lebar browser dan saksikan jumlah kolom menyesuaikan otomatis tanpa satu pun media query.

Studi Kasus: Navbar Responsif dengan Flexbox

Navbar adalah komponen wajib hampir setiap website. Kita buat navbar dengan logo di kiri dan menu di kanan untuk layar besar, yang berubah menjadi tumpukan vertikal di layar kecil memakai satu media query.

<nav class="navbar">
  <div class="logo">TokoKu</div>
  <ul class="menu">
    <li><a href="#">Beranda</a></li>
    <li><a href="#">Produk</a></li>
    <li><a href="#">Tentang</a></li>
    <li><a href="#">Kontak</a></li>
  </ul>
</nav>

.navbar {
  display: flex;
  justify-content: space-between;
  align-items: center;
  background-color: #1a3a6e;
  padding: 16px 24px;
}

.logo {
  color: white;
  font-weight: bold;
  font-size: 20px;
}

.menu {
  display: flex;
  gap: 20px;
  list-style: none;
  margin: 0;
  padding: 0;
}

.menu a {
  color: white;
  text-decoration: none;
}

/* Layar kecil: ubah jadi vertikal */
@media (max-width: 600px) {
  .navbar {
    flex-direction: column;
    align-items: flex-start;
    gap: 12px;
  }

  .menu {
    flex-direction: column;
    gap: 8px;
  }
}

Kuncinya hanya dua baris di media query: flex-direction: column pada navbar dan menu. Sisanya mengikuti otomatis. Pola ini jauh lebih ringkas dibanding teknik float zaman dulu yang butuh clearfix dan perhitungan lebar manual.

CSS Flexbox dan Grid: Kapan Memakai yang Mana

Bingung memilih di antara keduanya adalah hal wajar. Pakai panduan cepat ini. Pilih Flexbox ketika kamu mengatur elemen dalam satu arah: navbar, deretan tombol aksi, form vertikal, atau konten yang rata tengah. Pilih Grid ketika kamu butuh kendali dua dimensi: galeri, dashboard, pricing table, atau kerangka halaman dengan header, sidebar, dan konten.

Bila ragu, tanyakan pada dirimu: apakah aku menyusun dalam satu arah saja? Bila ya, Flexbox jawabannya. Apakah aku butuh baris DAN kolom sekaligus? Bila ya, Grid jawabannya. Dalam praktiknya kamu akan sering memakai keduanya bersamaan seperti pada studi kasus kartu produk di atas, dan itu justru praktik yang dianjurkan.

Satu catatan: jangan memakai Grid untuk hal sepele satu dimensi seperti meratakan satu tombol ke kanan, dan jangan memaksa Flexbox untuk layout tabel kompleks. Memakai alat yang tepat membuat kode lebih pendek dan mudah dirawat.

Kesalahan Umum Saat Belajar Flexbox dan Grid

Pertama, lupa mengatur display: flex atau display: grid pada container tetapi properti seperti justify-content ditulis di item. Properti layout selalu ditulis di container, bukan di itemnya. Kedua, mengira align-items dan justify-content selalu berarti vertikal dan horizontal. Keduanya mengikuti sumbu yang berubah bila flex-direction diganti ke column.

Ketiga, memakai persen untuk kolom Grid padahal fr lebih tepat karena otomatis memperhitungkan gap. Keempat, tidak mereset margin dan padding bawaan pada ul saat membuat menu navbar, sehingga muncul jarak misterius. Kelima, menumpuk terlalu banyak nesting flex container yang sebenarnya bisa diselesaikan satu level Grid. Bila kode layoutmu terasa berbelit, biasanya ada cara yang lebih sederhana.

Langkah Selanjutnya

Kamu sekarang menguasai dua sistem layout modern CSS: Flexbox untuk satu dimensi dan Grid untuk dua dimensi, lengkap dengan dua studi kasus nyata berupa kartu produk responsif dan navbar adaptif. Skill ini langsung terpakai di setiap proyek web yang kamu kerjakan.

Layout yang bagus menjadi jauh lebih hidup dengan interaktivitas. Pelajari cara membuat navbar dan tombolmu merespons klik pengguna di Tutorial JavaScript untuk Pemula: Variabel, Fungsi, dan Manipulasi DOM. Dan bila kamu ingin melihat bagaimana tampilan seperti ini dipadukan dengan data dari server, Tutorial Laravel 12: Membuat CRUD Sederhana dari Nol untuk Pemula menunjukkan sisi backend-nya memakai Blade template yang distyling dengan teknik yang baru saja kamu pelajari.

Studi kasus kita sederhana dan dekat dengan dunia nyata: satu Post bisa memiliki banyak Comment, sedangkan setiap Comment hanya milik satu Post. Pola inilah yang disebut one to many, relasi paling umum yang akan kamu temui di hampir setiap aplikasi. Setelah menguasainya, relasi lain seperti many to many akan terasa jauh lebih mudah dipahami.

Relasi Eloquent Laravel One to Many: Konsep Dasarnya

Sebelum menyentuh kode, pahami dulu anatomi relasi one to many. Di sisi database, tabel comments menyimpan kolom post_id yang menunjuk ke kolom id di tabel posts. Kolom post_id inilah yang disebut foreign key, yaitu kunci tamu yang menjadi jembatan antar tabel.

Di sisi Eloquent, relasi ini didefinisikan dari dua arah yang saling melengkapi. Dari sisi Post, relasinya dibaca sebagai “satu post memiliki banyak comment” dan ditulis dengan method hasMany. Dari sisi Comment, relasinya dibaca sebagai “satu comment milik satu post” dan ditulis dengan method belongsTo. Kedua method ini ditaruh di dalam class model masing-masing.

Konvensi penamaan Laravel sangat membantumu di sini. Bila kamu mengikuti konvensi (model Post untuk tabel posts, foreign key post_id), Eloquent bisa menebak semuanya secara otomatis tanpa konfigurasi tambahan. Kamu hanya perlu menulis method relasinya, dan sisanya ditangani framework.

Persiapan: Model dan Migrasi Post serta Comment

Kita mulai dari migrasi. Buat model beserta migrasinya dengan perintah Artisan berikut. Flag -m membuat file migrasi sekalian.

php artisan make:model Post -m
php artisan make:model Comment -m

Buka file migrasi posts dan isi dengan kolom yang dibutuhkan. Karena ini studi kasus blog sederhana, kolomnya cukup judul, isi, dan timestamps bawaan.

// database/migrations/xxxx_create_posts_table.php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration {
    public function up(): void
    {
        Schema::create('posts', function (Blueprint $table) {
            $table->id();
            $table->string('judul');
            $table->text('isi');
            $table->timestamps();
        });
    }

    public function down(): void
    {
        Schema::dropIfExists('posts');
    }
};

Selanjutnya migrasi comments. Inilah bagian pentingnya: tambahkan foreignId('post_id') yang dirantai dengan constrained() agar Laravel otomatis membuat foreign key ke tabel posts, plus onDelete('cascade') supaya komentar ikut terhapus saat post induknya dihapus.

// database/migrations/xxxx_create_comments_table.php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration {
    public function up(): void
    {
        Schema::create('comments', function (Blueprint $table) {
            $table->id();
            $table->foreignId('post_id')
                  ->constrained()
                  ->onDelete('cascade');
            $table->string('nama_komentator');
            $table->text('isi_komentar');
            $table->timestamps();
        });
    }

    public function down(): void
    {
        Schema::dropIfExists('comments');
    }
};

Method constrained() akan menebak tabel tujuan dari nama kolom: post_id berarti tabel posts kolom id. Bila penamaanmu tidak mengikuti konvensi, kamu bisa menyebutkannya eksplisit seperti constrained('posts', 'id'). Setelah kedua migrasi siap, jalankan php artisan migrate untuk membuat tabelnya di database. Pastikan konfigurasi database di file .env sudah benar, seperti yang dibahas di Belajar MySQL untuk Pemula.

Relasi Eloquent Laravel One to Many: hasMany dan belongsTo di Model

Sekarang buka model Post dan tambahkan method relasi comments. Nama method memakai bentuk jamak karena satu post punya banyak comment, dan return type-nya adalah HasMany.

// app/Models/Post.php
namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\HasMany;

class Post extends Model
{
    protected $fillable = ['judul', 'isi'];

    public function comments(): HasMany
    {
        return $this->hasMany(Comment::class);
    }
}

Lalu buka model Comment dan tambahkan method post dengan return type BelongsTo. Nama method memakai bentuk tunggal karena satu comment hanya milik satu post.

// app/Models/Comment.php
namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;

class Comment extends Model
{
    protected $fillable = ['post_id', 'nama_komentator', 'isi_komentar'];

    public function post(): BelongsTo
    {
        return $this->belongsTo(Post::class);
    }
}

Perhatikan bahwa $fillable pada Comment menyertakan post_id agar bisa diisi massal saat membuat komentar baru. Dengan dua method ini, Eloquent sekarang paham hubungan kedua tabel. Kamu bisa mengakses $post->comments untuk mendapat koleksi komentar, atau $comment->post untuk mendapat post induknya, tanpa menulis satu pun query SQL manual.

Praktik: Menyimpan dan Membaca Data Berelasi

Relasi yang sudah didefinisikan membuat kode penyimpanan data menjadi sangat ekspresif. Untuk membuat comment yang otomatis terhubung ke post tertentu, cukup panggil relasinya lalu method create.

use App\Models\Post;

$post = Post::find(1);

// Membuat comment yang otomatis terisi post_id = 1
$post->comments()->create([
    'nama_komentator' => 'Ani',
    'isi_komentar' => 'Artikelnya sangat membantu, terima kasih!',
]);

Bentuk $post->comments() dengan tanda kurung mengembalikan query builder relasi sehingga kamu bisa merantainya dengan create, where, atau count. Sedangkan $post->comments tanpa tanda kurung langsung mengeksekusi dan mengembalikan koleksi hasil. Perbedaan kecil ini penting dan sering membingungkan pemula, jadi hafalkan polanya.

Untuk membaca, kamu bisa mengakses relasi dari kedua arah dengan natural.

// Dari post ke comments-nya
$post = Post::find(1);
foreach ($post->comments as $comment) {
    echo $comment->nama_komentator . ': ' . $comment->isi_komentar . "\n";
}

// Dari comment ke post induknya
$comment = Comment::find(5);
echo $comment->post->judul;

Tampilkan di Blade juga semudah itu. Contoh menampilkan daftar post beserta komentarnya:

@foreach ($posts as $post)
  <h2>{{ $post->judul }}</h2>
  <p>{{ $post->isi }}</p>

  <h4>Komentar ({{ $post->comments->count() }})</h4>
  <ul>
    @foreach ($post->comments as $comment)
      <li><strong>{{ $comment->nama_komentator }}:</strong> {{ $comment->isi_komentar }}</li>
    @endforeach
  </ul>
@endforeach

Waspadai Masalah N+1 dan Atasi dengan Eager Loading

Ada satu jebakan performa yang wajib kamu pahami sejak awal: masalah N+1 query. Perhatikan kode controller berikut yang terlihat wajar tetapi bermasalah.

// CARA LAMBAT: memicu N+1 query
$posts = Post::all(); // 1 query untuk mengambil semua post

foreach ($posts as $post) {
    echo $post->comments->count(); // +1 query untuk SETIAP post!
}

Bila ada 50 post, kode ini menjalankan 1 query untuk posts ditambah 50 query untuk comments, total 51 query. Inilah N+1: satu query awal plus N query tambahan. Pada data kecil tidak terasa, tetapi di production dengan ribuan baris, halamanmu bisa menjadi sangat lambat.

Solusinya adalah eager loading dengan method with(), yang memuat relasi sekaligus dalam query tambahan yang efisien.

// CARA CEPAT: hanya 2 query untuk semua data
$posts = Post::with('comments')->get(); // 1 query posts + 1 query comments

foreach ($posts as $post) {
    echo $post->comments->count(); // tidak ada query baru, data sudah dimuat
}

Eloquent akan menjalankan satu query untuk semua comments yang post_id-nya cocok, lalu mencocokkannya di memori. Hasilnya selalu hanya 2 query berapa pun jumlah post-nya. Aturan praktisnya: setiap kali kamu mengakses relasi di dalam loop, pastikan relasi itu dimuat dengan with() di awal. Kamu juga bisa memuat relasi bertingkat seperti with('comments.user') bila comment berelasi lagi ke tabel users.

Relasi di Route dan Controller: Contoh Lengkap

Mari rangkai semuanya dalam contoh controller nyata yang menampilkan satu post beserta komentarnya, plus form tambah komentar. Pertama daftarkan route-nya.

// routes/web.php
use App\Http\Controllers\PostController;

Route::get('/posts/{post}', [PostController::class, 'show'])->name('posts.show');
Route::post('/posts/{post}/comments', [PostController::class, 'storeComment'])
    ->name('posts.comments.store');

Lalu buat controllernya. Perhatikan penggunaan with('comments') untuk eager loading dan validasi input sebelum menyimpan.

// app/Http/Controllers/PostController.php
namespace App\Http\Controllers;

use App\Models\Post;
use Illuminate\Http\Request;

class PostController extends Controller
{
    public function show(Post $post)
    {
        // Muat ulang post beserta comments-nya secara eager
        $post->load('comments');

        return view('posts.show', compact('post'));
    }

    public function storeComment(Request $request, Post $post)
    {
        $validated = $request->validate([
            'nama_komentator' => 'required|max:100',
            'isi_komentar' => 'required|max:1000',
        ]);

        $post->comments()->create($validated);

        return redirect()->route('posts.show', $post)
            ->with('sukses', 'Komentar berhasil ditambahkan.');
    }
}

Teknik Route::get('/posts/{post}') yang dipasangkan dengan parameter Post $post disebut route model binding: Laravel otomatis mengambilkan model Post berdasarkan ID di URL. Ini menghemat kode pencarian manual dan sudah mengikuti praktik terbaik Laravel 12.

Kesalahan Umum Saat Membuat Relasi Eloquent

Beberapa error klasik yang sering ditemui pemula beserta penyebabnya. Pertama, error Class not found pada relasi biasanya karena lupa mengimpor class model terkait dengan use App\Models\Comment; di atas file. Kedua, foreign key tidak terbentuk karena urutan migrasi salah: migrasi posts harus berjalan sebelum comments, jadi perhatikan timestamp pada nama file migrasi.

Ketiga, mass assignment error saat create biasanya karena post_id belum masuk ke $fillable pada model Comment. Keempat, relasi mengembalikan null atau koleksi kosong padahal data ada di database. Cek apakah nama method relasi, nama foreign key, dan konvensi tabel semuanya konsisten. Bila memakai nama tabel atau kolom yang tidak standar, sebutkan eksplisit di parameter hasMany dan belongsTo, misalnya $this->hasMany(Comment::class, 'tulisan_id').

Langkah Selanjutnya

Kamu sekarang bisa memodelkan relasi one to many dengan benar: migrasi foreign key lewat foreignId dan constrained(), method hasMany dan belongsTo di model, sampai teknik eager loading untuk menghindari N+1 query. Ini adalah skill database yang dipakai di hampir setiap proyek Laravel profesional.

Relasi ini juga menjadi fondasi untuk topik lanjutan seperti many to many dengan tabel pivot, polymorphic relations, dan API Resources yang menyajikan data berelasi sebagai JSON. Untuk melihat bagaimana data berelasi disajikan ke aplikasi lain, lanjutkan ke Cara Membuat REST API dengan Laravel: Panduan Lengkap untuk Pemula. Dan bila kamu ingin mengulang dasar pengelolaan data tunggal sebelum melangkah lebih jauh, Tutorial Laravel 12: Membuat CRUD Sederhana dari Nol untuk Pemula selalu siap menjadi tempatmu berlatih lagi.

XAMPP adalah paket gratis berisi Apache (web server), MySQL atau MariaDB (database), PHP, dan Perl dalam satu instalasi. Tanpa XAMPP, file PHP yang kamu tulis tidak bisa dijalankan karena browser hanya memahami HTML, CSS, dan JavaScript. Dengan XAMPP, komputermu berubah menjadi server web mini tempat kamu bereksperimen sebebasnya tanpa biaya hosting.

Cara Install XAMPP: Persiapan Sebelum Mulai

Sebelum mengunduh, pastikan komputermu memenuhi syarat yang ringan ini. XAMPP berjalan baik di Windows 10 atau 11 dengan RAM minimal 4 GB dan ruang disk kosong sekitar 2 GB. Kamu juga butuh hak akses administrator saat instalasi karena XAMPP perlu mendaftarkan service dan membuka port jaringan lokal.

Satu catatan penting untuk pengguna Windows: nonaktifkan dulu antivirus yang terlalu agresif atau tambahkan folder instalasi ke daftar pengecualian bila instalasi gagal di tengah jalan. Beberapa antivirus salah mendeteksi komponen XAMPP sebagai ancaman. Selain itu, pastikan tidak ada aplikasi lain yang sedang memakai port 80, seperti Skype versi lama atau IIS, karena ini penyebab paling umum Apache gagal start. Kita bahas solusinya di bagian troubleshooting.

Langkah 1: Download XAMPP dari Situs Resmi

Selalu unduh XAMPP dari situs resminya di apachefriends.org. Jangan mengunduh dari situs pihak ketiga karena berisiko disisipi malware. Di halaman utama situs tersebut, pilih versi untuk Windows, lalu unduh installer versi PHP terbaru yang tersedia. Ukuran file installer biasanya sekitar 150 sampai 160 MB, jadi pastikan koneksi internetmu stabil.

Pilih versi PHP terbaru yang ditawarkan karena tutorial ini memakai sintaks PHP 8 yang modern. Versi lama seperti PHP 7 masih bisa dipakai, tetapi beberapa fitur baru tidak akan tersedia. Setelah file installer selesai diunduh, jangan buru-buru menjalankannya bila kamu memakai Windows dengan User Account Control yang ketat. Klik kanan file installer lalu pilih Run as administrator agar proses instalasi berjalan lancar.

Cara Install XAMPP di Windows: Menjalankan Installer

Jalankan installer dan ikuti wizard yang muncul. Pada layar pemilihan komponen, biarkan semua komponen tercentang bila ruang diskmu cukup, atau minimal pastikan Apache, MySQL, PHP, dan phpMyAdmin terpilih. Keempat komponen inilah yang akan paling sering kamu pakai.

Selanjutnya installer menanyakan folder tujuan. Lokasi defaultnya adalah C:\xampp dan sangat disarankan untuk tidak mengubahnya. Banyak tutorial dan konfigurasi mengasumsikan XAMPP ada di lokasi ini, sehingga mengubahnya hanya menambah potensi masalah. Hindari juga menginstal di dalam C:\Program Files karena izin foldernya lebih ketat dan sering menimbulkan error permission.

Klik Next sampai instalasi selesai. Prosesnya memakan waktu beberapa menit tergantung kecepatan disk. Bila Windows Firewall menampilkan peringatan dan meminta izin akses jaringan untuk Apache atau MySQL, pilih Allow access agar keduanya bisa berjalan normal.

Langkah 3: Menyalakan Apache dan MySQL Lewat Control Panel

Setelah instalasi selesai, buka XAMPP Control Panel dari Start Menu. Jendela ini adalah pusat kendalimu: setiap service punya tombol Start dan Stop masing-masing. Untuk mulai ngoding PHP, kamu cukup menyalakan dua service: Apache dan MySQL.

Klik tombol Start pada baris Apache. Bila berhasil, latar barisnya berubah hijau dan tertulis Running beserta nomor PID dan port (biasanya 80 dan 443). Lakukan hal yang sama untuk MySQL yang biasanya berjalan di port 3306. Bila salah satunya gagal start dan barisnya berwarna merah, jangan panik dulu dan langsung lompat ke bagian troubleshooting di akhir artikel.

Untuk memastikan Apache benar-benar hidup, buka browser dan ketik http://localhost di address bar. Bila muncul halaman selamat datang XAMPP, berarti web server lokalmu sudah berjalan sempurna. Alamat localhost ini setara dengan 127.0.0.1, yaitu alamat yang menunjuk ke komputermu sendiri.

Selagi MySQL berjalan, kamu juga bisa membuka http://localhost/phpmyadmin di browser untuk melihat phpMyAdmin, yaitu aplikasi web bawaan XAMPP untuk mengelola database lewat tampilan grafis. Kamu belum perlu memakainya sekarang, tetapi ketahui saja bahwa ia ada dan siap dipakai saat kamu mulai belajar database di artikel berikutnya.

Mengenal Folder htdocs: Tempat Menyimpan Proyekmu

Semua file web yang ingin dijalankan lewat XAMPP harus disimpan di dalam folder htdocs, yang berlokasi di C:\xampp\htdocs. Anggap folder ini sebagai root atau halaman depan dari server lokalmu. Setiap subfolder di dalamnya otomatis menjadi alamat web tersendiri.

Contohnya, bila kamu membuat folder C:\xampp\htdocs\belajar, maka isinya bisa diakses lewat http://localhost/belajar di browser. File bernama index.php di dalam folder itu akan terbuka otomatis saat kamu mengunjungi alamat foldernya, sama seperti perilaku hosting sungguhan. Pola inilah yang dipakai semua developer PHP di seluruh dunia untuk pengembangan lokal.

Satu aturan emas: jangan pernah menyimpan file PHP di folder lain seperti Documents lalu membukanya langsung dengan double click. File yang dibuka langsung tanpa lewat http://localhost tidak diproses oleh PHP, sehingga kode PHP-mu hanya tampil sebagai teks mentah atau tidak berjalan sama sekali.

Program PHP Pertama: Menampilkan phpinfo dan Halo Dunia

Sekarang saatnya menulis kode PHP pertama. Buka Notepad atau VS Code, lalu buat file bernama info.php di dalam C:\xampp\htdocs dengan isi berikut.

<?php
phpinfo();
?>

Simpan, lalu buka http://localhost/info.php di browser. Bila muncul halaman panjang berisi informasi konfigurasi PHP, selamat, PHP-mu bekerja. Fungsi phpinfo() ini sangat berguna untuk memeriksa versi PHP dan ekstensi yang aktif. Setelah yakin berhasil, hapus file info.php karena membiarkannya di server production bisa membocorkan informasi sistem.

Selanjutnya buat program legendaris setiap pemula: halo dunia. Buat file halo.php di folder htdocs dengan isi berikut.

<?php
$nama = "Budi";
$umur = 20;
?>
<!DOCTYPE html>
<html lang="id">
<head>
  <meta charset="UTF-8">
  <title>Halo Dunia</title>
</head>
<body>
  <h1>Halo dunia!</h1>
  <p>Nama saya <?php echo $nama; ?>, umur saya <?php echo $umur; ?> tahun.</p>
  <p>Hari ini: <?php echo date("l, d F Y"); ?></p>
</body>
</html>

Buka http://localhost/halo.php dan perhatikan hasilnya. Kode di antara <?php dan ?> dieksekusi di server, sedangkan sisanya dikirim apa adanya sebagai HTML. Fungsi date() menampilkan tanggal server sesuai format yang diminta. Pola mencampur PHP dan HTML seperti inilah dasar dari semua aplikasi PHP, termasuk yang dibangun dengan framework modern.

Membuat Form GET Sederhana dan Memproses Datanya

Program statis memang menyenangkan di awal, tetapi kekuatan PHP sesungguhnya adalah memproses data dari pengguna. Contoh paling sederhana adalah form yang mengirim data lewat method GET. Buat file sapa.php di folder htdocs dengan isi berikut.

<!DOCTYPE html>
<html lang="id">
<head>
  <meta charset="UTF-8">
  <title>Form Sapa</title>
</head>
<body>
  <h1>Form Sapaan</h1>
  <form method="GET" action="sapa.php">
    <label>Nama kamu: <input type="text" name="nama" required></label>
    <button type="submit">Kirim</button>
  </form>

  <?php if (isset($_GET["nama"])): ?>
    <p>
      Halo, <?php echo htmlspecialchars($_GET["nama"]); ?>!
      Senang bertemu denganmu.
    </p>
  <?php endif; ?>
</body>
</html>

Cara kerjanya begini. Saat form disubmit, browser mengirim data ke URL yang sama dengan parameter di address bar, misalnya sapa.php?nama=Ani. PHP menangkapnya lewat array superglobal $_GET. Fungsi isset() memeriksa apakah parameternya ada sebelum dipakai, supaya tidak muncul warning saat halaman pertama kali dibuka. Fungsi htmlspecialchars() wajib dipakai setiap menampilkan input pengguna untuk mencegah serangan XSS, yaitu kode jahat yang disisipkan lewat form.

Coba isi form dengan namamu lalu perhatikan address bar berubah. Itulah karakteristik method GET: datanya terlihat di URL. Untuk data sensitif seperti password, method POST lebih tepat karena datanya tidak tampil di URL. Prinsip memproses input form inilah yang nantinya berkembang menjadi fitur login, pendaftaran, dan CRUD lengkap.

Masalah Umum Saat Install XAMPP dan Cara Mengatasinya

Hampir setiap pemula menabrak minimal satu masalah berikut. Tenang, semuanya ada solusinya.

Apache tidak bisa start, port 80 sudah dipakai. Ini masalah nomor satu. Penyebab umum adalah Skype, IIS, atau aplikasi lain yang menduduki port 80. Solusi termudah: tutup aplikasi penyebabnya. Alternatifnya, ubah port Apache menjadi 8080 lewat tombol Config lalu Apache (httpd.conf), cari baris Listen 80 dan ubah menjadi Listen 8080, kemudian akses situsmu lewat http://localhost:8080.

MySQL tidak bisa start. Biasanya karena sudah ada instalasi MySQL lain yang berjalan sebagai service Windows. Buka Services, cari service MySQL yang bukan milik XAMPP, lalu hentikan atau ubah menjadi manual. Setelah itu start ulang MySQL dari XAMPP Control Panel.

Akses ditolak atau error permission. Terjadi bila XAMPP diinstal tanpa Run as administrator atau ditaruh di folder dengan izin ketat. Solusinya: jalankan XAMPP Control Panel sebagai administrator dengan klik kanan lalu Run as administrator.

Halaman localhost tidak tampil. Pastikan Apache berstatus Running berwarna hijau di Control Panel, lalu coba http://127.0.0.1 sebagai alternatif http://localhost. Bila tetap gagal, restart Apache dari Control Panel.

Langkah Selanjutnya Setelah XAMPP Berjalan

Kamu sekarang punya lingkungan pengembangan PHP yang lengkap: Apache melayani halaman, MySQL siap menyimpan data, dan kamu sudah bisa menulis serta memproses program PHP. Ini fondasi yang sama dipakai developer profesional sebelum mengerjakan proyek sungguhan.

Langkah berikutnya yang paling masuk akal adalah berkenalan dengan database MySQL karena hampir semua aplikasi web menyimpannya di sana. Baca panduan Belajar MySQL untuk Pemula: Membuat Database, Tabel, dan Query Dasar untuk melanjutkan dari titik ini. Setelah nyaman dengan database, saatnya naik kelas ke framework: Tutorial Laravel 12: Membuat CRUD Sederhana dari Nol untuk Pemula memakai XAMPP sebagai server lokalnya dan akan terasa jauh lebih mudah karena kamu sudah paham cara kerja di balik layarnya.

Kabar baiknya, kamu tidak perlu menginstal apa pun untuk mulai belajar. Cukup buka browser Chrome atau Edge, tekan F12 untuk membuka DevTools, lalu pilih tab Console. Di sanalah kamu bisa mengetik dan menjalankan kode JavaScript secara langsung. Untuk latihan yang lebih serius, kamu bisa memakai VS Code sebagai editor kode. Kalau belum memasangnya, baca dulu panduan 7 Ekstensi VS Code Wajib untuk Mahasiswa dan Programmer Pemula agar pengalaman ngodingmu lebih nyaman sejak awal.

Tutorial JavaScript Pemula: Persiapan dan Cara Menjalankan Kode

Sebelum menulis baris pertama, pahami dulu di mana kode JavaScript dijalankan. Ada dua tempat utama. Pertama, di browser melalui tab Console DevTools seperti yang sudah disebutkan. Cara ini paling cepat untuk bereksperimen dengan potongan kode kecil. Kedua, di dalam file HTML memakai tag script, yang akan kita pakai pada studi kasus di bagian akhir artikel ini.

Aturan mainnya sederhana. Setiap contoh kode pada artikel ini memakai sintaks modern JavaScript (ES6 ke atas) yang didukung semua browser terbaru. Kamu disarankan mengetik ulang setiap contoh, bukan sekadar menyalinnya, karena otot jarimu perlu terbiasa dengan sintaksnya. Kalau muncul error berwarna merah di Console, jangan panik. Baca pesannya baik-baik karena pesan error JavaScript biasanya cukup jelas menunjukkan baris yang bermasalah.

Satu kebiasaan penting sejak awal: biasakan memberi nama variabel dan fungsi yang deskriptif dalam bahasa Inggris, misalnya namaMahasiswa atau hitungTotal, bukan x atau data1. Kode yang kamu tulis hari ini akan kamu baca lagi minggu depan, dan nama yang jelas menghemat banyak waktu.

Mengenal Variabel: let, const, dan var

Variabel adalah wadah untuk menyimpan data. Di JavaScript modern ada dua kata kunci utama untuk membuat variabel, yaitu let dan const. Kamu mungkin juga menemukan var di kode-kode lama, tetapi untuk proyek baru sebaiknya hindari var karena perilakunya yang membingungkan terkait cakupan variabel.

Gunakan const untuk nilai yang tidak akan berubah setelah dibuat, dan let untuk nilai yang memang perlu diubah. Aturan praktisnya: selalu mulai dengan const, ganti ke let hanya bila kamu benar-benar perlu mengubah nilainya.

const namaKampus = "STT Payakumbuh";
let semester = 3;

console.log(namaKampus); // STT Payakumbuh
console.log(semester);   // 3

semester = 4; // boleh, karena memakai let
console.log(semester); // 4

// namaKampus = "Kampus Lain"; // ERROR: tidak boleh mengubah const

Perhatikan bahwa mengubah isi dari const yang berupa object atau array masih diperbolehkan, yang dilarang adalah mengganti seluruh referensinya. Ini konsep yang akan terasa manfaatnya saat kamu bekerja dengan data yang kompleks.

const mahasiswa = { nama: "Budi", ipk: 3.5 };
mahasiswa.ipk = 3.7; // boleh: mengubah isi properti
console.log(mahasiswa.ipk); // 3.7

Tipe Data Dasar yang Wajib Dikuasai

JavaScript punya beberapa tipe data dasar. Lima yang paling sering dipakai pemula adalah string (teks), number (angka), boolean (benar atau salah), null (kosong yang disengaja), dan undefined (belum diberi nilai). Kamu bisa memeriksa tipe sebuah nilai dengan operator typeof.

const nama = "Ani";          // string
const umur = 20;             // number
const lulus = true;          // boolean
let nilai = null;            // null
let alamat;                  // undefined

console.log(typeof nama);  // "string"
console.log(typeof umur);  // "number"
console.log(typeof lulus); // "boolean"

Satu hal unik JavaScript adalah ia tidak membedakan integer dan desimal, semuanya bertipe number. Operasi aritmetika dasar memakai simbol yang sudah familier: tambah (+), kurang (-), kali (*), bagi (/), dan sisa bagi (%).

const a = 10;
const b = 3;
console.log(a + b); // 13
console.log(a % b); // 1 (sisa pembagian 10 oleh 3)

Hati-hati dengan operator + pada string karena ia berfungsi sebagai penggabung teks, bukan penjumlahan. Untuk menggabungkan variabel ke dalam kalimat, cara modernnya memakai template literal dengan backtick dan ${}.

const namaDepan = "Dewi";
const kota = "Padang";
console.log(`Halo, saya ${namaDepan} dari ${kota}.`);
// Halo, saya Dewi dari Padang.

Fungsi: Blok Kode yang Bisa Dipakai Ulang

Fungsi adalah blok kode yang diberi nama dan bisa dipanggil berkali-kali. Tanpa fungsi, kamu akan menulis kode yang sama berulang-ulang. Ada dua cara penulisan yang umum: deklarasi fungsi biasa dan arrow function yang lebih ringkas.

// Deklarasi fungsi biasa
function sapa(nama) {
  return `Halo, ${nama}! Selamat belajar JavaScript.`;
}

console.log(sapa("Rina")); // Halo, Rina! Selamat belajar JavaScript.

// Arrow function (sintaks ES6)
const kuadrat = (angka) => {
  return angka * angka;
};

console.log(kuadrat(5)); // 25

// Arrow function satu baris bisa lebih ringkas lagi
const tambah = (x, y) => x + y;
console.log(tambah(4, 7)); // 11

Fungsi bisa menerima parameter (masukan) dan mengembalikan nilai lewat return. Parameter membuat fungsi menjadi fleksibel karena perilakunya bisa berubah tergantung argumen yang diberikan saat dipanggil. Biasakan memberi nilai default pada parameter bila masuk akal, supaya fungsi tetap berjalan walau pemanggil lupa memberi argumen.

function hitungDiskon(harga, persenDiskon = 10) {
  const potongan = harga * (persenDiskon / 100);
  return harga - potongan;
}

console.log(hitungDiskon(100000));     // 90000 (pakai default 10%)
console.log(hitungDiskon(100000, 25)); // 75000

Array dan Object: Menyimpan Banyak Data Sekaligus

Variabel biasa hanya menyimpan satu nilai. Untuk menyimpan banyak nilai, JavaScript menyediakan array (daftar berurutan) dan object (kumpulan pasangan kunci dan nilai).

Array memakai kurung siku dan indeksnya dimulai dari nol. Beberapa method array yang wajib hafal adalah push untuk menambah data, length untuk menghitung isi, dan forEach atau map untuk memproses setiap elemen.

const daftarBuah = ["apel", "mangga", "pisang"];

console.log(daftarBuah[0]);      // "apel" (indeks mulai dari 0)
console.log(daftarBuah.length);  // 3

daftarBuah.push("anggur");       // tambah di akhir
console.log(daftarBuah.length);  // 4

// forEach: menjalankan fungsi untuk tiap elemen
daftarBuah.forEach((buah) => {
  console.log(`Saya suka ${buah}`);
});

Object memakai kurung kurawal dan menyimpan data sebagai pasangan kunci: nilai. Ini struktur yang paling sering kamu temui saat berurusan dengan data dari API atau database.

const mahasiswa = {
  nama: "Fajar",
  nim: "2024001",
  jurusan: "Informatika",
  aktif: true
};

console.log(mahasiswa.nama);    // "Fajar" (dot notation)
console.log(mahasiswa["nim"]);  // "2024001" (bracket notation)

mahasiswa.semester = 5; // menambah properti baru
console.log(mahasiswa.semester); // 5

Kombinasi array berisi object adalah pola paling umum di dunia nyata, misalnya daftar mahasiswa yang masing-masing punya nama dan NIM. Kuasai pola ini baik-baik karena ia muncul di hampir setiap aplikasi.

const daftarMahasiswa = [
  { nama: "Fajar", ipk: 3.5 },
  { nama: "Sinta", ipk: 3.8 },
  { nama: "Bimo", ipk: 3.2 }
];

daftarMahasiswa.forEach((mhs) => {
  console.log(`${mhs.nama} memiliki IPK ${mhs.ipk}`);
});

Manipulasi DOM: Menghubungkan JavaScript dengan Halaman Web

DOM (Document Object Model) adalah representasi halaman HTML sebagai struktur pohon yang bisa dibaca dan diubah oleh JavaScript. Inilah jembatan yang membuat halaman web menjadi interaktif. Tiga kemampuan DOM yang paling sering dipakai adalah mengambil elemen, mengubah isinya, dan merespons kejadian dari pengguna.

Untuk mengambil elemen, gunakan document.getElementById bila elemen punya atribut id, atau document.querySelector yang lebih fleksibel karena memakai sintaks selector CSS.

// <p id="sapaan">Halo dunia</p>
const paragraf = document.getElementById("sapaan");
paragraf.textContent = "Halo, JavaScript!"; // ubah isi teks

// querySelector memakai selector CSS
const tombol = document.querySelector(".btn-kirim");
tombol.style.backgroundColor = "orange"; // ubah gaya langsung

Interaksi sesungguhnya terjadi lewat event listener, yaitu fungsi yang dijalankan saat pengguna melakukan sesuatu seperti mengklik tombol. Polanya selalu sama: ambil elemen, pasang addEventListener, tulis fungsi yang dijalankan.

// <button id="tombolKlik">Klik saya</button>
// <p id="hasil"></p>

const tombolKlik = document.getElementById("tombolKlik");
const hasil = document.getElementById("hasil");

let jumlahKlik = 0;

tombolKlik.addEventListener("click", () => {
  jumlahKlik++;
  hasil.textContent = `Tombol diklik ${jumlahKlik} kali.`;
});

Selain click, ada banyak event lain seperti input (saat mengetik di form), submit (saat form dikirim), dan mouseover. Untuk mengubah tampilan, cara paling rapi adalah menambah atau menghapus class CSS lewat classList, bukan mengubah style satu per satu.

// <div id="kotak" class="kotak-biru"></div>
const kotak = document.getElementById("kotak");

kotak.classList.add("kotak-merah");    // tambah class
kotak.classList.remove("kotak-biru");  // hapus class
kotak.classList.toggle("aktif");       // alihkan: ada jadi hilang, hilang jadi ada

Method toggle pada contoh terakhir inilah yang akan menjadi bintang utama studi kasus kita berikutnya.

Studi Kasus Tutorial JavaScript Pemula: Membuat Toggle Dark Mode

Sekarang gabungkan semua yang sudah dipelajari menjadi satu program utuh: tombol yang mengalihkan halaman antara mode terang dan mode gelap. Buat satu file bernama dark-mode.html, lalu isi dengan kode berikut.

<!DOCTYPE html>
<html lang="id">
<head>
  <meta charset="UTF-8">
  <title>Toggle Dark Mode</title>
  <style>
    body {
      font-family: sans-serif;
      text-align: center;
      padding: 50px;
      transition: background-color 0.3s, color 0.3s;
    }
    body.dark {
      background-color: #1a1a2e;
      color: #f0f0f0;
    }
    button {
      padding: 12px 24px;
      font-size: 16px;
      cursor: pointer;
      border: none;
      border-radius: 8px;
      background-color: orange;
      color: white;
    }
  </style>
</head>
<body>
  <h1 id="judul">Belajar JavaScript Itu Seru</h1>
  <p>Klik tombol di bawah untuk mengganti tema halaman.</p>
  <button id="tombolTema">Aktifkan Dark Mode</button>

  <script>
    const tombolTema = document.getElementById("tombolTema");
    const judul = document.getElementById("judul");

    tombolTema.addEventListener("click", () => {
      document.body.classList.toggle("dark");

      const modeGelapAktif = document.body.classList.contains("dark");

      if (modeGelapAktif) {
        tombolTema.textContent = "Aktifkan Light Mode";
        judul.textContent = "Mode Gelap Aktif";
      } else {
        tombolTema.textContent = "Aktifkan Dark Mode";
        judul.textContent = "Belajar JavaScript Itu Seru";
      }
    });
  </script>
</body>
</html>

Mari bedah cara kerjanya baris per baris. Pertama, const dipakai untuk menyimpan referensi ke tombol dan judul karena referensi ini tidak pernah berubah. Kedua, addEventListener("click", ...) memasang fungsi yang berjalan setiap tombol diklik. Ketiga, classList.toggle("dark") menambah class dark ke body bila belum ada, atau menghapusnya bila sudah ada, sehingga CSS yang sudah disiapkan otomatis mengubah warna latar dan teks. Keempat, classList.contains("dark") memeriksa status saat ini supaya teks tombol dan judul ikut diperbarui dengan benar.

Coba simpan file itu lalu buka di browser dan klik tombolnya beberapa kali. Perhatikan bahwa seluruh logika hanya belasan baris. Inilah kekuatan manipulasi DOM: sedikit kode, dampak langsung terlihat. Sebagai tantangan mandiri, coba simpan pilihan tema pengguna memakai localStorage supaya mode gelap tetap aktif walau halaman di-refresh.

Kesalahan Umum yang Sering Dilakukan Pemula

Setiap pemula JavaScript hampir pasti menabrak beberapa jebakan klasik. Mengetahui jebakan ini sejak awal menghemat waktu debugging yang lumayan.

Pertama, memakai = (assignment) padahal maksudnya === (perbandingan ketat) di dalam if. JavaScript juga punya == yang melakukan konversi tipe otomatis dan sering menimbulkan hasil mengejutkan, jadi biasakan selalu memakai ===.

const umur = "20"; // string, bukan number!

if (umur == 20) {
  console.log("lolos dengan =="); // tercetak, karena konversi tipe
}

if (umur === 20) {
  console.log("tidak akan tercetak"); // string "20" tidak identik dengan number 20
}

Kedua, menjalankan kode DOM sebelum elemennya ada. Kalau tag script ditaruh di dalam head tanpa atribut khusus, kode berjalan sebelum body selesai dimuat sehingga getElementById mengembalikan null. Solusi paling mudah adalah menaruh script tepat sebelum penutup </body>, seperti pada studi kasus di atas.

Ketiga, lupa bahwa indeks array dimulai dari nol. Mengakses daftarBuah[3] pada array berisi tiga elemen menghasilkan undefined, bukan error, sehingga bug-nya bisa lolos tanpa disadari.

Keempat, mengubah const secara langsung. Ingat, const melarang assignment ulang terhadap variabelnya, walau isi object-nya masih boleh diubah. Pesan errornya berbunyi “Assignment to constant variable” yang cukup jelas.

Langkah Selanjutnya Setelah Tutorial Ini

Selamat, kamu sekarang memegang fondasi JavaScript yang solid: variabel dengan let dan const, tipe data, fungsi termasuk arrow function, array dan object, sampai manipulasi DOM dengan event listener. Fondasi ini cukup untuk membuat halaman web interaktif sederhana dan menjadi modal wajib sebelum melangkah ke topik yang lebih besar.

Langkah logis berikutnya adalah mempelajari cara JavaScript berkomunikasi dengan server lewat HTTP request. Untuk itu, baca dulu penjelasan konsepnya di artikel Apa Itu API? Penjelasan Sederhana Lengkap dengan Contoh untuk Pemula, lalu praktikkan dengan fetch untuk mengambil data nyata. Setelah nyaman di sisi frontend, saatnya melirik sisi backend: panduan Tutorial Laravel 12: Membuat CRUD Sederhana dari Nol untuk Pemula akan menunjukkan bagaimana data yang kamu olah di browser sebenarnya disimpan dan dikelola di server. Kombinasi JavaScript di frontend dan Laravel di backend adalah paket skill yang sangat dicari di dunia kerja pengembangan web saat ini.

Status Terkini: Apakah CPNS 2026 Sudah Dibuka?

Belum. Badan Kepegawaian Negara (BKN) memastikan belum ada pengumuman resmi mengenai pembukaan pendaftaran CPNS umum 2026. Portal resmi SSCASN juga belum menampilkan timeline pengadaan CPNS umum 2026.

Yang perlu kamu ketahui dari perkembangan terbaru:

• Seleksi Sekolah Kedinasan 2026 sudah berjalan dengan kebutuhan sekitar 4.770 formasi. Ini jalur berbeda dari rekrutmen CPNS umum yang membuka formasi di kementerian, lembaga, dan pemerintah daerah.
• Seleksi PPPK 2026 sudah berjalan di beberapa instansi, misalnya Kementerian HAM dan Kementerian Sosial.
• Beredar kabar soal 160 ribu formasi, tetapi rincian resmi per instansi tetap menunggu pengumuman pemerintah.
• BKN sudah berulang kali mengingatkan bahwa poster dan tautan yang mengklaim pendaftaran CPNS 2026 telah dibuka adalah hoaks.

Artinya, masa tunggu ini adalah waktu terbaik untuk persiapan. Pelamar yang dokumennya rapi dan sudah latihan soal sejak awal punya peluang jauh lebih besar dibanding yang baru siap saat pendaftaran dibuka.

Waspada Hoaks dan Penipuan CPNS

Sebelum membahas persiapan, ini peringatan penting karena modusnya makin rapi. Ciri-ciri informasi palsu seputar CPNS:

1. Poster atau tautan yang mengklaim pendaftaran sudah dibuka, padahal BKN belum mengumumkan apa-apa.
2. Tautan pendaftaran di luar domain resmi pemerintah (bukan *.go.id).
3. Daftar formasi yang mengaku resmi tetapi tidak berasal dari pengumuman BKN atau KemenPAN-RB.
4. Permintaan data pribadi melalui situs tidak dikenal.
5. Permintaan pembayaran atau biaya pendaftaran dalam bentuk apa pun.
6. Grup WhatsApp atau Telegram yang menjanjikan “jalur khusus” kelulusan.

Ingat prinsipnya: pendaftaran CPNS melalui SSCASN adalah gratis. Tidak ada biaya ke pihak mana pun. Informasi valid hanya dirilis melalui portal SSCASN (sscasn.bkn.go.id), situs resmi BKN (bkn.go.id), dan KemenPAN-RB (menpan.go.id). Jika menemukan informasi mencurigakan, verifikasi silang ke kanal resmi tersebut sebelum memercayainya atau menyebarkannya. Simpan tautan kanal resmi BKN di bookmark browser agar kamu tidak perlu mencari ulang setiap kali ada kabar baru.

Syarat Umum Pendaftaran CPNS

Syarat final selalu mengikuti pengumuman resmi formasi dan instansi saat seleksi dibuka. Namun berdasarkan pola seleksi tahun-tahun sebelumnya, syarat umum yang hampir selalu diminta adalah:

1. Warga Negara Indonesia.
2. Berusia minimal 18 tahun dan maksimal 35 tahun pada saat melamar (beberapa formasi khusus punya batas berbeda).
3. Tidak pernah dipidana dengan pidana penjara 2 tahun atau lebih.
4. Tidak pernah diberhentikan dengan tidak hormat dari pekerjaan sebelumnya (PNS, TNI, Polri, atau pegawai swasta).
5. Tidak sedang berstatus sebagai CPNS, PNS, prajurit TNI, atau anggota Polri.
6. Sehat jasmani dan rohani sesuai persyaratan jabatan.
7. Pendidikan minimal sesuai dengan formasi yang dilamar (SMA, D3, S1, sesuai ketentuan tiap formasi).
8. Bersedia ditempatkan di seluruh wilayah Indonesia.

Selain syarat umum, tiap instansi dan formasi biasanya menambah syarat khusus, misalnya IPK minimal, akreditasi kampus atau program studi, sertifikat kemampuan bahasa Inggris, atau pengalaman kerja. Baca pengumuman formasi incaranmu dengan teliti saat sudah terbit, karena syarat khusus inilah yang paling sering menggugurkan pelamar di tahap administrasi.

Dokumen yang Wajib Disiapkan dari Sekarang

Seleksi administrasi adalah tahap pertama dan paling banyak menggugurkan peserta, sering kali karena kesalahan sepele pada dokumen. Siapkan dari sekarang:

1. KTP elektronik. Pastikan NIK, nama, tempat dan tanggal lahir sesuai dengan dokumen lain. Perbedaan satu huruf atau angka bisa bermasalah saat verifikasi.
2. Kartu Keluarga. Data KK dipakai saat pembuatan akun SSCASN.
3. Ijazah terakhir yang dilegalisir. Sesuai jenjang formasi yang diincar.
4. Transkrip nilai. IPK harus memenuhi syarat minimal formasi.
5. Pas foto terbaru. Umumnya berlatar merah dengan ketentuan ukuran dan pakaian formal yang akan dirinci di pengumuman.
6. SKCK. Surat Keterangan Catatan Kepolisian dari Polres setempat, masih berlaku.
7. Surat keterangan sehat jasmani dan rohani dari rumah sakit pemerintah atau puskesmas.
8. Surat lamaran dan daftar riwayat hidup, mengikuti format yang ditentukan instansi.
9. Dokumen pendukung formasi khusus, misalnya sertifikat TOEFL untuk formasi yang mensyaratkan, atau surat pengalaman kerja.

Tips praktis: pindai semua dokumen dalam format PDF dan simpan juga versi JPG-nya, karena SSCASN meminta unggahan dengan format dan ukuran file tertentu. Beri nama file yang rapi agar tidak tertukar saat mengunggah.

Cara Buat Akun SSCASN dan Alur Pendaftaran

Alur berikut berdasarkan mekanisme portal SSCASN pada seleksi sebelumnya. Tampilannya bisa sedikit berubah, tetapi logikanya sama.

Membuat akun

1. Buka portal resmi di sscasn.bkn.go.id melalui browser.
2. Pilih menu pembuatan akun baru.
3. Isi NIK, nomor KK, nama lengkap, tempat dan tanggal lahir, nomor HP aktif, dan email aktif. Pastikan email dan nomor HP benar-benar aktif karena seluruh informasi penting dikirim ke sana.
4. Buat password dan pertanyaan pengaman, lalu simpan.
5. Selesaikan pendaftaran akun dan catat baik-baik username serta passwordnya.

Mendaftar formasi

1. Login ke portal SSCASN dengan akun yang baru dibuat.
2. Lengkapi biodata diri sesuai KTP.
3. Pilih jenis seleksi (CPNS), lalu pilih instansi dan formasi yang sesuai dengan kualifikasi pendidikanmu.
4. Unggah seluruh dokumen yang diminta sesuai format dan ukuran yang ditentukan.
5. Periksa kembali semua isian di halaman resume. Tahap ini krusial karena kesalahan yang lolos dari sini sulit diperbaiki.
6. Akhiri pendaftaran dan cetak kartu informasi akun serta kartu pendaftaran sebagai bukti.

Satu akun hanya bisa dipakai untuk satu formasi pada satu periode seleksi, jadi pilih formasimu dengan perhitungan matang, bukan asal klik.

Strategi Memilih Formasi yang Tepat

Satu akun hanya bisa dipakai untuk satu formasi per periode seleksi, jadi keputusan ini sangat menentukan. Beberapa prinsip yang dipakai pelamar berpengalaman:

1. Ukur dirimu sendiri. Bandingkan kualifikasi pendidikan, IPK, dan pengalamanmu dengan syarat formasi. Formasi yang syarat khususnya paling sedikit adalah yang peluang lolos administrasinya paling besar.
2. Perhatikan rasio pelamar. Formasi populer di kota besar bisa diperebutkan ribuan orang untuk belasan kursi. Formasi di daerah atau unit kerja yang kurang dilirik sering punya rasio jauh lebih bersahabat.
3. Jangan kejar formasi di luar kompetensimu. Syarat khusus seperti sertifikat bahasa atau pengalaman kerja tidak bisa dipenuhi dadakan. Pilih yang memang sesuai dengan apa yang kamu miliki sekarang.
4. Siapkan rencana cadangan. Jika tahun ini belum lolos, pengalaman mengikuti seluruh tahapan (terutama SKD) adalah modal besar untuk seleksi berikutnya.

Tahapan Seleksi Setelah Pendaftaran

Memahami alurnya membantumu menyusun strategi belajar:

1. Seleksi administrasi. Verifikasi dokumen dan syarat. Lolos tahap ini syarat mutlak untuk ikut tes.
2. Seleksi Kompetensi Dasar (SKD) dengan sistem CAT BKN, terdiri dari TWK (Tes Wawasan Kebangsaan), TIU (Tes Intelegensia Umum), dan TKP (Tes Karakteristik Pribadi). Ada nilai ambang batas (passing grade) tiap subtes.
3. Seleksi Kompetensi Bidang (SKB). Materi sesuai jabatan yang dilamar, bisa berupa tes tertulis, praktik, atau wawancara, tergantung instansi.
4. Pengumuman dan pemberkasan. Peserta yang lolos mengikuti pemberkasan untuk penetapan NIP.

Untuk latihan, BKN menyediakan portal latihan soal CAT di cat.bkn.go.id. Mulai kerjakan soal TWK, TIU, dan TKP dari sekarang. Bagi waktu belajarmu: TWK butuh pemahaman wawasan kebangsaan (Pancasila, UUD 1945, sejarah nasional), TIU butuh latihan logika numerik dan verbal yang diulang sampai cepat, sedangkan TKP menilai karakter lewat skenario dan tidak ada jawaban yang sepenuhnya salah. Kerjakan tryout dengan timer agar terbiasa dengan tekanan waktu ujian sesungguhnya.

FAQ Pendaftaran CPNS 2026

1. Kapan pendaftaran CPNS 2026 dibuka?
Per Oktober 2026, BKN belum mengumumkan jadwal resmi pendaftaran CPNS umum 2026. Pantau portal SSCASN (sscasn.bkn.go.id) dan kanal resmi BKN. Jangan percaya jadwal yang tidak bersumber dari kanal resmi.

2. Apakah fresh graduate bisa mendaftar CPNS 2026?
Bisa. Lulusan baru justru menjadi salah satu prioritas dalam rekrutmen ASN. Pastikan ijazah dan transkripmu sudah terbit dan sesuai dengan kualifikasi formasi yang diincar.

3. Berapa biaya pendaftaran CPNS?
Gratis. Seluruh tahapan rekrutmen CPNS resmi tidak dipungut biaya apa pun. Jika ada pihak yang meminta bayaran dengan dalih pendaftaran atau kelulusan, itu penipuan.

4. Dokumen apa yang paling sering menggugurkan pelamar di seleksi administrasi?
Ketidaksesuaian data antara KTP, KK, dan ijazah (beda ejaan nama atau tanggal lahir), pas foto yang tidak sesuai ketentuan, serta dokumen pendukung formasi khusus yang tidak lengkap. Rapikan semuanya dari sekarang.

5. Di mana saya bisa latihan soal SKD resmi?
BKN menyediakan portal latihan di cat.bkn.go.id dengan materi TWK, TIU, dan TKP. Manfaatkan juga pengumuman resmi BKN dan KemenPAN-RB sebagai satu-satunya sumber informasi jadwal dan formasi.

6. Apakah boleh mendaftar lebih dari satu formasi sekaligus?
Tidak. Aturannya tegas: satu pelamar hanya boleh memilih satu formasi di satu instansi dalam satu periode pendaftaran. Sistem SSCASN akan menolak jika kamu mencoba membuat pendaftaran ganda. Karena itu strategi memilih formasi menjadi krusial, pelajari rasio pelamar dan formasi tahun sebelumnya sebelum mengunci pilihanmu.

Kesimpulan

Pendaftaran CPNS 2026 memang belum dibuka per Oktober 2026, tetapi itu bukan alasan untuk menunggu tanpa persiapan. Yang bisa kamu kerjakan sekarang: merapikan data kependudukan, menyiapkan dan memindai semua dokumen, memastikan email serta nomor HP aktif, dan mulai latihan soal SKD di portal CAT BKN. Sambil menunggu, tetap waspada terhadap hoaks dan jangan pernah membayar untuk urusan pendaftaran.

Pola persiapan seperti ini, menyiapkan dokumen resmi jauh sebelum dibutuhkan, berlaku juga untuk urusan administrasi lainnya. Baca juga panduan Cara Cek BSU BPJS Ketenagakerjaan 2026 di blog ini untuk memahami cara memantau status program pemerintah secara online lewat HP.