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.
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.
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.
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.
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.
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.
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.
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.
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
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?
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
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
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
kenapa pake cara set null dgn ttl -1 buat invalidate? bukannya lebih bersih kalo ada method delete khusus?
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!
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!
Tunggu, jadi maksudnya selama ini jadwal asyura sama arafah emang bener2 gapernah muncul ke user? Atau ada fallback sebelumnya min?
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
konsep tiga lapis ini menurut saya bisa dipake di sistem apapun sih. validasi input, validasi output, auto recover. simple tapi efektif
biasanya saya skip kalo ada artikel teknis tapi ini enak bacanya, gak bikin pusing meski saya bukan programmer. lanjutin nulis kayak gini ya min
Makasih banyak Mbak Dina 🙏 emang itu yang kami usahain, biar artikel teknisnya tetep bisa dinikmati semua orang
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
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 👍
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
Tafsir budaya, bukan kepastian nasib. Chat hanya disimpan selama halaman ini terbuka.