Tentang Kami 2026-06-28 • Admin Primbon

Cerita di Balik Error Minggu Pagi: Ketika Cache Menyimpan Object yang Tidak Boleh Disimpan

Minggu, 28 Juni 2026, pagi-pagi sekali. Belum juga sempat ngopi, notifikasi error log sudah masuk. Fitur Jadwal Puasa Sunnah yang baru kami luncurkan beberapa hari lalu — yang harusnya jadi kebanggaan kecil tim — tiba-tiba bikin halaman blank putih buat siapa saja yang mencoba membukanya.

Bukan error biasa. Ini PHP Fatal Error, jenis yang langsung menghentikan seluruh proses, bukan sekadar warning yang bisa diabaikan.

Pesan Error yang Awalnya Membingungkan

Begini bunyinya kira-kira: ada fungsi yang seharusnya menerima teks biasa, tapi yang datang malah sesuatu bernama __PHP_Incomplete_Class. Nama yang asing buat yang belum pernah ketemu sebelumnya, dan jujur saja, kami pun butuh beberapa menit untuk benar-benar paham apa maksudnya.

Singkatnya begini: PHP berhasil mengambil data yang tersimpan, tapi data itu sebenarnya sebuah object — dan class dari object tersebut tidak dikenali saat dipanggil ulang. Hasilnya bukan error langsung saat data diambil, tapi nanti, saat data itu dipakai. Jebakan yang cukup halus.

Kembali ke Awal Mula

Untuk ngerti kenapa ini terjadi, kami harus mundur ke versi awal kode. Waktu itu, hasil kalkulasi jadwal puasa — termasuk tanggal-tanggal dalam bentuk object DateTimeImmutable — disimpan apa adanya ke dalam cache. PHP sebenarnya bisa menyimpan object semacam ini tanpa keluhan.

Masalahnya muncul belakangan, saat data itu dibaca kembali. Di lingkungan server tertentu, terutama shared hosting yang resource-nya terbatas, urutan pemuatan class kadang tidak selalu konsisten. Dan kalau class tanggal itu belum siap saat data di-restore, ya jadinya seperti itu — object kosong yang menyamar sebagai data valid.

Pelajaran yang kami bawa pulang: jangan pernah menyimpan object PHP langsung ke cache. Ubah dulu ke bentuk sederhana seperti teks atau angka, baru simpan. Nanti waktu dibaca lagi, ubah balik ke bentuk aslinya.

Perbaikan Pertama, yang Ternyata Belum Cukup

Kami langsung tambahkan dua fungsi kecil. Satu untuk mengubah semua tanggal jadi teks biasa sebelum disimpan, satu lagi untuk mengubahnya balik jadi tanggal asli setelah dibaca dari cache.

Rasanya sudah selesai. Tapi belum juga sempat lega, error yang sama muncul lagi.

Ternyata Cache Lama Masih Bersembunyi

Yang kami lupa adalah ini: perbaikan tadi hanya berlaku untuk data baru. File cache lama yang sudah ada di server, yang isinya object corrupt dari versi sebelum perbaikan, tidak ikut diperbaiki. Server masih saja membaca file lama itu, dan errornya kembali muncul, persis seperti sebelumnya.

Solusi paling cepat tentu saja menghapus file cache itu secara manual lewat server. Tapi rasanya itu bukan solusi yang bisa diandalkan untuk jangka panjang. Bayangkan setiap kali ada perubahan kecil di format cache, harus selalu ingat untuk masuk ke server dan menghapus file satu per satu. Sekali lupa, pengunjung yang kena getahnya.

Maka Kami Bikin Sistem yang Bisa Sembuh Sendiri

Daripada terus mengandalkan ingatan untuk menghapus cache manual, kami buat sistem yang bisa mendeteksi masalahnya sendiri. Caranya sederhana: setiap kali data dibaca dari cache, sistem memeriksa apakah datanya benar-benar berupa teks seperti yang diharapkan. Kalau bukan, berarti ada yang salah, dan sistem langsung tahu cache itu tidak bisa dipakai.

Begitu ketahuan rusak, sistem otomatis membuang cache yang lama, menghitung ulang semuanya dari awal, lalu menyimpan hasil yang baru dengan format yang benar. Semua ini terjadi dalam satu kali permintaan halaman, tanpa pengunjung sadar ada drama di belakangnya.

Satu Masalah Lagi yang Kebetulan Ketemu

Di tengah-tengah memperbaiki cache, kami sadar ada masalah lain yang lebih mendasar. Algoritma yang kami pakai untuk menghitung tanggal Hijriah ternyata salah hitung sampai hampir tiga puluh tahun. Akibatnya, jadwal puasa tahunan seperti Asyura dan Arafah tidak pernah muncul sama sekali — sistem mengira sekarang masih tahun 1990-an.

Untungnya kami sudah punya komponen konversi kalender yang dipakai di bagian lain website, yang sudah dikalibrasi dengan data rukyat resmi Indonesia. Tinggal disambungkan saja, dan masalahnya selesai.

Yang Kami Pelajari dari Pagi yang Tidak Santai Ini

Dari satu error sederhana, kami akhirnya membangun tiga lapis penjagaan untuk sistem cache: pastikan data yang disimpan selalu dalam bentuk yang aman, periksa lagi data itu saat dibaca, dan kalau ternyata rusak, perbaiki sendiri tanpa menunggu campur tangan manusia.

Kami juga belajar sesuatu yang lebih sederhana dari itu semua. Bahwa website yang bagus bukan yang tidak pernah error, tapi yang tahu cara bangkit lagi ketika error itu datang. Dan kalau bisa, sembuh sebelum ada yang sempat sadar kalau dia sakit.

Bagikan: WhatsApp
Komentar (23)
Rizal Firmansyah 2026-06-28 11:05:33

wah relate banget min. __PHP_Incomplete_Class itu emang jebakan banget, gak langsung keliatan errornya pas unserialize, baru muncul pas dipake. butuh waktu lama buat nemu root cause nya kalo gak ngerti konsepnya

Admin Primbon 👑 Admin 2026-06-28 11:42:17

Betul banget Mas Rizal, yang bikin susah emang karena gak error langsung. Object-nya kelihatan 'ada' tapi kosong dalemnya. Pernah kena kasus serupa di project lain?

Sari Dewi 2026-06-28 12:33:09

Oh jadi itu alasannya kenapa orang-orang bilang jangan simpen object ke cache. Selama ini saya ikutin aja tanpa tau alasannya 😂 makasih min jadi paham

Hendro P. 2026-06-28 13:02:58

Self healing cache nya keren. Di kantor saya masih manual, kalo ada perubahan format cache harus chat tim infra dulu buat flush redis. Kadang nunggu sejam baru beres

Admin Primbon 👑 Admin 2026-06-28 13:38:25

Wah lama juga ya nunggu sejam. Itu yang bikin user kena dampaknya paling lama. Dengan self healing, request pertama setelah deploy langsung rebuild, request setelahnya udah dapet data yang bener

Nugroho W 2026-06-28 14:11:37

kenapa pake cara set null dgn ttl -1 buat invalidate? bukannya lebih bersih kalo ada method delete khusus?

Admin Primbon 👑 Admin 2026-06-28 14:55:02

Bener juga Mas Nugroho, idealnya emang pake delete kalo ada. Kami pake cara itu karena waktu itu belum yakin class cache-nya punya method delete atau enggak. Nanti kami cek lagi dan rapihin ke cara yang lebih clean. Thanks masukannya!

Putri R 2026-06-28 15:20:14

sebagai orang yg cuma pake buat cek jadwal puasa doang, baca ini jadi ngerti kenapa kadang website tiba2 ngadat. ternyata di belakangnya ribet juga ya. semangat min!

Yusuf Hakim 2026-06-28 15:44:30

Tunggu, jadi maksudnya selama ini jadwal asyura sama arafah emang bener2 gapernah muncul ke user? Atau ada fallback sebelumnya min?

Admin Primbon 👑 Admin 2026-06-28 16:18:49

Iya Mas Yusuf bener2 gak muncul, tampilannya 'tidak ada jadwal' yang kelihatan kayak bug biasa padahal logicnya jalan tapi salah hitung tahun. Untungnya fitur ini masih baru jadi belum terlalu banyak yang sempet pakai

Agus Tri S 2026-06-28 16:55:22

konsep tiga lapis ini menurut saya bisa dipake di sistem apapun sih. validasi input, validasi output, auto recover. simple tapi efektif

Dina M 2026-06-28 17:30:08

biasanya saya skip kalo ada artikel teknis tapi ini enak bacanya, gak bikin pusing meski saya bukan programmer. lanjutin nulis kayak gini ya min

Admin Primbon 👑 Admin 2026-06-28 17:58:41

Makasih banyak Mbak Dina 🙏 emang itu yang kami usahain, biar artikel teknisnya tetep bisa dinikmati semua orang

Rendi K 2026-06-28 18:44:17

min kalo boleh usul, bikin artikel khusus soal komponen konversi kalendernya dong. yg bisa hitung jawa, hijriah, imlek sekaligus itu jarang banget liat di project php, pasti banyak cerita di baliknya

Admin Primbon 👑 Admin 2026-06-28 19:22:53

Noted Mas Rendi! Itu emang salah satu bagian paling kompleks di website ini, banyak hitung-hitungan astronomi dan tabel kalibrasi di dalemnya. Bakal kami bahas terpisah nanti 👍

Farida N 2026-06-28 20:05:39

ketemu minggu pagi langsung beres hari itu juga, cepet banget. saya pernah nunggu bug di website lain sampe 3 hari belum kelar 😭

Halaman 1 dari 2 • 14 komentar utama

Tulis Komentar

Tidak boleh mengandung HTML. Maksimal 500 karakter.
← Kembali ke Blog