14 min. okuyun

WP-CLI: WordPress’i Komut Satırından Yönetmek için Eksiksiz Kılavuz

WP-CLI, WordPress kurulumlarını bir tarayıcı açmadan doğrudan terminalinizden yönetmek için resmi komut satırı aracıdır. Birden fazla sitede eklentileri güncellemek için WordPress yönetici panosuna tıklayarak bir öğleden sonra geçirdiyseniz, bu aracın neden var olduğunu zaten biliyorsunuzdur.

Bu kılavuzda, Linux, macOS ve Windows’ta WP-CLI kurulumundan karmaşık bakım görevlerini komut dosyaları ve yapılandırma dosyalarıyla otomatikleştirmeye kadar her şeyi öğreneceksiniz. İster tek bir blogu ister düzinelerce müşteri sitesini yönetiyor olun, WP-CLI’da ustalaşmak WordPress ile çalışma şeklinizi temelden değiştirecek.

Ne öğreneceksiniz?

WP-CLI farklı işletim sistemlerinde nasıl kurulur ve yapılandırılır
Eklentileri, temaları, kullanıcıları ve içeriği yönetmek için temel komutlar
Dışa aktarma, içe aktarma ve güvenli arama-değiştirme dahil veritabanı işlemleri
Komut dosyaları, takma adlar ve cron işleri kullanarak otomasyon teknikleri
Terminalden çalışırken sık karşılaşılan tuzaklardan kaçınmak için en iyi uygulamalar

WP-CLI Nedir? (Önce Hızlı Açıklama)

WP-CLI, WordPress Komut Satırı Arayüzü anlamına gelir – WordPress sitelerini tamamen terminalden yönetmenizi sağlayan açık kaynaklı bir araçtır. Wp-admin’e giriş yapmak ve menüler arasında gezinmek yerine, wp plugin update --all gibi komutları çalıştırır ve tüm eklenti yığınınızın saniyeler içinde güncellenmesini izlersiniz.

Proje, WordPress’i geniş ölçekte yönetmek için daha hızlı bir yol isteyen geliştiriciler tarafından 2011 yılında başlatıldı. 2017 yılında resmi WordPress.org şemsiyesi altına taşındı ve şu anda Alain Schlesser ve Daniel Bachhuber dahil olmak üzere katkıda bulunan özel bir ekip tarafından sürdürülüyor.

İşte WP-CLI hakkında bilmeniz gerekenler:

Mevcut kararlı sürüm: WP-CLI 2.x serisi
WordPress uyumluluğu: WordPress 5.x ile 6.x arasında (ve tarihsel olarak 3.7’ye kadar) çalışır
PHP gereksinimleri: Güvenlik ve performans için PHP 7.4+ veya 8.x önerilir
Komut ekosistemi: Neredeyse her WordPress işlemini kapsayan 40’tan fazla ana komut
Birincil kullanıcılar: Geliştiriciler, ajanslar, DevOps mühendisleri ve karmaşık veya birden fazla siteyi yöneten uzman kullanıcılar
Dağıtım: PHAR dosyası olarak, paket yöneticileri aracılığıyla veya birçok yönetilen WordPress ana bilgisayarına önceden yüklenmiş olarak mevcuttur

WP-CLI Kullanmanın Temel Faydaları

WP-CLI’nin neden var olduğunu anladığınızda, öğrenme eğrisini gerekçelendirmek çok daha kolay hale gelir. Bu bölüm, bu aracı zaman ayırmaya değer kılan somut avantajları açıklamaktadır.

Tekrarlayan görevlerde zaman tasarrufu
WordPress panosu üzerinden 20 eklentiyi güncellemek, 20 sayfa yüklemesi, 20 tıklama ve 20 ilerleme çubuğu izlemek anlamına gelir. WP-CLI ile wp plugin update --all adresini bir kez çalıştırır ve yolunuza devam edersiniz. Birden fazla müşteri sitesini yöneten ajanslar için bu fark, her hafta tasarruf edilen saatlere dönüşür.

Toplu ve otomatik işlemler
Black Friday için 15 WooCommerce mağazası hazırladığınız bir senaryo düşünün. Her sitede eklentileri güncellemeniz, önbellekleri temizlemeniz ve veritabanı bütünlüğünü doğrulamanız gerekir. WP-CLI bu işlemlerin tamamını senaryolaştırmanıza ve tüm sitelerde saatler yerine dakikalar içinde gerçekleştirmenize olanak tanır. Temel otomasyon özellikleri şunları içerir:

Tek bir komut dosyası ile birden fazla kurulumdaki tüm eklentileri güncelleme
Önceden tanımlanmış rollerle toplu olarak kullanıcı oluşturma
Cron aracılığıyla gece bakımının çalıştırılması (veritabanı optimizasyonu, geçici temizlik)
Aynı WordPress yapılandırmalarını yeni ortamlara dağıtma

Tarayıcı tabanlı işlemlerde güvenilirlik
Tarayıcı işlemleri HTTP zaman aşımına uğrar. Büyük veritabanı içe aktarımları işlemin ortasında başarısız oluyor. Arama-değiştirme işlemleri ham SQL ile yapıldığında serileştirilmiş verileri bozar. WP-CLI, zaman aşımı kısıtlaması olmadan doğrudan sunucu üzerinde çalıştığı ve search-replace komutu serileştirilmiş veri yapılarını doğru bir şekilde işlediği için tüm bu sorunlardan kaçınır.

Temel WordPress sistemleri üzerinde doğrudan kontrol
Tek bir terminalden şunları yapabilirsiniz:

WordPress veritabanını dışa ve içe aktarma
wp-config.php ayarlarını değiştirin
Wp-cron olaylarını inceleme ve tetikleme
Bakım modunu açma ve kapatma
WordPress bağlamında rastgele PHP kodu çalıştırma

wp-admin üzerindeki yükün azaltılması
Yoğun üretim sunucularında, her yönetici panosu sayfası yüklemesi kaynakları tüketir. Bakım işlemlerini WP-CLI aracılığıyla yürütmek, bu yükü web sunucusundan uzak tutar, bu da yoğun trafik dönemlerinde önemlidir.

WP-CLI Gereksinimleri ve Desteklenen Ortamlar

WP-CLI’yi kurmadan önce, sunucunuzun veya yerel ortamınızın temel gereksinimleri karşıladığını onaylamanız gerekir. İyi haber şu ki, modern WordPress kurulumlarının çoğu zaten uygun.

PHP sürüm gereksinimleri:

Minimum: PHP 5.6 (bu güncelliğini yitirmiş olsa da)
Tavsiye edilir: 2026’da güvenlik ve performans için PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 veya 8.5

WordPress sürüm uyumluluğu:

Tarihsel destek: WordPress 3.7 ve daha yeni sürümler
Modern hedef: Güncel projeler için WordPress 5.0 ile 6.7+ arası

İşletim sistemi beklentileri:

En iyi destek: UNIX benzeri sistemler (Ubuntu 22.04 LTS, Debian 12, CentOS Stream, macOS)
Windows: WSL (Linux için Windows Alt Sistemi) veya yerel PHP kurulumu aracılığıyla desteklenir

Ek gereksinimler:

PHP komut satırında kullanılabilir ( php ikili dosyasının PATH’inizde olması gerekir)
wp-cli.phar dosyasını indirmek için cURL veya wget
Uzak sunucular için SSH erişimi (çoğu yönetimli WordPress hosting planı varsayılan olarak bunu içerir)

Kinsta, SiteGround ve DreamHost gibi birçok popüler host artık WP-CLI önceden yüklenmiş olarak gönderiliyor. WordPress.com ayrıca SSH erişimi etkinleştirilmiş siteler için WP-CLI içerir.

Linux ve macOS’ta WP-CLI Nasıl Kurulur

Standart kurulum yöntemi resmi PHAR (PHP Arşivi) dosyasını kullanır. Bu işlem Ubuntu, Debian, CentOS, Fedora ve macOS terminallerinde çalışır.

Adım 1: PHAR dosyasını indirin
Terminalinizi açın ve curl kullanarak wp-cli.phar adresini indirin:

curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

Alternatif olarak, wget kullanın:

wget https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

Adım 2: İndirmeyi doğrulayın (isteğe bağlı ancak önerilir)
Dosyanın indirme sırasında kurcalanmadığından emin olmak için SHA-256 sağlama toplamını WP-CLI belgelerinde yayınlanan resmi değere göre kontrol edin:

sha256sum wp-cli.phar

Çıktıyı resmi WP-CLI web sitesinde listelenen sağlama toplamı ile karşılaştırın.

Adım 3: PHAR dosyasını test edin
php dosyasının çalıştığını onaylayın:

php wp-cli.phar --info

WP-CLI sürümünü, PHP sürümünü ve sistem bilgilerini gösteren bir çıktı görmelisiniz.

Adım 4: Çalıştırılabilir hale getirin ve PATH‘e taşıyın
Dosyayı çalıştırılabilir olarak işaretleyin ve sistem PATH’inizdeki bir dizine taşıyın:

chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp

sudo komutu genellikle gereklidir çünkü /usr/local/bin bir sistem dizinidir. WP-CLI’yi öncelikle normal bir kullanıcı olarak çalıştıracaksanız root olarak kurmaktan kaçının.

Adım 5: Global kurulumu doğrulayın
WP-CLI’nin artık global olarak kullanılabilir olduğunu onaylayın:

wp --info
wp cli version

Wp cli sürümünü, PHP ikili konumunu ve işletim sistemi ayrıntılarını doğrulayan bir çıktı görmelisiniz. Bu noktada, WP-CLI yüklenmiş ve kullanıma hazırdır.

Windows’ta WP-CLI Nasıl Kurulur

Windows kullanıcılarının iki ana yolu vardır: Linux için Windows Alt Sistemi (WSL) kullanmak veya yerel bir Windows kurulumu yapmak. WSL daha Linux benzeri bir deneyim sağlar ve genellikle tavsiye edilir.

Seçenek 1: WSL Kullanımı (Önerilen)
Öncelikle Windows 10 veya 11’de WSL’yi etkinleştirin:

wsl --install

Microsoft Store’dan Ubuntu’yu yükleyin, ardından Ubuntu terminalini başlatın. Buradan, önceki bölümde özetlenen Linux kurulum adımlarının aynısını izleyin – phar dosyasını indirin, çalıştırılabilir hale getirin ve /usr/local/bin/wp adresine taşıyın.

Seçenek 2: Yerel Windows Kurulumu
Yerel kurulum için Windows için PHP’nin php çalıştırılabilir dosyasıyla birlikte sistem PATH’inizde yüklü olması gerekir.

PHP’yi Windows için PHP resmi sitesinden indirin ve kurun
PHP dizinini Windows PATH ortam değişkeninize ekleyin
Komut İstemi’ni açıp çalıştırarak PHP’nin çalıştığını onaylayın php -v

Ardından, WP-CLI PHAR dosyasını indirin:

curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

Windows, 2018’den beri varsayılan olarak curl içerir, bu nedenle bu, ek kurulum gerektirmeden çalışmalıdır. WP-CLI için bir klasör oluşturun (örneğin, C:\wp-cli) ve indirilen dosyayı oraya taşıyın.

Ardından aynı klasörde wp.bat adında bir toplu sarmalayıcı dosyası oluşturun:

@echo off
php "C:\wp-cli\wp-cli.phar" %*

C:\wp-cli adresini sistem PATH ortam değişkeninize ekleyin. Şimdi yeni bir Komut İstemi veya PowerShell penceresi açın ve doğrulayın:

wp --info

WP-CLI sürümünü ve WP-CLI’nin düzgün bir şekilde kurulduğunu doğrulayan ortam ayrıntılarını görmelisiniz.

Temel WP-CLI Kullanımı ve Yardım Alma

WP-CLI yüklüyken, belirli işlemlere dalmadan önce temel komut modelini anlamanız gerekir. Tüm WP-CLI komutları bu yapıyı takip eder:

wp <command> <subcommand> [options]

Komutlar WordPress kurulum dizininden ( wp-config.php içeren klasör) çalıştırılır. Başka bir yerdeyseniz, yolu --path=/var/www/html/mysite ile belirtebilirsiniz.

Ortamınızı kontrol etme
Kurulumunuzu onaylayarak başlayın:

wp --info

Bu, WP-CLI sürümünüzü, PHP sürümünüzü, PHP ikili yolunu, işletim sisteminizi ve diğer ortam ayrıntılarını görüntüler. Sadece WP-CLI sürümünü görmek için:

wp cli version

Mevcut komutları keşfetme
Mevcut tüm wp cli komutlarını listelemek için:

wp help

Belirli bir komut hakkında yardım için:

wp help plugin
wp help core update

Ayrıca --help adresini herhangi bir komuta ekleyebilirsiniz:

wp user --help

Yardım çıktısı Unix man sayfalarına benzer bir sayfalayıcıda görüntülenir. Çıkmak için q tuşuna basın.

Denenecek ilk komutlar:

wp core version – WordPress sürümünüzü görüntüler
wp plugin list – Yüklü tüm WordPress eklentilerini durumlarıyla birlikte gösterir
wp theme list – yüklü temaları gösterir
wp user list – sitedeki tüm kullanıcıları listeler

Bu salt okunur komutlar, WordPress sitenizi hiçbir şeyi değiştirmeden keşfetmenizi sağlar, bu da arayüze alışmak için mükemmeldir.

WP-CLI ile WordPress Yükleme ve Yapılandırma

WP-CLI, yeni bir WordPress kurulumunu geleneksel web tabanlı yükleyiciden daha hızlı gerçekleştirebilir. Bu, özellikle geliştirme ortamları oluştururken veya yeni siteleri programlı olarak dağıtırken değerlidir.

Önkoşullar
Yükleme komutlarını çalıştırmadan önce, bir MySQL veya MariaDB veritabanının hazır olması gerekir. Bu örnek için, oluşturduğunuzu varsayın:

Veritabanı adı: wpsite_db
Veritabanı kullanıcısı: wpsite_user
Şifre: securepassword123
Ev sahibi: localhost

Adım 1: WordPress çekirdek dosyalarını indirin
İstediğiniz kurulum dizinine gidin ve WordPress çekirdeğini indirin:

wp core download

Bu, en son WordPress sürümünü getirir. Bir sürüm veya yerel ayar belirtmek için:

wp core download --version=6.4.2 --locale=fr_FR

Tamamlandıktan sonra, WordPress’in başarıyla indirildiğine dair bir onay göreceksiniz.

Adım 2: wp-config.php dosyasını oluşturun
wp config create kullanarak yapılandırma dosyasını oluşturun:

wp config create --dbname=wpsite_db --dbuser=wpsite_user --dbpass=securepassword123 --dbhost=localhost

Bu, veritabanı kimlik bilgileriniz ve otomatik olarak oluşturulan güvenlik tuzları ile eksiksiz bir wp-config.php oluşturur.

Adım 3: Kurulumu çalıştırın
Şimdi WordPress’i site ayrıntılarınızla yükleyin:

wp core install --url=https://example.com --title="My New Site" --admin_user=admin --admin_password=strongpassword [email protected]

“WordPress başarıyla yüklendi” mesajını göreceksiniz ve siteniz kullanıma hazır olacak.

Çoklu site kurulumu
WordPress çoklu site ağları için, çoklu site değişkenini kullanın. WP-CLI ile çoklu site kurulumlarını yapılandırabilirsiniz:

wp core multisite-install --url=https://example.com --title="My Network" --admin_user=admin --admin_password=strongpassword [email protected]

WP-CLI ile Temaları Yönetme

WP-CLI, WordPress yönetici panosuna erişim gerektirmeden tüm tema işlemlerini gerçekleştirir. Temaları doğrudan terminalinizden listeleyebilir, yükleyebilir, etkinleştirebilir, güncelleyebilir ve silebilirsiniz.

Yüklü temaları listeleme
Şu anda yüklü olan tüm temaları görmek için:

wp theme list

Örnek çıktı:

isim	durum	güncelleme	versiyon
twentytwentyfour	aktif	none	1.0
twentytwentythree	aktif değil	none	1.2
ASTRA	aktif değil	mevcut	4.5.0

Bir temayı etkinleştirme
Farklı bir temaya geçin:

wp theme activate astra

Bu, etkin temayı hemen değiştirir. Varsayılan temaya geri dönmek, temayla ilgili sorunları gidermek için kullanışlıdır:

wp theme activate twentytwentyfour

Yeni temalar yükleme
WordPress.org deposundan bir tema yükleyin:

wp theme install astra

Tek bir komutla kurun ve etkinleştirin:

wp theme install astra --activate

Temaları güncelleme
Belirli bir temayı güncelleyin:

wp theme update astra

Ya da tüm temaları aynı anda güncelleyin:

wp theme update --all

Temaları silme
Artık ihtiyacınız olmayan bir temayı kaldırın:

wp theme delete twentytwentythree

WP-CLI ile Eklentileri Yönetme

Eklenti yönetimi WP-CLI’ın en çok zaman kazandırdığı yerdir. Kontrol panelinde onlarca tıklama gerektiren toplu işlemleri gerçekleştirebilirsiniz.

Eklentileri listeleme

wp plugin list

Örnek çıktı:

isim	durum	güncelleme	versiyon
woocommerce	aktif	none	8.5.1
yoast-seo	aktif	mevcut	21.0
elementor	aktif değil	none	3.18.0

Eklentileri yükleme
Bir eklentiyi slug’ına göre yükleyin:

wp plugin install woocommerce

Kurun ve etkinleştirin:

wp plugin install yoast-seo --activate

Etkinleştirme ve Devre Dışı Bırakma
Bir eklentiyi etkinleştirin:

wp plugin activate elementor

Bir eklentiyi devre dışı bırakın (hata ayıklama için kullanışlıdır):

wp plugin deactivate elementor

Tüm eklentileri bir kerede devre dışı bırakın (“Ölümün Beyaz Ekranı” hata ayıklaması için hayat kurtarıcı):

wp plugin deactivate --all

Eklentileri güncelleme
Belirli bir eklentiyi güncelleyin:

wp plugin update yoast-seo

Tüm eklentileri güncelleyin:

wp plugin update --all

Ayrıca belirli eklentileri toplu güncellemeden hariç tutabilirsiniz:

wp plugin update --all --exclude=woocommerce

WordPress Çekirdeğini Güncelleme ve Onarma

WordPress’i güncel tutmak güvenlik açısından kritik öneme sahiptir. WP-CLI bu süreci şeffaf ve kontrol edilebilir hale getirir.

Güncellemeleri kontrol etme

wp core check-update

WordPress‘i Güncelleme
En son sürüme güncelleyin:

wp core update

Bir çekirdek güncellemesinden sonra, veritabanı şemasını güncellemek iyi bir uygulamadır:

wp core update-db

Sağlama toplamlarını doğrulama
Sitenizin saldırıya uğradığından şüpheleniyorsanız, çekirdek dosyaların değiştirilmediğini doğrulayabilirsiniz:

wp core verify-checksums

Bu, dosyalarınızı resmi WordPress deposu sağlama toplamlarıyla karşılaştırır.

Core’u Yeniden Yükleme
Dosyalar bozulursa, içeriğinizi etkilemeden yeniden yüklemeye zorlayabilirsiniz:

wp core download --force --skip-content

İçeriği, Kullanıcıları ve Veritabanını Yönetme

WP-CLI, sitenizin verileriyle doğrudan etkileşim kurmanıza olanak tanır.

Kullanıcı Yönetimi
Kullanıcıları listeleyin:

wp user list

Yeni bir yönetici oluşturun:

wp user create newadmin [email protected] --role=administrator --user_pass=securepass123

Bir kullanıcı parolasını güncelleyin:

wp user update 1 --user_pass=newpassword

Bir kullanıcıyı silin ve içeriğini yeniden atayın:

wp user delete 5 --reassign=1

Veritabanı İşlemleri
Veritabanını bir dosyaya aktarın:

wp db export backup.sql

Bir dosyadan veritabanı içe aktarın:

wp db import backup.sql

Veritabanını optimize edin:

wp db optimize

WordPress veritabanınıza doğrudan bağlı bir MySQL konsolu açın:

wp db cli

Arama ve Değiştirme (Doğru Yol)

Bir WordPress sitesini manuel olarak yeni bir alan adına taşımak risklidir çünkü veriler genellikle veritabanında serileştirilir. Basit bir SQL bul ve değiştir işlemi widget’ları ve tema seçeneklerini bozacaktır. WP-CLI serileştirmeyi doğru şekilde ele alır.

Standart Arama-Değiştirme

wp search-replace 'http://old-domain.com' 'https://new-domain.com'

Dry Run (Önizleme)
Komutu çalıştırmadan önce her zaman nelerin değişeceğini kontrol edin:

wp search-replace 'http://old-domain.com' 'https://new-domain.com' --dry-run

Değiştirme ile dışa aktarma
Bir veritabanını, canlı veritabanına dokunmadan dosyada yapılan değiştirmelerle dışa aktarabilirsiniz:

wp search-replace 'old.com' 'new.com' --export=migrated-db.sql

Gelişmiş Bakım: Cron ve Nesne Önbelleği

Cron İşlerini Yönetme
Zamanlanmış etkinlikleri görüntüleyin:

wp cron event list

Gereken tüm cron olaylarını hemen çalıştırın:

wp cron event run --due-now

Geçici Aktarımları ve Önbelleği Yönetme
Nesne önbelleğini temizleyin:

wp cache flush

Süresi dolan tüm geçici maddeleri silin:

wp transient delete --expired

Komut Dosyaları ile Görevleri Otomatikleştirme

Otomatik bakım için WP-CLI komutlarını Bash komut dosyalarında birleştirebilirsiniz.

Örnek: Haftalık Bakım Komut Dosyası
maintain.sh adında bir dosya oluşturun:

#!/bin/bash
# Update everything
wp core update
wp core update-db
wp plugin update --all
wp theme update --all

# Cleanup
wp transient delete --expired
wp cache flush
wp db optimize

echo "Maintenance complete."

Çalıştırılabilir hale getirin (chmod +x maintain.sh) ve saniyeler içinde tam site bakımı gerçekleştirmek için çalıştırın.

WP-CLI’yi SSH ile Uzaktan Kullanma

Takma adları yapılandırırsanız komutları çalıştırmak için sunucuda oturum açmanız gerekmez.

Yerel wp-cli.yml dosyanızda:

@prod:
  ssh: [email protected]/var/www/html
@dev:
  ssh: [email protected]/var/www/html

Artık yerel makinenizden uzak sunucudaki komutları çalıştırabilirsiniz:

wp @prod plugin list
wp @dev core version

En İyi Uygulamalar

Her Zaman Yedekleyin: Toplu güncellemeleri veya arama-değiştirme komutlarını çalıştırmadan önce wp db export adresini çalıştırın.
Kuru Çalıştırma kullanın: Arama-değiştirme için her zaman önce --dry-run adresini kullanın.
Root olarak çalıştırmayın: WP-CLI, root olarak çalıştırırsanız sizi uyarır. Web sunucusu kullanıcısı (örn. www-data) veya kendi kullanıcı hesabınız olarak çalıştırmak daha güvenlidir.
Aşamada Test Edin: Üretim sitenizi aşamalandırmaya klonlamak için WP-CLI kullanın, güncelleme komut dosyalarınızı burada test edin ve ardından üretime uygulayın.

Sonuç

WP-CLI, WordPress yönetimini bir dizi tıklamadan aerodinamik, komut dosyası yazılabilir işlemlere dönüştürür. Sürümleri kontrol etmek ve eklentileri listelemek gibi basit komutlarla başlamak, gelişmiş otomasyon için temel oluşturur. WP-CLI’yi bugün iş akışınıza entegre etmek, WordPress projelerinizde sayısız saat tasarrufu sağlayacaktır.