WP-CLI ile sunucudan WordPress yönetimi: Rehber

WordPress sitenizi SSH üzerinden yönetmek; güncelleme, eklenti işlemleri, bakım ve hatta hataların tespiti sırasında zaman kazandırır. Bu yönetimi düz dosya kopyalama yerine komut satırıyla yapmak için kullanılan araç WP-CLI (WordPress Command Line Interface) sunucu tarafında standart bir yaklaşımdır. Bu rehberde, WP-CLI ile tipik operasyonları adım adım; hangi komut ne işe yarar, hangi koşulda hangi seçenek seçilmeli sorularına net yanıtlarla anlatıyorum. Hedefiniz; tekrar eden işlemleri güvenli ve izlenebilir hale getirmek.

WP-CLI nedir, ne zaman kullanılır?

WP-CLI, WordPress yönetimi için komut satırı arayüzüdür. Tarayıcı üzerinden yaptığınız birçok işi; terminalden, betiklere (script) bağlayarak otomatikleştirmenizi sağlar.

SSH erişimi olan kimler kullanmalı?

• Yönetim hesabı yerine sunucuda komut çalıştırabilen site sahipleri veya sistem yöneticileri
• VDS/VPS/dedicated sunucuda WordPress barındıranlar
• Düzenli güncelleme, staging (test ortamı) ve yedekleme akışı olan ekipler

WP-CLI’nin sağladığı somut avantajlar

• Hız: Eklenti güncellemesi / tema yükleme gibi işlemler tek komutla ilerler.
• Tutarlılık: Her ortamda (prod/staging) aynı komut akışı kullanılır.
• Otomasyon: cron ile belirli periyotlarda bakım komutları tetiklenebilir.
• Sorun giderme: Özel hatalarda (kullanıcı kilidi, eksik dosya, veritabanı sorunları) belirli WP-CLI alt komutları hızlı teşhis sağlar.

Kurulum: WP-CLI’yi sunucuda hazır hale getirme

WP-CLI genellikle şu iki yoldan biriyle kullanılır: 1) Sağlayıcı tarafından sunucuda hazır gelmesi 2) WordPress dizininde (root klasöründe) WP-CLI’nin çalıştırılabilir hale getirilmesi

1) WordPress dizinini doğru belirleyin

İlk adım, WordPress dosyalarının bulunduğu dizine geçmektir. Örnek olarak: - WordPress dosyaları /var/www/site1 altında ise: cd /var/www/site1 - Docker/özel yapı varsa, WP çekirdeğinin bulunduğu dizin yine aynı mantıkla seçilir.

2) WP-CLI’nin çalışıp çalışmadığını test edin

Aşağıdaki komutla WordPress sürümünü kontrol edebilirsiniz: - wp core version

Eğer bu komut WordPress kök dizini dışında çalıştırılırsa hata verir. Hata görürseniz komutu doğru dizinden çalıştırın.

3) WP-CLI mevcut değilse: tek seferlik kurulum kontrol listesi

Kurulum yöntemleri sağlayıcıya göre değişir. Genel kontrol: - WP-CLI dosyası/komutu sunucuda erişilebilir mi? - Komutu çalıştıran kullanıcı (SSH kullanıcı adı) WordPress dosyaları üzerinde gerekli okuma/yazma yetkisine sahip mi? - Sunucuda PHP sürümü WordPress ile uyumlu mu?

Bu noktada kritik konu, yanlış izinlerle kurulum yapınca sonraki komutların (ör. tema yükleme) başarısız olmasıdır.

Temel operasyonlar: Core, eklentiler ve temalar

Aşağıdaki komutlar en sık kullanılanlardır. Hangi komutu ne zaman kullanacağınızı netleştirirseniz güncelleme döngünüz daha kontrollü olur.

WordPress çekirdek (core) güncelleme

• Sürüm kontrol: wp core version
• Mevcut güncellemeyi listele: wp core check-update
• Güncelle: wp core update

Net kural: Güncelleme öncesi yedek alın.

Eklenti (plugin) güncelleme ve durum kontrolü

• Yüklü eklentileri listele: wp plugin list
• Güncelleme var mı kontrol: wp plugin list --outdated
• Tüm güncellenebilir eklentileri güncelle: wp plugin update --all

Tema (theme) güncelleme ve etkin tema kontrolü

• Aktif temayı öğren: wp theme status
• Güncelleme var mı: wp theme list --update (sürüm ve yapı değişkenlik gösterebilir)
• Tüm güncellenebilir temaları güncelle: wp theme update --all

Önemli: bakım modunu bilinçli kullanın

Bakım modunu yalnızca kısa süreli işlemlerde açın; uzun bakım, kullanıcı deneyimini doğrudan etkiler. - wp maintenance-mode activate - wp maintenance-mode deactivate

Yedekleme ve geri dönüş: WP-CLI ile güvenli akış

WP-CLI; veritabanı ve dosyalar için doğrudan “disk yedeği” üretmez; ancak veritabanı (backup/restore) ve WP içerik yönetimi tarafında net komutlar sunar. En sağlam yaklaşım, WP-CLI’yi veritabanı yedeği üretmek + dış depolama ile çoğaltmak kombinasyonunda kullanmaktır.

Veritabanını dışarı aktar (export)

WordPress DB yedeği için tipik yaklaşım wp db export kullanmaktır. Örnek: - wp db export backup.sql

Bu komutun üreteceği backup.sql dosyası, daha sonra S3/R2/B2 gibi bir depolama alanına taşınabilir.

Dosya yedeği nasıl yapılmalı?

WP-CLI, dosya arşivini çoğu senaryoda doğrudan üretmez. Dosya yedeği için sunucu üzerinde arşiv almanız gerekir. Örneğin tar kullanımı sağlayıcıya göre değişir. Burada amaç, WordPress kök dizinini tutarlı biçimde arşivlemek ve geri dönüşü planlamaktır.

Geri dönüş (restore) adımı

Geri dönüş planında 3 kritik unsur vardır: - Veritabanı dosyasının doğru DB’ye yüklenmesi - wp-config.php içindeki DB parametreleri ile yedek uyumu - Dosyaların aynı dizin yapısında geri yüklenmesi

Geri dönüşü “kayıpsız” yapmak için, yedekten hemen sonra wp core verify-checksums gibi doğrulama mantığını (uygunsa) çalıştırabilirsiniz.

Sorun giderme: WP-CLI ile hızlı teşhis

WP-CLI, hataları kökünden görmek için komut seviyesinde veri sağlar. En yaygın iki alan: eklenti çakışması ve veritabanı/ayar sorunları.

Eklentiyi devre dışı bırakma (sorun kaynağını bulmak)

Eklenti çakışması yaşadığınızda tüm siteyi kurcalamak yerine hedefli ilerleyin. Tipik yöntem: - Eklentiyi devre dışı bırak: wp plugin deactivate eklenti-klasoru/eklentidosyasi.php

Ardından siteyi test edin. Sorun devam ediyorsa bir sonraki eklentiye geçin.

Tema değiştirme

• Mevcut temayı öğrenin: wp theme list --status=active
• Alternatif tema seçin ve etkin yapın: wp theme activate tema-adi

WordPress ayarlarını (option) güncelleme

Örneğin URL değişimi sonrası sorunlarda siteurl ve home değerleri etkili olur. İşlem örnek mantık: - wp option get siteurl - wp option get home

Değerleri doğruysa sorun başka yerde olabilir. Değerleri yanlışsa güncelleme yapın.

Kullanıcı ve rol yönetimi

• Kullanıcı listeleme: wp user list
• Şifre sıfırlama: wp user update kullaniciadi --user_pass="YeniGeciciSifre"

Bu komut özellikle erişim kaybında hız kazandırır.

Otomasyon: cron ile bakım penceresini kontrol etmek

WP-CLI’nin en güçlü yanı komutların otomasyona uygun olmasıdır. Otomasyonda hedef, “her şey her an güncellensin” değil; riskli işleri kontrollü sıralamayla yapmaktır.

Önerilen otomasyon akışı

1) Bakım modunu aç 2) Güncellemeleri kontrol et 3) Test/staging varsa önce orada güncelle 4) Üretim (prod) ortamında güncelle 5) Önbelleği temizle (varsa) 6) Bakım modunu kapat

Cron için net örnek (mantık)

Gerçek cron kaydı sağlayıcıya göre değişir. Ancak mantık şu şekildedir: - Haftalık: wp plugin update --all + wp theme update --all - Aylık: wp core update - Her çalışmada: wp core check-update ve wp plugin list --outdated çıktısını log dosyasına yaz

Burada kritik nokta, logları izlemek ve başarısız güncellemede otomasyonun tekrar tekrar aynı hatayı üretmesini engellemektir.

Güvenlik: WP-CLI kullanımında hataya yer bırakmayın

WP-CLI komutları, WordPress üzerinde değişiklik yaptığından güvenlik yaklaşımı net olmalıdır.

En sık yapılan 3 hata

• Yanlış dizinden komut çalıştırıp beklenmedik değişiklik yapmak
• WP-CLI’yi prod ortamında “tek hamlede” güncelleme ile riskli hale getirmek
• Güncelleme öncesi yedek almamak

Uygulamada alınacak önlemler

• Staging ortamı kullanın ve güncelleme senaryolarını burada test edin.
• Üretim ortamında güncelleme öncesi en az DB export (ve dosya arşivi) yedeği alın.
• WP-CLI komutlarını mümkünse sınırlı yetkiye sahip kullanıcıyla çalıştırın (tam root yetkisi gerekmeyen durumlarda).
• SSH erişimini IP kısıtlaması veya anahtar tabanlı kimlik doğrulama (2FA ile uyumlu süreçler) ile daraltın.

WP-CLI ile kontrol paneli yerine geçer mi?

WP-CLI, kontrol panelinin yerine “tek başına” geçmek zorunda değildir. En verimli kullanım, ikisini tamamlayacak şekilde kurgulamaktır.

Karşılaştırma: WP-CLI vs tarayıcı yönetimi

Sonuç: 30 dakikada yönetimi standardize edin

WP-CLI’yi doğru kurup düzenli bir akışla kullanmak, WordPress yönetimini “kişisel alışkanlık” olmaktan çıkarıp tekrarlanabilir bir sürece dönüştürür. İlk aksiyon olarak: WordPress kök dizinini doğrulayın, wp core version ve wp plugin list --outdated komutlarını çalıştırın. Ardından üretimde herhangi bir güncelleme yapmadan önce wp db export ile DB yedeği alın ve mümkünse staging’de test edin. Bu adımları tamamladığınızda güncelleme, bakım ve sorun giderme süreçleriniz ölçülebilir şekilde hızlanır ve hataya açık noktalar azalır.