E-pin Satis Sistemi Beyaz Ekran Sorunu: Sitenin Neden Bir Anda Bembeyaz Kaldigini ve Panelini Kimsenin Anlatmadigi 7 Gizli Sebebi Ogren

Cogu kisi beyaz ekranı bir "hosting cokmesi" sanır. Panele girmeye calisirsin, tarayıcı bembeyaz bir sayfa gosterir, ne hata mesajı ne de bir uyarı vardır. Ilk refleks hosting firmasına ticket acmaktır. Oysa e-pin satis sistemlerinde beyaz ekranın buyuk cogunlugu sunucunun ayakta olmamasından degil, PHP'nin bir olumcul hatayı ekrana yazmamaya ayarlanmis olmasından kaynaklanır. Yani sunucu calisiyordur, script calisiyordur, sadece hata ciktisi bastırılmıstır. Sen beyaz bir duvara bakarken arka tarafta log dosyasına tek satırlık bir cevap yazılmıstır.

Bu ayrım cok onemli, cunku yanlıs teshis saatler kaybettirir. Bir e-pin satis scripti icinde bakiye, siparis, otomatik teslimat ve odeme geri bildirimi ayni anda calisir. Beyaz ekran sirasinda musteri odeme yapmaya devam edebilir, hatta bakiye dusulup kod teslim edilmeyebilir. Bu yuzden beyaz ekran bir "gorunum sorunu" degil, dogrudan ticari risk tasiyan bir kesintidir. Asagida beyaz ekranın gercek nedenlerini, hangi sirayla bakman gerektigini ve modern bir e-pin yazilimi altyapisinin bu durumu nasil bastan engelledigini anlatiyorum.

Beyaz ekran gercekten "sunucu coktu" demek mi?

Hayir, cogu zaman tam tersi. Sunucu coktugunde tarayıcı sana 500, 502 ya da 503 gibi bir durum kodu ve cogu hosting panelinde ozel bir hata sayfası doner. Bembeyaz, tamamen bos bir govde ise PHP surecinin baslayip ortasinda durdugunun isaretidir. Teknik adı fatal error. Script bir sınıfı bulamamis, bir fonksiyon iki kez tanimlanmis, bellek limiti asilmis ya da bir dosya yarim yuklenmistir. display_errors kapali oldugu icin de ekrana hicbir sey yazilmaz.

Ilk yapman gereken sey tahmin etmek degil, kanıt toplamaktır. Hosting panelindeki hata gunlugu (error_log) dosyasini ac, en alt satira bak. Orada neredeyse her zaman dosya yolu ve satır numarasıyla birlikte tek bir cumle bulursun. Bir dijital urun satis scripti icinde bu cumle genellikle "Class not found", "Allowed memory size exhausted" veya "Cannot redeclare" seklindedir. Bu tek satir, saatlerce sureceini sandigin isi on dakikaya indirir.

Hangi degisiklikten sonra beyaz ekrana dustun?

Beyaz ekran kendiliginden olusmaz; neredeyse her vakada oncesinde bir hareket vardir. Bir eklenti yuklemissindir, tema dosyasi duzenlemissindir, hosting PHP surumunu yukseltmistir, yarim bir FTP aktarimi yapmissindir ya da bir dosyayi panelden duzenlerken Turkce karakter yuzunden kodu bozmussundur. Kendine sormalisin: son 24 saatte bu sistemde ne degisti?

Ozellikle PHP surum yukseltmeleri sinsidir. Hosting firmasi sunucuyu PHP 8.x'e tasidiginda eski yazilmis bir e-pin scripti icindeki kaldirilmis fonksiyonlar (ornegin eski mysql cagrilari ya da artik desteklenmeyen dizi kullanimlari) aninda olumcul hata uretir. Site gunlerce sorunsuz calisip bir sabah beyaz kaliyorsa, ilk bakacagin yer kendi kodun degil, sunucunun PHP surumudur. Guncel bir e-pin satis yazilimi bu yuzden desteklenen surum araligini acikca belirtir.

Bellek limiti sessiz katil olabilir mi?

Evet, ve bu en cok atlanan sebeptir. Bir e-pin satis sisteminde stok listesi, siparis gecmisi ve rapor ekranlari buyudukce tek seferde islenen veri artar. Paylasimli hostinglerde varsayilan bellek limiti genellikle dusuktur. Rapor ekranini actiginda 40 bin satiri belege almaya calisan bir sorgu limiti asar ve sayfa beyaz doner. Ilginc olan sudur: ana sayfa sorunsuz calismaya devam eder, sadece belirli bir ekran beyazdir. Bu deseni gordugunde hemen bellek ve sorgu tarafina bak.

Kalici cozum limiti surekli yukseltmek degil, sayfalama ve toplu sorgu disiplinidir. Iyi tasarlanmis bir dijital urun satis yazilimi raporu parca parca ceker, listeleri sayfalar ve agir islemleri arka plana atar. Limit artirmak semptomu erteler; mimari duzeltmek sorunu bitirir.

Yarim FTP aktarimi neden bu kadar sik sorun cikarir?

Guncelleme yaparken baglanti koptugunda dosyalarin bir kismi yeni, bir kismi eski kalir. PHP acisindan bu, birbirini tanimayan iki farkli surumun ayni anda calismasi demektir. Sonuc cogu zaman "Class not found" veya yarim kesilmis bir dosyada sozdizimi hatasidir. Ozellikle 0 bayt boyutunda kalmis bir dosya gorursen sebep budur.

Bunun onune gecmenin yolu guncellemeyi dogrudan canli dizine yapmamaktir. Once bir kopya klasore yukle, dosya sayisini ve boyutlarini dogrula, sonra degistir. Profesyonel bir epin yazilim kurulumunda guncelleme paketleri butunluk kontrolu ile gelir; eksik dosya varsa sistem daha ilk adimda uyarir ve yayina gecmez.

Beyaz ekran sirasinda musteri parasi ne oluyor?

Asil tehlike burada. Odeme saglayicisi islemi onayladiginda senin sisteminin cevabini bekler. Site beyaz ekrandaysa bu cevap islenemez. Musteri odemeyi yapmistir ama siparis olusmamistir. Bunu birkac saat fark etmezsen elinde acıklanamayan tahsilatlar ve ofkeli musteriler olur.

Bu yuzden saglam bir e-pin satis scripti odeme bildirimlerini gorsel arayuzden bagimsiz, ayri bir uc noktada isler ve gelen her bildirimi ham haliyle kaydeder. Arayuz coksa bile bildirim kaydi durur; sistem ayaga kalktiginda bekleyen kayitlar tekrar islenir. Pinova'nin yaklasimi tam olarak budur: gorsel katman ile islem katmani ayrildiginda beyaz ekran bir vitrin sorununa dusurulur, muhasebe sorununa donusmez.

Kalici olarak nasil engellenir?

Beyaz ekran tek seferlik bir kaza degil, genellikle surec eksikliginin belirtisidir. Guncelleme oncesi yedek alinmiyor, test ortami yok, PHP surumu takip edilmiyor, hata gunlugu hic acilmiyorsa ayni sorun tekrar tekrar doner. Cozum bir dosya degil, bir alisanklik setidir: yedek, asamalı guncelleme, log takibi ve calisirlik kontrolu.

Asagidaki kontrol listesini her mudahaleden once bastan asagi uygula. Sirayi bozma; ustteki maddeler alttakilerin sebebini eler.

Beyaz ekran, altyapinin sana "burada gorunmeyen bir sey kirildi" demesidir. Dogru araclarla bu mesaj korkutucu olmaktan cikar, on dakikalik rutin bir bakima donusur. Kendi e-pin sistemini kurarken hata gorunurlugu, guvenli guncelleme ve bagimsiz odeme isleme katmanlarinin nasil calistigini yakindan gormek istersen canli demo uzerinden panelin ic yapisini inceleyebilir, kendi senaryolarini test edebilirsin.