Dari 1.145 ke Nol: Kisah PHPStan Kami

Ada satu angka yang tidak pernah bisa kami lupakan: 1.145.

Itu jumlah yang muncul di terminal pada 18 Februari ketika kami menjalankan PHPStan — alat yang memeriksa kode PHP tanpa harus menjalankannya, seperti editor yang membaca naskah sebelum dicetak — untuk pertama kalinya dengan pengaturan level yang ketat. 1.145 potensi masalah dalam kode yang dua minggu lagi harusnya bisa diakses publik.

PHPStan bekerja dalam level 1 sampai 9. Level 6 sudah cukup ketat untuk kebanyakan proyek profesional. Level 9 berarti hampir tidak ada toleransi: setiap variabel harus jelas jenisnya, setiap kemungkinan nilai kosong harus ditangani secara eksplisit, tidak ada array tanpa deklarasi isi yang spesifik, tidak ada satu pun baris pengecualian yang boleh ditambahkan untuk menyembunyikan masalah. Zero errors. Zero ignores.

Kami memulai dari Level 7 sebagai target saat itu. Itu sudah cukup ambisius.

Domain pertama yang kami bawa ke Level 9 — bahkan sebelum domain lain mencapai Level 7 — adalah d01: domain yang menangani kepercayaan, autentikasi, dan identitas pengguna. Alasannya jelas: kalau ada kesalahan tipe data di sini, efeknya bisa menjalar ke semua 25 domain lain yang bergantung padanya. Kami menyebut standar ini "Diamond Standard". Di d01, tidak ada kompromi: setiap array harus dideklarasikan isi jenisnya secara eksplisit, setiap fungsi harus punya tipe kembalian yang definitif, tidak ada satu pun baris yang dikecualikan dari pemeriksaan.

Pelan-pelan, domain demi domain, standar yang sama menyebar. Ada hari ketika kami berhasil menyelesaikan dua ratus masalah sekaligus. Ada hari lain ketika menyelesaikan satu masalah memunculkan tiga masalah baru — tipe data yang salah itu ternyata sudah digunakan di banyak tempat, seperti benang yang ketika ditarik ternyata tersambung ke mana-mana.

Ketika PHPStan menampilkan "No errors" di Level 9 untuk seluruh 26 domain sekaligus — tanpa satu pun baris pengecualian yang tersembunyi — ada keheningan sebentar di ruang chat tim. Lalu seseorang mengetik: "alhamdulillah." Bukan perayaan besar. Tapi bagi yang tahu berapa banyak malam yang dihabiskan untuk sampai ke titik ini, itu sudah cukup.

Level 9 dengan nol error dan nol pengecualian berarti setiap variabel yang berjalan di seluruh platform ini sudah diperiksa secara statis sebelum kode menyentuh satu pun pengguna nyata. Kepercayaan pengguna kepada SURAU dimulai dari kepercayaan tim terhadap kodenya sendiri.