WordPress Sitenizde WP-CLI Kullanma

KPanel includes a WP-CLI console that runs commands against your WordPress site from the browser, with no SSH client and no server login. This guide covers where to find it, exactly which commands…

KPanel WP-CLI konsolunu içerir ve bu konsol tarayıcıdan WordPress sitenize karşı komutlar çalıştırır; SSH istemcisine veya sunucu girişine ihtiyaç yoktur. Bu kılavuz, konsolun nerede bulunacağını, tam olarak hangi komutlara izin verildiğini ve neden izin verildiğini, ekranda yerleşik olan kısayolları ve konsol çalıştırmayacak bir şeye ihtiyacınız olduğunda ne yapacağınızı anlatır.

Konsolu Açma

KPanel adresinde oturum açın ve sol kenar çubuğunda Websites (Web Siteleri) seçeneğini tıklayın.
WordPress sitenize tıklayın.
WordPress sekmesini açın, ardından Console (Konsol) bölümünü açın.

KPanel'de bir WordPress sitesi üzerindeki WP-CLI konsolu

Giriş zaten sabit wp ile başlar, bu nedenle yalnızca ondan sonra geleni yazarsınız. plugin list, wp plugin list değil. Enter tuşuna basın veya Run (Çalıştır) seçeneğini tıklayın.

Console (Konsol), yönetilen planlarda görünen bölümlerden biridir. Diğer planlarda sekme şeridi bunun yerine +8 on Managed (Yönetilende +8) bağlantısı ile sona erer. Burada açıklanan ve ham komut olmayan her işlemin KPanel'de başka bir yerde eşdeğer bir düğmesi vardır, bu nedenle hiçbir şey erişim dışı değildir: konsol aynı motora ulaşmanın daha hızlı bir yoludur.

Komutlar sitenizin kendi sistem kullanıcısı olarak sitenizin dizini içinde çalışır. Başka hiçbir siteyi göremez veya dokunabilmezler.

Konsol Neleri Çalıştıracak ve Neleri Çalıştırmayacak

Konsol bir beyaz liste kullanır. Yalnızca aşağıdaki komut önekleri kabul edilir ve diğer her şey reddedilmeden önce sunucuya ulaşmadan, reddedilen komutu adlandıran bir mesajla reddedilir.

Alan	İzin Verilen
Core	`core version`, `core check-update`, `core update`, `core is-installed`, `core verify-checksums`
Plugins	`plugin list`, `plugin update`, `plugin install`, `plugin activate`, `plugin deactivate`, `plugin status`, `plugin get`, `plugin delete`, `plugin verify-checksums`
Themes	`theme list`, `theme update`, `theme install`, `theme activate`, `theme status`, `theme get`, `theme delete`
Users	`user list`, `user get`, `user create`, `user update`, `user set-role`, `user delete`, `user reset-password`, `user add-cap`, `user remove-cap`, `user generate`
Database	`db size`, `db tables`, `db optimize`, `db repair`, `db check`
Cache and transients	`cache flush`, `cache get`, `cache set`, `cache add`, `cache delete`, `transient get`, `transient set`, `transient delete`
Rewrite rules	`rewrite flush`, `rewrite list`, `rewrite structure`
Cron	`cron event list`, `cron event run`, `cron schedule list`
Config	`config get`, `config list`, `config has`, `config shuffle-salts`
Maintenance mode	`maintenance-mode activate`, `maintenance-mode deactivate`, `maintenance-mode status`
Read only inspection	`option get`, `option list`, `post list`, `post get`, `comment list`, `comment get`
Media and language	`media regenerate`, `language core install`, `language core update`
Search and replace	`search-replace`

Kasıtlı istisnalar, inclusionlardan daha önemlidir:

eval ve shell engellenir. Keyfi PHP ve keyfi shell, konsolu tarayıcı sekmesindeki kök istemcisine eşdeğer kılardı.
db import, db export, db drop, db query ve db reset engellenir. İçe aktarma ve sıfırlama, bir veritabanını onay adımı olmadan yok eder; db query kısıtlanmamış bir SQL istemidir. Bunun yerine phpMyAdmin'i kullanın: phpMyAdmin ile Veritabanınıza Erişme.
config set ve config delete engellenir. Kötü bir wp-config.php yazılışı siteyi çevrimdışına alır. Değerleri burada okuyun, dosya yöneticisi aracılığıyla değiştirin.
option update ve option delete engellenir. Seçenekleri kör bir şekilde düzenlemek, bir siteyi kurtarılamayacak şekilde kırmak için yaygın bir yoldur.

Konsol hiçbir komutta sizin için yedek almaz. Yalnızca Quick Actions (Hızlı İşlemler) bölümündeki düğmeler bunu yapar. search-replace, core update, plugin update, theme update, db optimize veya db repair öncesinde, sitenizin Backups (Yedeklemeler) sekmesinden kendiniz bir yedek alın. Yedek Alma bölümüne bakın.

Konsolda Çalışma

Ekran her seferinde bir komuttan fazlasını kabul etmekten daha fazlasını yapar.

Ön ayarlı düğmeler. Gruplandırılmış kısayollar istemi üzerinde oturum açar: Performance (Performans) (önbelleği temizle, geçici belleği temizle, yeniden yazmaları temizle, otomatik yüklemeyi kontrol et), Database (Veritabanı) (optimize et, kontrol et, onarım, boyut), Diagnostics (Tanılama) (WP sürümü, güncellemeleri kontrol et, çekirdeği doğrula, cron etkinlikleri), Content (İçerik) (eklentileri, temaları, kullanıcıları listele, cron'u şimdi çalıştır), Security (Güvenlik) (yönetici kullanıcıları, eklenti sağlama toplamları, tuzları sıfırla, wp-config) ve Maintenance (Bakım) (bakım modu açık ve kapalı, küçük resimleri yeniden oluştur, durum). Bir tıklama komutu çalıştırır.

Geçmiş. İstemde yukarı ve aşağı okları basarak bu sitede son 50 komutunuz arasında hareket edin.

Snippet'ler. Bir komutun yanındaki yer işareti simgesine tıklayarak onu bir adla kaydedin; böylece her ay kullandığınız uzun bir çağrı bir sonraki sefer tek bir tıklamadır.

Environment card. İstem üzerinde, bir kart sitenizin PHP sürümü, WordPress sürümü, bellek sınırı, şu anda kullanılan bellek, karşıya yükleme maksimumu ve yürütme süresi sınırını gösterir; tümü ile birlikte etkin eklenti listenizi panoya koyan bir Copy for support (Destek İçin Kopyala) düğmesidir. Bunu bir destek biletine yapıştırın ve bir gidiş-dönüş tasarrufu sağlayın.

Copy output. Her sonuç bloğunun kopyalama ve temizleme düğmeleri vardır.

Komut çalışırken output geri akar, bu nedenle uzun bir işlem sessizce oturmak yerine ilerlemeyi gösterir.

Bilmeye Değer Komutlar

Tanılama

core version
core verify-checksums
plugin verify-checksums --all
plugin list --status=active --format=table
db size --tables
option list --autoload=yes

verify-checksums çekirdek ve eklenti dosyalarınızı resmi yayınlanan kopyalarla karşılaştırır ve değiştirilen her şeyi rapor eder. Kurcalandığından şüphelendiğiniz bir sitede en hızlı ilk kontroldür.

option list --autoload=yes WordPress'in her tek istekte yüklediği her seçeneği listeler. Şişirilmiş bir otomatik yükleme tablosu, görünür sebep olmaksızın yavaş olan sitenin en yaygın nedenlerinden biridir.

Ev İdaresi

cache flush
transient delete --all
rewrite flush
db optimize
cron event list
cron event run --due-now

Kullanıcılar

user list --role=administrator --format=table
user create jo jo@example.com --role=editor
user update 4 --user_pass='a-long-unique-password'

Burada yazılan her şey hesabınızın aktivite günlüğünde kaydedilir ve parolalar da dahil olmak üzere. Oturum açtıktan sonra bu şekilde ayarladığınız bir parolayı bir kez değiştirin. Hesap kurtarmayla ilgili tüm ayrıntılar Kayıp WordPress Yönetici Parolasını Sıfırlama bölümündedir.

Arama ve Değiştirme

search-replace 'http://old-domain.co.nz' 'https://old-domain.co.nz' --all-tables --dry-run

Daima önce kuru çalışma yapın. Ham SQL değiştirmenin neden WordPress veritabanını bozduğunu da içeren tam kılavuz Arama ve Değiştirme Çalıştırma bölümündedir.

Konsol mu Hızlı İşlemler mi?

Her ikisi de aynı WP-CLI'yi çalıştırır. Bunu göre seçin:

Görev	Daha iyi rota
Önbelleği temizle, eklentileri güncelle, medyayı yeniden oluştur	Quick Actions (Hızlı İşlemler), bir tıklama ve önce yedeklenir
Tablo başına önizlemeli arama ve değiştirme	Quick Actions (Hızlı İşlemler), Search & Replace (Arama ve Değiştirme) kartı
Belirli bir bayrak gerektiren herhangi bir şey	Konsol
Listeleme, inceleme, tanılama	Konsol
Bir vadesi geçen cron etkinliğini çalıştırma	Konsol
`wp-config.php` düzenleme veya veritabanı içe aktarma	Hiçbiri. Dosya yöneticisi veya phpMyAdmin'i kullanın

Beyaz Liste Gereksiniminden Daha Fazlasına İhtiyaç Duyduğunuzda

Sınırlandırılmamış WP-CLI için SSH üzerinden bağlanın ve sitenizin dizininden wp doğrudan çalıştırın. SSH sadece anahtar kimlik doğrulamasını kullanır, bu nedenle sitenizin Files (Dosyalar) sekmesinden ilk olarak ortak anahtarınızı ekleyin, ardından SSH Keys (SSH Anahtarları) sekmesini açın. Bağlantı ayrıntıları; tam ana makine, bağlantı noktası ve kullanıcı adı da dahil olmak üzere aynı ekranda gösterilir. SSH Anahtarlarını Ekleme ve SFTP Üzerinden Bağlanma bölümlerine bakın.

Sorun Giderme

"'x y' is not in the allowed command list." Komut beyaz listede değildir. Yukarıdaki tabloda en yakın izin verilen eşdeğeri kontrol edin veya SSH kullanın.

"No results returned. Check that WP-CLI is available." Komut çalıştı ancak hiçbir şey yazdırmadı. Genellikle hiç eşleşme olmayan bir sorgu için doğru davranış.

Komut zaman aşımına uğradı. Konsol komutları 60 saniyeyle sınırlıdır. Büyük bir medya kitaplığını yeniden oluşturmak gibi uzun işlemler, daha uzun bir sınırı kullanan Quick Actions (Hızlı İşlemler) bölümünden veya SSH üzerinden çalıştırılmalıdır.

Hiçbir şey çalışmıyor ve düğmeler devre dışı. Kapsule hesabı rolünüz bu site için salt okunurdur. Bir hesap sahibinden bunu yükselttirmesini isteyin.