WordPress Güncelleme Sonrası Site Bozuldu: Çözüm

Kısa cevapWordPress güncelleme sonrası site bozulduysa önce belirtiyi ayırt edin (beyaz ekran, 500 hatası, kritik hata e-postası veya yalnızca bozuk görünüm). Sonra FTP ya da dosya yöneticisiyle wp-content/plugins klasörünü geçici olarak yeniden adlandırarak eklentileri devre dışı bırakın. Site açılırsa suçlu bir eklentidir. Açılmazsa temayı varsayılana döndürün, çekirdek dosyaları yeniden yükleyin ve son çare olarak yedekten dönün.

Güncelleme düğmesine basıp siteyi açamamak çok yaygın bir durumdur ve çoğu zaman tek bir eklenti, tema ya da yarım kalmış bir güncelleme yüzünden olur. WordPress güncelleme sonrası site bozuldu diyorsanız panik yapmayın: veriler büyük olasılıkla yerinde, bozulan şey çalışan kod. Bu yazı önce hızlı teşhis yapmanızı, sonra en az riskli çözümden en radikal olana doğru ilerlemenizi sağlar. Her adımda neyi değiştirdiğinizi not edin, çünkü geri almak gerekebilir.

Önce ne görüyorsunuz? Hızlı teşhis tablosu

Doğru çözüm, ekranda ne gördüğünüze bağlıdır. Aşağıdaki tablo belirtiyi olası nedene ve ilk adıma bağlar.

Belirti	Olası neden	İlk adım
Tamamen boş beyaz ekran	PHP fatal error, çoğunlukla eklenti veya tema	Eklentileri devre dışı bırakın
Sitenizde bir sorun var, kritik hata	WordPress fatal error yakaladı	Yönetici e-postasındaki kurtarma bağlantısını kullanın
500 Internal Server Error	Bozuk .htaccess, bellek sınırı veya PHP hatası	.htaccess dosyasını yeniden adlandırın, sonra eklentileri deneyin
Planlanmış bakım nedeniyle kullanılamıyor	Güncelleme yarıda kesildi	.maintenance dosyasını silin
Site açılıyor ama görünüm dağınık	Tema veya sayfa oluşturucu eklentisi uyumsuzluğu, önbellek	Önbelleği temizleyin, temayı kontrol edin
wp-admin açılıyor, ön yüz bozuk	Tema kaynaklı	Temayı varsayılana geçirin

Beyaz ekran ve kritik hata için ayrıntılı rehberlerimiz de var: WordPress beyaz ekran hatası ve WordPress kritik hata yazılarına bakabilirsiniz. Aşağıdaki adımlar bunların hepsini kapsayan genel bir akıştır.

WordPress kurtarma modu e-postası ne işe yarar?

WordPress 5.2 sürümünden beri ölümcül bir PHP hatası yakalandığında yönetici e-posta adresine bir bildirim ve gizli bir kurtarma bağlantısı gönderilir. Bu bağlantı, hataya neden olan eklenti ya da temayı yalnızca sizin tarayıcınız için duraklatır ve wp-admin'e girmenizi sağlar. Böylece panelden ilgili eklentiyi kapatabilirsiniz.

E-postayı bulamıyorsanız spam klasörüne bakın. Sitenin gönderdiği e-postalar çalışmıyorsa ya da yönetici adresi eskiyse bu yol işe yaramaz, o zaman dosya düzeyine inmeniz gerekir. Bu yazının geri kalanı dosya düzeyindeki çözümleri anlatır.

WordPress'in kendi geri alma korumaları da vardır, ama kapsamları dardır. WordPress 6.3'ten beri elle yapılan eklenti ve tema güncellemesi dosya kopyalama aşamasında başarısız olursa eski sürüm otomatik olarak yerine konur. WordPress 6.6'dan beri otomatik eklenti güncellemesi sonrasında ana sayfada ölümcül PHP hatası algılanırsa eklenti önceki sürüme döndürülür ve yöneticiye e-posta gider. Bunlar güncelleme sırasındaki hataları yakalar. Güncelleme tamamlandıktan sonra elle fark ettiğiniz çökmelerde, tema ya da sayfa düzeni bozulmalarında bu koruma devreye girmez. Yönetim ekranında da "önceki sürüme dön" düğmesi yoktur, bunun yöntemleri eklenti güncellemesini geri alma yazısında.

Eklenti çakışmasını nasıl bulursunuz?

Güncelleme sonrası bozulmaların çoğu bir eklentiden gelir. Panele giremiyorsanız FTP ya da hosting dosya yöneticisi üzerinden tüm eklentileri tek hamlede devre dışı bırakabilirsiniz: WordPress, wp-content/plugins klasörü bulunamazsa eklentileri yüklemez.

1FTP istemcisi (FileZilla gibi) ya da hosting panelinin dosya yöneticisiyle sitenin kök dizinine girin.
2wp-content içindeki plugins klasörünün adını plugins_devre_disi yapın.
3Siteyi ve /wp-admin adresini yenileyin. Açılıyorsa sorun eklentilerden birindedir.
4wp-admin'e girin ve Eklentiler sayfasını (plugins.php) bir kez açın. WordPress bu ekran yüklenirken dosyası bulunamayan eklentileri devre dışı bırakır ve üstte "eklenti, hata nedeniyle devre dışı bırakıldı" gibi bir bildirim gösterir. Bu bildirimi görmeden bir sonraki adıma geçmeyin.
5Ancak bundan sonra klasör adını tekrar plugins yapın. Eklentiler listede pasif durumda görünür.
6Eklentileri tek tek, her birinden sonra siteyi test ederek etkinleştirin. Siteyi bozan eklenti bulunduğunda durun.

Üçüncü adımı atlamayın

WordPress etkin eklentilerin listesini veritabanındaki active_plugins seçeneğinde tutar. Dosyası eksik olan eklentiler bu listeden yalnızca Eklentiler ekranı yüklendiğinde çıkarılır. Ekranı açmadan klasörü eski adına çevirirseniz liste hâlâ yerindedir, WordPress tüm eklentileri yeniden yükler ve site aynı hatayla yeniden çöker. wp-admin'e hiç girilemiyorsa aşağıdaki WP-CLI komutu bu adımın yerini tutar.

Tek tek denemeden hangi eklentinin suçlu olduğunu anlamak için isterseniz plugins klasörünün içindeki yalnızca şüpheli eklentinin klasörünü yeniden adlandırın. Güncelleme yaptığınız eklentiler bu liste için en güçlü adaydır. Etkin eklentilerin listesi veritabanındaki active_plugins seçeneğinde tutulur, ama dosya adı değiştirmek çoğu kullanıcı için daha güvenlidir.

WP-CLI erişiminiz varsa aynı işi komutla yapabilirsiniz:

wp plugin deactivate --all --skip-plugins
wp plugin activate eklenti-slug

--skip-plugins bayrağı önemlidir: bayrak olmadan WP-CLI da etkin eklentileri yükler ve bozuk eklenti komutun kendisini çökertebilir. Komut etkin eklenti listesini veritabanında temizlediği için klasörü yeniden adlandırmanız gerekmez.

Suçlu eklentiyi buldunuz mu? Önce eklentinin yeni sürümü hatayı düzeltmiş mi diye bakın. Düzeltme yoksa eklentiyi önceki sürüme döndürebilirsiniz, adımlar için WordPress eklenti güncellemesini geri alma yazısına bakın.

Sorun temadan geliyorsa ne yapılır?

Eklentileri kapatınca da düzelmiyorsa ya da wp-admin açık ama ön yüz bozuksa sıra temadadır. wp-admin'e girebiliyorsanız Görünüm, Temalar bölümünden varsayılan bir temayı (Twenty Twenty-Five gibi) etkinleştirin. Bu en kolay yoldur.

wp-admin'e girilemiyorsa wp-content/themes içinde şu an etkin olan temanın klasörünü yeniden adlandırın. WordPress etkin temayı bulamayınca kurulu varsayılan temaya geri düşer (bu yüzden varsayılan temalardan en az birinin sunucuda kurulu kaldığından emin olun). WP-CLI ile:

wp theme list
wp theme activate twentytwentyfive

Alt temayı olan siteler

Alt tema (child theme) kullanıyorsanız ana tema güncellenince alt temadaki kopyalanmış şablon dosyaları eski kalabilir. Bozulmanın nedeni çoğu zaman budur. Ana temanın güncelleme notlarında şablon dosyalarında değişiklik olup olmadığına bakın.

500 hatası veya yarım güncelleme için çekirdek dosyalar nasıl yeniden yüklenir?

Güncelleme sırasında bağlantı koptuysa ya da sunucu zaman aşımına uğradıysa çekirdek dosyalar yarım kalmış olabilir. Çekirdeği temiz kopyayla değiştirmek wp-content ve wp-config.php dosyalarını etkilemez, bu yüzden güvenlidir. Önce 500 hatası aldıysanız .htaccess dosyasını .htaccess_eski yapıp siteyi deneyin. Düzelirse wp-admin'de Ayarlar, Kalıcı Bağlantılar sayfasında Değişiklikleri Kaydet diyerek dosyayı yeniden oluşturun.

WP-CLI ile aynı sürümü yeniden indirip dosyaların üzerine yazabilirsiniz:

wp core verify-checksums
wp core download --force --skip-content

verify-checksums komutu, çekirdek dosyalarını WordPress.org'daki resmi sağlama toplamlarıyla karşılaştırır ve değişmiş ya da eksik dosyaları listeler. --skip-content varsayılan tema ve eklentileri indirmez, --force mevcut dosyaların üzerine yazar. WP-CLI yoksa wordpress.org/download adresinden aynı sürümü indirip wp-admin ve wp-includes klasörleriyle kök dizindeki dosyaları yükleyebilirsiniz, wp-content ve wp-config.php dosyalarına dokunmayın.

Bellek ve zaman aşımı sorunlarında wp-config.php içine define( 'WP_MEMORY_LIMIT', '256M' ); eklemek ve hata ayrıntısını görmek için WP_DEBUG_LOG açmak işe yarar. Hata ayıklama için WP_DEBUG ayarlarını inceleyin.

Hiçbiri işe yaramazsa yedekten nasıl dönülür?

Dosya düzeyindeki çözümler sonuç vermezse ya da veritabanı güncellemesi sırasında bozulma olduysa son sağlam yedeğe dönmek en güvenli yoldur. Yedek, güncellemeden önce alınmış olmalıdır. Güncellemeden sonra alınan yedek zaten bozuk durumu içerir.

Hosting panelinizin otomatik yedeklerine bakın (cPanel Backup, Plesk, hosting sağlayıcının anlık görüntüleri).
Kendi eklentinizle aldığınız yedeği geri yükleyin. Süreç ayrıntıları için WordPress yedek geri yükleme rehberine göz atın.
Yalnızca bozulan eklenti ya da tema için, tüm siteyi geri yüklemeden o klasörü yedekten kopyalamak daha az kayba yol açar.

Geri yüklemeden önce mevcut bozuk durumun da bir kopyasını alın. Güncellemeden sonra gelen siparişler, yorumlar ya da yeni yazılar yedeğe dönünce kaybolur. WooCommerce gibi canlı veri alan sitelerde bu önemlidir. Yedek alma alışkanlığı için güncelleme öncesi yedek yazısına bakın.

Aynı sorun tekrar yaşanmasın diye ne yapılmalı?

Güncelleme kaynaklı bozulmaların çoğu, her şeyi aynı anda ve yedeksiz güncellemekten çıkar. Birkaç alışkanlık riski ciddi biçimde azaltır:

Güncellemeden hemen önce tam yedek alın ve yedeğin gerçekten oluştuğunu kontrol edin.
Önce çekirdeği, sonra eklentileri, en son temayı güncelleyin. Her adımdan sonra siteyi açıp kontrol edin. Toplu güncelleme zamanı kazandırır ama hata ayıklamayı zorlaştırır.
Kritik sayfaları (ana sayfa, ödeme, form) güncellemeden sonra hızlıca açın.
Büyük sürüm atlamalarını (örneğin eklentinin ana sürümü değişiyorsa) önce bir test kopyasında deneyin.
Eklenti sürüm notlarını okuyun, özellikle "breaking change" geçen satırlara bakın.

Güncelleme sırasını ve hazırlık adımlarını WordPress güncelleme rehberinde adım adım bulabilirsiniz.

Güncellemeyi yedekli yapın, gerekirse tek tıkla geri alın

Watch Your WP'de Güvenli güncelle, güncellemeyi uygulamadan önce yedek alır. Sorun çıkarsa tek tıkla sürüm geri alma, eklenti ya da temanın dosyalarını önceki sürüme çeker (veritabanına dokunmaz). Sürüm kilitleme ile sorunlu bir eklentiyi toplu güncellemelerin dışında tutabilirsiniz. Ücretsiz katman sınırsız sitede çalışır.

Güvenli güncelleme özelliğine bak

Sık sorulan sorular

Güncelleme sonrası sadece ana sayfa bozuk, diğer sayfalar çalışıyor, neden?

Ana sayfa genellikle sayfa oluşturucu, slider ya da özel şablon kullandığından en çok eklenti içerir. Önbellek eklentinizi ve CDN önbelleğini temizleyin, sonra sayfa oluşturucunun güncel olduğunu kontrol edin. Düzelmezse eklentileri tek tek kapatarak bozulmayı yaratanı arayın.

Eklentileri devre dışı bırakınca ayarlarım silinir mi?

Hayır. Eklenti ayarları veritabanında durur ve devre dışı bırakmak onları silmez. Silme yalnızca eklentiyi panelden "Sil" ile kaldırdığınızda ve eklenti kendi temizlik işlevini çalıştırıyorsa olur. Klasörü yeniden adlandırmak sadece eklentiyi pasif yapar.

Sorunlu güncellemeyi geri almak için veritabanını da geri yüklemem gerekir mi?

Güncelleme veritabanı tablolarını değiştirdiyse evet, dosyaları geri almak tek başına yetmeyebilir. Ayrıntılı değerlendirme için eklenti geri alma yazısına, çekirdek için eski sürüme döndürme yazısına bakın.

Site "planlanmış bakım" ekranında takıldıysa ne yapmalıyım?

Bu, güncelleme yarıda kalınca kök dizinde kalan gizli .maintenance dosyasından kaynaklanır. Dosyayı silmek siteyi açar, ardından güncellemeyi tamamlamak gerekir. Adımlar için planlanmış bakım hatası yazısına bakın.

Ücretsiz araç: sitenizi kontrol edin

Sitenizin SSL süresini, WordPress sürümünü, güvenlik başlıklarını ve yanıt süresini kayıt olmadan saniyeler içinde görün: ücretsiz WordPress site kontrolü.

Paylaş

Erdinç

Watch Your WP'yi geliştiriyor. WordPress bakım, güvenlik ve site yönetimi deneyiminden yazıyor.