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)
Wahyu Eko 2026-06-28 20:38:14

ada resiko infinite loop ga buat self healing nya? misal rebuild cache nya gagal terus dicoba lagi terus menerus

Admin Primbon 👑 Admin 2026-06-28 21:10:05

Gak ada Mas Wahyu, soalnya ini per-request bukan loop dalam satu proses. Kalo rebuild gagal, request berikutnya yang nyoba lagi, bukan diulang-ulang di request yang sama. Worst case-nya ya kalkulasinya jalan tiap request sampe sukses disimpen, tapi tetep aman karena gak ada efek samping apa-apa selain itu

Lestari H 2026-06-28 21:45:28

jarang loh nemu website yg mau terbuka soal errornya. biasanya cuma tulis 'sedang dalam perbaikan' doang tanpa penjelasan. ini malah dijadiin pembelajaran, respect 👏

Admin Primbon 👑 Admin 2026-06-28 22:08:33

Makasih Mbak Lestari 🙏 kami emang percaya error itu wajar, yang penting gimana kita ceritain dan apa yang dipelajarin dari situ

Bayu S 2026-06-28 22:47:51

mantap min jadwal puasanya sekarang udah muncul semua, asyura sama arafah nya juga udah ada. makasih udah cepet diperbaiki

Citra A 2026-06-29 07:12:40

baca komen2 di atas jadi ikut belajar juga walau saya bukan dari it. seru ternyata diskusi soal teknis kalo dibawain santai gini

Halaman 2 dari 2 • 14 komentar utama

Tulis Komentar

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