Laravel 13.24 menambahkan rule validasi array_keys yang dapat menolak array ketika terdapat key di luar daftar yang diizinkan. Laravel News menjelaskan bahwa pesan validasi juga dapat menyebut key yang tidak sesuai, sehingga developer lebih mudah mengetahui bagian request yang bermasalah.
Validasi array sering dipakai pada form dinamis, payload API, konfigurasi, dan data bersarang. Rule dasar yang hanya memeriksa apakah sebuah field berupa array belum tentu cukup karena client dapat mengirim key tambahan yang tidak pernah dirancang oleh aplikasi.
Mengapa key tambahan perlu diperhatikan?
Payload dengan key tidak dikenal dapat diabaikan, tetapi pada kasus tertentu juga dapat menyebabkan perilaku yang tidak diharapkan. Masalah menjadi lebih serius ketika data langsung dipetakan ke model, diteruskan ke service, atau dipakai untuk menentukan konfigurasi.
Dengan validasi key yang lebih ketat, aplikasi dapat menolak struktur yang tidak sesuai lebih awal. Developer mendapatkan kesempatan untuk memberikan respons error yang jelas sebelum data masuk ke proses bisnis berikutnya.
Contoh area penggunaan
- Payload API yang memiliki daftar opsi terbatas.
- Form filter dengan parameter yang sudah ditentukan.
- Konfigurasi fitur yang hanya menerima key tertentu.
- Data nested untuk pengaturan profil atau preferensi.
Sebelum menerapkan rule ini, buat daftar key yang memang didukung oleh endpoint. Tambahkan test untuk payload valid, key yang tidak dikenal, array kosong, dan struktur nested agar perubahan validasi tidak memblokir request yang sah.
Dampak untuk aplikasi Laravel
Perubahan kecil pada validation layer dapat meningkatkan kejelasan kontrak API. Client mengetahui field yang boleh dikirim, sementara backend memiliki batas yang lebih tegas terhadap data yang diterima.
Pada aplikasi yang sudah berjalan, upgrade tetap perlu diuji karena perubahan validasi dapat memunculkan error pada client lama yang selama ini mengirim key tambahan. Dokumentasikan perubahan dan siapkan pesan error yang bisa ditangani dengan baik oleh frontend.
Kesimpulan
Rule array_keys di Laravel 13.24 membantu developer mengontrol bentuk payload dengan lebih presisi. Fitur ini cocok untuk memperjelas kontrak data, memperbaiki feedback validasi, dan mengurangi input tak terduga pada endpoint Laravel.
Sumber asli:
https://laravel-news.com/laravel-array-keys-validation-rule
