.maintenance dosyasından çıkar. FTP ya da dosya yöneticisinde bu dosyayı silin ya da SSH'ta wp maintenance-mode deactivate komutunu çalıştırın. Sonra yarım kalan güncellemeyi doğrulayıp tamamlayın.Eklenti ya da WordPress güncellerken sayfayı kapattınız, bağlantınız koptu veya sunucu yanıt vermedi. Ardından sitenize girince "Planlanmış bakım nedeniyle kısa süreliğine kullanılamıyor" mesajından başka bir şey görmüyorsunuz ve ekran dakikalar sonra bile değişmiyor. WordPress planlanmış bakım hatası, nadir ama çözümü genellikle kolay bir durumdur. Bu yazıda neden olduğunu, dosyayı nasıl sileceğinizi ve silmekle işin bitmediğini anlatıyoruz.
WordPress neden "planlanmış bakım" ekranında takılır?
WordPress bir güncelleme başlatınca sitenin kök dizinine .maintenance adında gizli bir dosya yazar ve ziyaretçilere bakım ekranını gösterir. Güncelleme bitince dosyayı kendisi siler. İşlem yarıda kesilirse (tarayıcı kapandı, PHP zaman aşımı, bellek bitti, sunucu yeniden başladı) silme adımına hiç gelinmez ve dosya orada kalır.
Dosyanın içinde güncellemenin başladığı zamanı gösteren küçük bir PHP satırı vardır. WordPress bu zaman damgasına bakar ve genellikle yaklaşık on dakika sonra dosyayı eski kabul edip bakım ekranını göstermeyi bırakır. Yani bazen bekleyince kendiliğinden düzelir, ama beklemek garanti değildir, dosyayı elle silmek en hızlı çözümdür.
.maintenance dosyası nasıl silinir?
Dosya sitenin kök dizinindedir, yani wp-config.php ve wp-content ile aynı yerde. Başında nokta olduğu için çoğu program varsayılan olarak gizli tutar.
- 1FTP istemcisiyle (FileZilla gibi) ya da hosting panelinin dosya yöneticisiyle (cPanel Dosya Yöneticisi gibi) bağlanın.
- 2Kök dizine gidin (genellikle
public_htmlya da WordPress'in kurulu olduğu klasör). - 3Gizli dosyaları gösterin. FileZilla'da Sunucu menüsünden "Gizli dosyaları zorla göster", cPanel'de Ayarlar'da "Gizli dosyaları göster" seçeneğini açın.
- 4
.maintenancedosyasını bulup silin. - 5Siteyi yenileyin. Tarayıcı önbelleğini atlamak için
Ctrl+F5kullanın.
wp-config.php dosyasının bulunduğu klasöre bakın.WP-CLI ile bakım modu nasıl kapatılır?
SSH erişiminiz varsa WP-CLI'ın maintenance-mode komutu aynı işi tek satırda yapar. Komutun dört alt komutu vardır: activate, deactivate, status ve is-active.
wp maintenance-mode status
wp maintenance-mode deactivateİlk komut bakım modunun açık olup olmadığını gösterir, ikincisi kapatır. Komutu WordPress kök dizininde çalıştırın ya da --path=/yol/public_html verin. Dosyayı elle silmekle aynı sonucu verir. Betik ve otomasyonlarda is-active çıkış koduyla bakım durumunu sorgulamak için kullanılır.
Dosyayı sildikten sonra güncelleme tamamlandı mı, nasıl doğrulanır?
Sitenin açılması güncellemenin sağlıklı bittiği anlamına gelmez. Yarım kalan güncelleme dosyaları eksik ya da bozuk bırakabilir. Siteyi açtıktan sonra şunları kontrol edin:
- wp-admin, Güncellemeler sayfasında hâlâ bekleyen güncelleme var mı? Varsa yeniden başlatın, bu kez sekmeyi kapatmadan.
- Eklentiler sayfasında ilgili eklentinin sürümü beklediğiniz numarada mı, eklenti etkin mi?
- Çekirdek güncelleme kesilmişse
wp core verify-checksumsile dosyaların resmi sağlama toplamlarıyla uyumunu denetleyin. Fark çıkarsawp core download --force --skip-contentile çekirdek dosyalarını yeniden yazın. - Çekirdek güncellemesinde veritabanı yükseltmesi isteniyorsa tamamlayın.
- Kritik sayfaları ve formları test edin, PHP hata günlüğüne bakın.
Güncelleme sonrasında site hata veriyorsa teşhis akışı için güncelleme sonrası site bozuldu yazısına geçin. Beyaz ekran görüyorsanız beyaz ekran hatası rehberi işinize yarar. Çekirdek dosyaları bozulduysa ve düzeltilemiyorsa yedekten dönmek de bir seçenektir, bkz. yedek geri yükleme.
Güncelleme neden yarıda kesilir?
Bakım ekranında takılmanın altında genellikle şu nedenlerden biri yatar. Sebebi bilmek aynı durumun tekrarını önler.
| Neden | Belirti | Çözüm |
|---|---|---|
| PHP zaman aşımı (max_execution_time) | Büyük güncellemelerde yarıda kalır | Süreyi artırın, güncellemeleri tek tek yapın |
| Bellek yetersizliği | Fatal error: allowed memory size | WP_MEMORY_LIMIT'i artırın |
| Sekmenin ya da bağlantının kapanması | Güncelleme sırasında internet kesildi | Güncellemeyi bitene kadar sayfada bekleyin |
| Çok sayıda eklentiyi aynı anda güncellemek | Toplu güncellemede ortada kalma | Daha küçük gruplar halinde güncelleyin |
| Disk dolu ya da yazma izni yok | Dosya yazılamıyor | Disk kotası ve dosya izinlerini kontrol edin |
| Sunucu yeniden başlaması ya da hosting kesintisi | Rastgele zamanlı | Hosting kayıtlarına bakın |
Bellek ve süre sınırlarını artırmak için wp-config.php dosyasına define( 'WP_MEMORY_LIMIT', '256M' ); ekleyebilirsiniz, max_execution_time ise php.ini ya da hosting panelindeki PHP ayarlarından değişir. Hata ayrıntısını görmek için hata ayıklama günlüğünü açabilirsiniz, bkz. WP_DEBUG rehberi.
Zaman aşımı ve bellek sorunlarını ayırt etmek için hata günlüğü işe yarar. wp-config.php dosyasında WP_DEBUG_LOG açıksa hatalar wp-content/debug.log dosyasına yazılır. "Maximum execution time exceeded" süreyle, "Allowed memory size exhausted" bellekle ilgilidir. Hosting kullanıyorsanız panelden PHP hata günlüğüne de bakabilirsiniz. Paylaşımlı hostinglerde bu sınırları siz değiştiremiyorsanız destek ekibinden artırmasını isteyin.
Bir eklentinin güncellemesi sırasında kesilme olduysa, eklentinin klasörü yarım dosyalarla kalmış olabilir. Bu durumda eklentiyi panelden silip yeniden kurmak (ayarları veritabanında kaldığı için çoğu zaman korunur) ya da wp plugin install eklenti-slug --force komutuyla üzerine yazmak sorunu çözer. Eklentiyi silmeden önce kendi eklenti klasörünüzün yedeğini alın, eklentiye elle eklenmiş dosyalar varsa kaybolmasın.
Bu hatayı tekrar yaşamamak için ne yapmalı?
- Güncelleme sırasında sekmeyi kapatmayın, bilgisayarı uyutmayın.
- Eklentileri toplu halde değil, küçük gruplar halinde güncelleyin. Çok büyük eklentileri (WooCommerce, sayfa oluşturucular) tek başına güncelleyin.
- Güncellemeden önce tam yedek alın. Bu, güncelleme tamamen bozulursa dönüş yolunuzdur, bkz. güncelleme öncesi yedek.
- Hosting bellek ve süre sınırlarının yeterli olduğundan emin olun.
- Genel güncelleme düzeni için WordPress güncelleme rehberine bakın.
Güncellemeyi kesintiye karşı güvenceye alın
Watch Your WP'de Güvenli güncelle, güncellemeyi uygulamadan önce yedek alır. Güncelleme sorun çıkarırsa tek tıkla sürüm geri alma eklenti ya da temanın dosyalarını önceki sürüme çeker, bakım ekranında takılan bir siteyi kurtarmanız için elinizde bir yedek olur. Birden fazla siteyi tek ekrandan güncelleyip durumlarını izleyebilirsiniz.
Tekrar eden bir durumda, bakım ekranının her güncellemede çıkması hosting ortamında bir kaynak sorunu olduğunu gösterir. O zaman tek seferlik çözüm yerine hosting planını, PHP sürümünü ve bellek sınırını gözden geçirmek gerekir. Sıkça aynı yerde takılan bir güncelleme varsa, o eklentiyi el ile (ZIP yükleyerek ya da WP-CLI ile) güncellemek, WordPress'in kendi güncelleyicisinin zaman aşımına takılmasını atlatır.
Sık sorulan sorular
.maintenance dosyasını silmek güvenli mi?
Evet. Dosya yalnızca bakım ekranını tetikleyen geçici bir işaretçidir, silmek site verilerini etkilemez. Sonrasında yarım kalmış güncellemeyi kontrol etmeniz gerekir.
Dosyayı sildim ama bakım ekranı hâlâ görünüyor, neden?
Büyük olasılıkla önbellek. Tarayıcı, eklenti ve CDN önbelleğini temizleyin ve Ctrl+F5 deneyin. Yanlış klasörde dosya aradıysanız ya da bakım ekranını bir bakım modu eklentisi gösteriyorsa, o eklentiyi kapatın.
wp-admin'e de giremiyorum, ne yapmalıyım?
.maintenance dosyası wp-admin'i de engeller. Dosyayı sildiğinizde wp-admin de açılır. Silmeye rağmen açılmıyorsa başka bir hata var demektir, WordPress kritik hata rehberine bakın.
Güncelleme yarıda kalınca site bozulabilir mi?
Evet. Yarım yazılmış çekirdek ya da eklenti dosyaları hatalara neden olabilir. Çekirdek için sağlama toplamı kontrolü, eklenti için yeniden kurulum, gerekirse yedekten geri yükleme yapın. Eski sürüme dönmek istiyorsanız WordPress eski sürüme döndürme yazısına bakın.
Erdinç
Watch Your WP'yi geliştiriyor. WordPress bakım, güvenlik ve site yönetimi deneyiminden yazıyor.
LinkedIn