WordPress Eklenti Güncelleme Hatası: Geri Alma ve Çözüm
Yapay zeka destekli taslak; yayından önce baştan sona okunur ve iddialar birincil kaynaklara karşı kontrol edilir. İçerik üretim sürecimiz

WordPress eklenti güncelleme hatası, bir eklentinin yeni sürümünün indirilemediği, kurulamadığı ya da kurulduktan sonra siteyi ölümcül bir PHP hatasıyla durdurduğu durumdur. WordPress 6.3'ten beri elle yapılan güncelleme başarısız olursa önceki sürüm kendiliğinden yerine konur; 6.6'dan beri otomatik güncelleme ana sayfada ölümcül hata yaratırsa eklenti eski sürümüne döndürülür ve yönetici e-postasına bildirim gider.
Aşağıdaki işleyiş, WordPress'in geliştirici notlarından ve komut satırı belgesinden 14 Kasım 2026'da okundu. Çekirdeğin yakalamadığı durumlar için elle geri alma yolları ayrıca yazıldı.
WordPress eklenti güncelleme hatası hangi biçimlerde görünür?
Eklenti güncelleme hatası tek bir mesaj değil, güncellemenin hangi aşamada kırıldığına göre değişen bir belirti ailesidir. Güncelleme üç aşamadan geçer: paket indirilir, eski sürüm kenara alınıp yeni dosyalar yerine yazılır, eklenti yeniden etkinleştirilir. Kırılma bu üç noktadan birinde olur ve her biri farklı bir iz bırakır.
| Kırılma noktası | Site sahibinin gördüğü | Sitenin durumu |
|---|---|---|
| İndirme ya da paket açma | Güncellemeler ekranında başarısızlık mesajı | Eski sürüm çalışmaya devam eder |
| Dosyaların yerine yazılması | Klasör oluşturulamadı ya da taşınamadı türünde bir hata | 6.3 ve sonrasında eski sürüm geri konur |
| Yeniden etkinleştirme | Kritik hata mesajı ya da boş sayfa | Elle güncellemede eklenti kapalı kalır, otomatikte geri alınır |
| Güncelleme başarılı, işlev bozuk | Hiçbir hata mesajı yok; form, sepet ya da düzen çalışmıyor | Çekirdek bunu fark etmez |
Tablo, aşağıda kaynaklarıyla anlatılan çekirdek davranışının bu yazıdaki özetidir. Son satır en sinsi olanıdır: WordPress'in koruma mekanizmaları PHP'nin ölümcül hatasına bakar, bir iletişim formunun e-posta göndermeyi bırakmasına bakmaz.
Hatanın biçimini doğru adlandırmak ilk iştir. Panelde bir mesaj okunabiliyorsa site ayaktadır ve sorun güncellemenin kendisindedir. Ön yüz tamamen boş ya da "kritik hata" yazıyorsa sorun artık bir site kesintisidir; bu durumda teşhis sırası WordPress beyaz ekran hatası yaşayan bir siteyle aynıdır ve önce sitenin açılması sağlanır.
Elle güncelleme başarısız olursa WordPress ne yapar?
WordPress 6.3'ten beri panelden elle başlatılan bir eklenti ya da tema güncellemesi yarıda kalırsa çekirdek önceki sürümü kendiliğinden geri yükler. WordPress çekirdek ekibinin 6.3 geri alma geliştirici notu mekanizmayı adım adım veriyor: güncelleme başlarken eklentinin eski sürümü wp-content/upgrade-temp-backup/plugins/ altına, eklentinin adını taşıyan bir klasöre taşınır. Güncelleme başarısız olursa bu kopya eski yerine geri konur; başarılı olursa silinir.
Notun saydığı başarısızlık türleri, hangi hataların bu korumayı tetiklediğini gösteriyor:
- güncelleme isteğinin kendisinin bozuk olması, kaynağın ya da hedefin eksik olması,
- indirilen paketin boş gelmesi,
- eski sürümün geçici yedek klasörüne taşınamaması,
- hedef klasörün temizlenememesi ya da yeniden oluşturulamaması,
- yeni sürümün hedefe taşınamaması ya da kopyalanamaması,
- güncelleme sırasında çalışan filtrelerden birinin hata döndürmesi.
Not, geri alma gerçekleştiğinde kullanıcının yalnızca bekleyen bir güncelleme görmesini ve sitenin çalışmaya devam etmesini beklenen sonuç olarak yazıyor. Yani elle yapılan güncelleme sessizce başarısız olduğunda panelde aynı eklenti için "güncelleme var" bildirimi kalır.
Aynı notun iki ayrıntısı uygulamada önem taşır. Birincisi, Site Sağlığı ekranına iki yeni kontrol eklendi: yedek klasörlerinin yazılabilir olup olmadığı ve güncellemeyi güvenle yapacak kadar disk alanı bulunup bulunmadığı. Disk kotası dolmuş bir barındırma hesabında güncellemeler bu yüzden başarısız olabilir ve ilk bakılacak yer Site Sağlığı'dır. İkincisi, upgrade-temp-backup klasörü başarılı bir güncellemeden sonra eski sürüme dönmek için kullanılmaz; not bunu açıkça yazıyor ve klasörün güncelleme biter bitmez boşaltıldığını söylüyor. Başarılı ama sorunlu bir güncellemeden geri dönmenin yolu aşağıda ayrıca anlatıldı.
Otomatik güncellemede ölümcül hata olursa ne olur?
WordPress 6.6'dan beri otomatik eklenti güncellemesi ölümcül bir PHP hatasına yol açarsa çekirdek eklentinin önceki sürümünü geri yükler. WordPress çekirdek ekibinin 6.6 alan rehberi, ölümcül hata algılandığında otomatik güncellemelerin geri alınmasını sürümün öne çıkan özelliklerinden biri olarak sayıyor ve ayrıntı için birleştirme önerisine yönlendiriyor.
Bu ayrımın nedeni, elle ve otomatik güncellemenin farklı yollardan yürümesi. Otomatik güncellemede geri alma önerisi sorunu şöyle tarif ediyor: etkin eklentiler güncellenirken kısa süre devre dışı bırakılır, yeni sürüm kurulur ve hemen yeniden etkinleştirilir. 6.3'ten beri elle güncellemede yeni sürüm ölümcül hata veriyorsa eklenti yeniden etkinleştirilmez. Otomatik güncellemede ise bu kontrol yapılmıyordu ve site bir sonraki açılışta boş beyaz ekranla karşılaşabiliyordu.
Belgede yazılı işleyiş beş parçadan oluşuyor:
- Güncellemeden sonra WordPress kendi ana sayfasına bir geri döngü isteği (loopback) gönderir ve ölümcül PHP hatası olup olmadığına bakar; yöntem eklenti ve tema dosya düzenleyicilerinin kullandığı yönteme benzer.
- Geri döngü isteği hata dönerse etkin eklentide ölümcül hata olduğu varsayılır, hata mesajı kayda geçer ve önceki sürüm geri yüklenir.
- Sitenin
admin_emailayarında kayıtlı yönetici adresine başarısız güncellemeyi ve geri almayı bildiren bir e-posta gider. - Sorunlu eklenti geri alındıktan sonra sırada bekleyen çekirdek, eklenti ya da tema güncellemeleri devam eder.
- Otomatik güncellemenin bir sonraki kontrolünde WordPress aynı eklentiyi yeniden güncellemeyi dener.
Öneri bir değişikliği daha yazıyor: önceden bakım modu yalnız paketin kurulumu sırasında açıktı; geri alma özelliğiyle birlikte otomatik güncellemenin tamamı boyunca açık tutuluyor. Gerekçe, süreç sırasında gelen ziyaretlerin hata tetikleyip eklentilerin devre dışı kalması gibi yan etkilere yol açabilmesi. Bakım modu süresi uzamış olsa da bu, aynı anda yapılan güncelleme sayısıyla orantılıdır. Bakım ekranının arkasındaki .maintenance dosyasını ve on dakika kuralını kaynak koddan çıkaran WordPress bakım modu incelemesi bu işleyişi tamamlar; o ayrıntı burada tekrar edilmiyor.
Otomatik geri almanın yakalamadığı hatalar
Otomatik geri alma yalnız ölümcül PHP hatasına karşı bir emniyet kemeridir; bir güncellemenin yarattığı her sorunu yakalamaz. Önerideki tarif kontrolün kapsamını da belirliyor: istek ana sayfaya gönderiliyor ve aranan şey ölümcül hata. Bu tarif okununca dışarıda kalan durumlar kendiliğinden çıkar:
- Yalnız belirli sayfada patlayan hata. Ana sayfa açılıyor ama ödeme sayfası, bir ürün sayfası ya da yönetim panelindeki bir ayar ekranı hata veriyorsa geri döngü isteği bunu görmez. Bu bir çıkarımdır; belge kontrolün ana sayfaya yapıldığını yazıyor, diğer sayfalar için bir şey söylemiyor.
- Ölümcül olmayan bozulma. Düzenin kayması, bir kısa kodun ham metin olarak görünmesi, formun gönderildiği hâlde e-postanın gelmemesi PHP'nin ölümcül hatası değildir.
- Başka bir eklentiyle çakışma. Güncellenen eklenti tek başına sağlam ama sitedeki başka bir eklentiyle birlikte çalışırken hata veriyorsa sonuç, çakışmanın ana sayfada görünüp görünmemesine bağlıdır.
- Elle güncellemede yeniden etkinleştirme dışındaki hatalar. Elle güncelleme başarılı sayıldıysa 6.3'ün geçici yedeği silinmiştir; sonradan fark edilen bozulmada geri dönüş elle yapılır.
- Veritabanı değişikliği. Bazı eklentiler yeni sürümde veritabanı tablolarını dönüştürür. Dosyaların eski sürüme dönmesi veritabanını geri almaz. Bu da bir çıkarımdır ve eklentiye göre değişir; eklentinin sürüm notları ayrıca okunmalıdır.
Bu boşluklar otomatik güncellemeyi kapatmak için bir gerekçe değildir. Yamanın gecikmeden gelmesi ile bozulmanın erken fark edilmesi birbirini dışlamaz; sorun, geri almanın olduğu yerde işin bittiği sanıldığında çıkar. Hangi eklentide otomatik güncellemenin açık kalacağına, WordPress güvenlik önlemleri arasındaki eklenti envanteri karar verir.
Hata mesajı hangi katmanı gösterir?
Güncelleme ekranındaki hata mesajı, sorunun ağda mı, diskte mi yoksa eklentinin kodunda mı olduğunu gösterir. Mesajın tam metni WordPress sürümüne ve site diline göre değişebildiği için aşağıdaki tablo mesajları kelimesi kelimesine değil anlam olarak gruplandırıyor:
| Mesajın anlamı | Olası katman | İlk kontrol |
|---|---|---|
| Paket indirilemedi, bağlantı zaman aşımına uğradı | Ağ ya da kaynak | Birkaç dakika sonra yeniden denemek; ücretli eklentide lisans anahtarının geçerliliği |
| Paket boş ya da açılamadı | Kaynak ya da disk | Disk alanı ve geçici klasörün yazılabilirliği |
| Klasör oluşturulamadı, taşınamadı, kopyalanamadı | Dosya izinleri ya da disk | Site Sağlığı'ndaki yazılabilirlik ve disk alanı kontrolleri |
| Hedef klasör zaten var | Yarım kalmış önceki güncelleme | wp-content/plugins içinde aynı eklentinin iki kopyası olup olmadığı |
| Güncelleme tamamlandı, ardından kritik hata | Eklentinin kodu ya da sunucu sürümü | Eklentinin istediği PHP sürümü ve hata kaydı |
Tablonun gruplaması bu yazının önerisidir; belgede yazılı olan, 6.3 notunun saydığı başarısızlık türleridir. Son satırdaki "sunucu sürümü" ihtimali ayrı bir soru açar: eklentinin yeni sürümü daha yeni bir PHP istiyorsa hata kodda değil sunucudadır.
Ücretli eklentilerde ilk satır ayrı bir ihtimal taşır: bu eklentilerin güncellemesi WordPress.org yerine satıcının sunucusundan gelir ve satıcı, lisansı sona ermiş bir siteye indirme vermeyebilir. Bu davranış satıcıdan satıcıya değişir; lisansın durumu satıcının kendi panelinden doğrulanır.
Eklentinin istediği PHP ve WordPress sürümü
Her eklenti, çalışabildiği en düşük WordPress ve PHP sürümünü kendi başlık bilgisinde bildirebilir; güncelleme hatasının bir kısmı bu iki satırdan gelir. WordPress'in eklenti başlık gereksinimleri iki alanı tanımlıyor: Requires at least eklentinin çalışacağı en düşük WordPress sürümü, Requires PHP ise gereken en düşük PHP sürümü.
Bu alanlar süs değildir. WP-CLI'nin wp plugin install komutu bunları atlamak için ayrı bir seçenek sunuyor: --ignore-requirements verildiğinde komut, eklenti yazarlarının belirttiği WordPress ya da PHP sürüm gereksinimlerini yok sayarak kurulum yapar. Böyle bir seçeneğin bulunması, gereksinimlerin varsayılan olarak denetlendiğini gösteriyor. Bu seçenek bir çözüm değildir; gereksinimi karşılamayan bir sunucuya zorla kurulan eklenti tam da kritik hatanın kaynağı olabilir.
Pratik sonuç şu: eklentinin yeni sürümü sunucunuzun PHP sürümünden yüksek bir sürüm istiyorsa güncellemeyi zorlamak yerine sunucu tarafı ele alınır. Bu durumda iş eklentide değil sunucudadır ve bir WordPress PHP sürümü güncelleme planı gerektirir: mevcut sürüm okunur, hedef sürüm seçilir, geçiş önce test kopyasında denenir. Ters durum da yaşanır: barındırma firması PHP'yi yükseltir ve uzun süredir güncellenmemiş bir eklenti yeni sürümle çalışmaz. İki durumda da hata eklenti güncellemesinin ekranında görünür ama çözümü eklentide değildir. Sürüm gereksinimini karşılamayan bir sitede WordPress iletişim formu eklentisinin yeni sürümü de varsayılan denetime takılır ve form eski sürümde kalır.
Başarılı ama sorunlu güncellemeyi elle geri almak
Güncelleme başarılı sayıldı ama site ya da bir işlev bozulduysa, eklentiyi önceki sürümüne döndürmenin üç yolu vardır ve hangisinin seçileceği yönetim paneline erişilip erişilemediğine bağlıdır.
Komut satırı erişimi varsa: WP-CLI belgesine göre wp plugin install komutunun --version=<sürüm> seçeneği, kararlı sürüm yerine WordPress.org'dan belirtilen sürümü indirir; --force seçeneği ise kurulu sürümün üzerine onay sormadan yazar. İkisi birlikte kullanıldığında komut şu biçimi alır:
wp plugin install eklenti-adi --version=1.2.3 --force
Burada eklenti-adi eklentinin WordPress.org'daki kısa adı, 1.2.3 ise sorunsuz çalışan son sürümdür. Bu yol yalnız WordPress.org dizinindeki eklentiler için geçerlidir; ücretli eklentinin eski sürümü satıcının indirme alanından alınır.
Panele girilebiliyor ama komut satırı yoksa: bozulmaya yol açan eklenti önce devre dışı bırakılır ve sitenin düzeldiği doğrulanır. Eski sürüme dönmek için eklentinin önceki sürümünün paketi gerekir; panelden geri alma için ek bir eklenti kurmak da bir seçenektir ama kurulan her eklenti yeni bir bileşen ve yeni bir bakım yükü demektir.
Panele girilemiyorsa: eklentinin klasörünün adı FTP ya da dosya yöneticisiyle değiştirilerek WordPress'in onu yüklemesi durdurulur. Klasör adını değiştirme adımı panik anında aranmamalı, güncellemeden önce yazılan geri dönüş planında hazır durmalıdır; WordPress güncellemesi yapılmazsa ne olur sorusu da sonunda aynı plana çıkar.
Üç yolda da eski sürüme dönüş geçici bir ara adımdır. Eski sürüm, yeni sürümün kapattığı bir güvenlik açığını taşıyor olabilir; geri alma kararı bu yüzden sürüm notları okunarak verilir. Güncelleme bir güvenlik yaması içeriyorsa eski sürümde uzun süre kalmak, bozuk bir düzenden daha büyük bir risk olabilir.
Veritabanını da değiştiren bir eklentide dosyaları geri almak yetmeyebilir; o durumda güncelleme öncesi alınmış tam yedeğe dönmek gerekir. Bunun için yedeğin hem alınmış hem de daha önce bir kez geri yüklemesi denenmiş WordPress yedeği olması şarttır.
Geri almadan sonra yapılacaklar
Geri alma siteyi ayağa kaldırır ama hatanın nedeni yerinde durur. Otomatik geri alma önerisine göre WordPress bir sonraki otomatik güncelleme kontrolünde aynı eklentiyi yeniden güncellemeyi dener; neden giderilmediyse aynı döngü tekrar yaşanır. Bu yüzden geri almanın ardından şu sıra izlenir:
- Bildirim e-postası okunur. Önerideki örnek e-postaya göre metin, güncellenemeyen eklentiyi ve hangi sürümden hangisine geçilmeye çalışıldığını listeler. Bu iki sürüm numarası kayda geçer.
- O eklentinin otomatik güncellemesi geçici olarak kapatılır. Eklentiler ekranındaki "Otomatik güncelleme" sütunundan eklenti bazında kapatılabilir; amaç neden bulunana kadar döngüyü durdurmaktır.
- Hata kaydı okunur. Geri döngü isteğinin yakaladığı hata mesajı kayda geçirilir; sunucunun PHP hata kaydı da aynı saat aralığı için incelenir.
- Neden ayrılır. Hata eklentinin kodundaysa geliştiriciye sürüm numarası ve hata mesajıyla bildirilir; PHP sürümü uyumsuzluğundaysa sunucu tarafı ele alınır; başka bir eklentiyle çakışmaysa iki eklenti bir test kopyasında birlikte denenir.
- Düzeltme sürümü test kopyasında denenir. Geliştirici yeni bir sürüm yayımladığında güncelleme önce test kopyasında yapılır, ana sayfanın yanında ödeme ve form akışları da denenir.
- Otomatik güncelleme yeniden açılır. Sorun kapandığında eklenti eski düzenine döner ve kayıt kapatılır.
İkinci adımın unutulması, sorunun her gün iki kez yeniden denenmesine yol açabilir. WordPress'in otomatik güncellemeleri varsayılan olarak günde iki kez çalıştırdığı, eklenti ve tema otomatik güncelleme belgesinde yazıyor.
Güncelleme hatasının olasılığını düşüren düzen
Güncelleme hatası tamamen önlenemez ama olasılığı ve kesinti süresi düşürülebilir; bunun yolu güncellemeyi yayındaki sitede ilk kez denememektir. Aşağıdaki sıra, çekirdeğin geri alma mekanizmalarının üstüne eklenen bir çalışma düzenidir:
| Aşama | Ne yapılır | Neyi önler |
|---|---|---|
| Güncellemeden önce | Tam yedek alınır, disk alanı ve Site Sağlığı kontrol edilir | Disk kaynaklı başarısızlık, geri dönüşsüz bozulma |
| Test kopyasında | Güncelleme önce kopyada yapılır, ana şablonlar ve formlar denenir | Ana sayfa dışındaki sayfalarda patlayan hata |
| Yayında | Eklentiler tek tek güncellenir, toplu güncellemeden kaçınılır | Hangi eklentinin bozduğunun bulunamaması |
| Hemen sonra | Ana sayfa, ödeme ve form akışı denenir, hız ölçülür | Ölümcül olmayan bozulmanın günlerce fark edilmemesi |
| Kayıt | Sürüm numaraları ve sonuç yazılır | Aynı hatanın bir sonraki sürümde tekrar yaşanması |
Tek tek güncelleme kuralının gerekçesi basittir: on eklenti aynı anda güncellendiğinde bozulmanın hangisinden geldiğini bulmak için hepsinin yeniden denenmesi gerekir. Güncellemeden sonra site açılıyor ama yavaşladıysa ölçüm sırası WordPress site yavaş açılıyor belirtisinde izlenen sıranın aynısıdır; eklentiler tek tek kapatılarak yavaşlığın hangi bileşenden geldiği ölçülür.
Bu düzenin bir işletme sitesinde düzenli yürümesi, güncellemenin bir kişinin takviminde durmasına bağlıdır. Web sitesi bakım hizmetinin güncelleme kalemi bu sırayı izler: güncelleme önce bir test kopyasında denenir, her güncellemeden önce yedek alınır ve bir güncelleme bir sayfayı bozduğunda geri dönüş yolu hazır tutulur.
Geri alma mekanizmaları olduğu için güncellemeyi gelişigüzel yapmak, emniyet kemeri takılı diye hızı artırmaya benzer. Çekirdeğin koruduğu alan dar ve iyi tanımlı: ölümcül hata ile yarım kalmış dosya. Bu alanın dışında kalan her şeyi test kopyası, yedek ve kayıt korur.
Sıkça Sorulan Sorular
WordPress eklenti güncellemesi başarısız olursa site bozulur mu?
Elle başlatılan güncelleme dosyalar yerine yazılırken başarısız olursa WordPress 6.3'ten beri eklentinin önceki sürümü geri konur ve site çalışmaya devam eder. Panelde aynı eklenti için bekleyen güncelleme görünür. Otomatik güncelleme ana sayfada ölümcül PHP hatası yaratırsa 6.6'dan beri eklenti geri alınır. Güncelleme başarılı sayılıp yalnız bir sayfa ya da form bozulduysa çekirdek bunu fark etmez.
Eklenti otomatik olarak geri alındığında nasıl haberim olur?
WordPress, sitenin ayarlarında kayıtlı yönetici e-posta adresine başarısız güncellemeyi ve geri almayı bildiren bir e-posta gönderir. E-postada güncellenemeyen eklenti ve denenen sürüm geçişi listelenir. Bu adres yıllar önce siteyi kuran kişiye aitse bildirim kimseye ulaşmaz. Bu yüzden Ayarlar ekranındaki yönetici e-posta adresinin bugün okunan bir kutuya gittiği kontrol edilmelidir.
Eklentiyi eski sürümüne nasıl döndürürüm?
Komut satırı erişimi varsa WP-CLI ile eklentinin kısa adı, istenen sürüm numarası ve üzerine yazma seçeneği verilerek WordPress.org'daki eski sürüm kurulabilir. Panel açıksa sorunlu eklenti önce devre dışı bırakılır, sonra önceki sürümün paketiyle değiştirilir. Panel açılmıyorsa eklenti klasörünün adı FTP ile değiştirilir. Eski sürüm bir güvenlik açığı taşıyabileceği için bu geçici bir adımdır.
Geri alınan eklenti yeniden güncellenmeye çalışılır mı?
Evet. WordPress'in otomatik güncellemede geri alma önerisine göre sorunlu eklenti geri alındıktan sonra, otomatik güncellemenin bir sonraki kontrolünde aynı eklenti yeniden güncellenmeye çalışılır. Hatanın nedeni giderilmediyse döngü tekrar eder. Neden bulunana kadar o eklentinin otomatik güncellemesi Eklentiler ekranındaki sütundan eklenti bazında geçici olarak kapatılabilir.
Eklenti güncellemesi neden "klasör oluşturulamadı" hatası verir?
Bu tür mesajlar, WordPress'in eski sürümü geçici yedek klasörüne taşıyamadığını ya da yeni dosyaları hedefe yazamadığını gösterir. Olası nedenler dolmuş disk kotası ve yazma izni olmayan klasörlerdir. WordPress 6.3 ile Site Sağlığı ekranına yedek klasörlerinin yazılabilirliğini ve güncelleme için yeterli disk alanını denetleyen iki kontrol eklendi; ilk bakılacak yer orasıdır.