KPanel, WordPress sitenize tarayıcı üzerinden, hiçbir SSH istemcisi ve sunucu girişi olmadan komutlar çalıştıran bir WP-CLI konsolu içerir. Bu kılavuz, konsolu nerede bulacağınızı, tam olarak hangi komutlara neden izin verildiğini, ekrana yerleştirilmiş kısayolları ve konsolun çalıştırmayacağı bir şeye ihtiyaç duyduğunuzda ne yapmanız gerektiğini kapsar.
Konsolu Açma
- KPanel'e giriş yapın ve sol kenar çubuğunda Web Siteleri öğesine tıklayın.
- WordPress sitenize tıklayın.
- WordPress sekmesini, ardından Console bölümünü açın.
Giriş alanı zaten sabit bir wp ile başlar, bu yüzden yalnızca ondan sonra geleni yazarsınız. plugin list, wp plugin list değil. Enter'a basın veya Run düğmesine tıklayın.
Console, yönetilen planlarda görünen bölümlerden biridir. Diğer planlarda sekme şeridi bunun yerine bir +8 on Managed bağlantısıyla biter. Burada açıklanan ve ham bir komut olmayan her işlemin KPanel'in başka bir yerinde eşdeğer bir düğmesi vardır, bu yüzden hiçbir şey erişilemez değildir: konsol, aynı motora ulaşmanın daha hızlı bir yoludur.
Komutlar, sitenizin dizini içinde, sitenizin kendi sistem kullanıcısı olarak çalışır. Başka hiçbir siteyi göremez veya ona dokunamazlar.
Konsol Neleri Çalıştırır, Neleri Çalıştırmaz
Konsol bir izin listesi (allowlist) kullanır. Yalnızca aşağıdaki komut önekleri kabul edilir ve bunun dışındaki her şey, reddettiği komutu belirten bir mesajla, sunucuya ulaşmadan reddedilir.
| Alan | İzin Verilen |
|---|---|
| Çekirdek | core version, core check-update, core update, core is-installed, core verify-checksums |
| Eklentiler | plugin list, plugin update, plugin install, plugin activate, plugin deactivate, plugin status, plugin get, plugin delete, plugin verify-checksums |
| Temalar | theme list, theme update, theme install, theme activate, theme status, theme get, theme delete |
| Kullanıcılar | user list, user get, user create, user update, user set-role, user delete, user reset-password, user add-cap, user remove-cap, user generate |
| Veritabanı | db size, db tables, db optimize, db repair, db check |
| Önbellek ve geçici veriler | cache flush, cache get, cache set, cache add, cache delete, transient get, transient set, transient delete |
| Yeniden yazma kuralları | rewrite flush, rewrite list, rewrite structure |
| Cron | cron event list, cron event run, cron schedule list |
| Yapılandırma | config get, config list, config has, config shuffle-salts |
| Bakım modu | maintenance-mode activate, maintenance-mode deactivate, maintenance-mode status |
| Salt okunur inceleme | option get, option list, post list, post get, comment list, comment get |
| Medya ve dil | media regenerate, language core install, language core update |
| Arama ve değiştirme | search-replace |
Kasıtlı olarak hariç tutulanlar, dahil edilenlerden daha önemlidir:
evalveshellengellenmiştir. Keyfi PHP ve keyfi kabuk komutları, konsolu bir tarayıcı sekmesindeki root isteminin eşdeğeri haline getirirdi.db import,db export,db drop,db queryvedb resetengellenmiştir. İçe aktarma ve sıfırlama, hiçbir onay adımı olmadan bir veritabanını yok eder;db queryise kısıtlanmamış bir SQL istemidir. Bunun yerine phpMyAdmin kullanın: phpMyAdmin ile Veritabanınıza Erişim.config setveconfig deleteengellenmiştir. Hatalı birwp-config.phpyazımı, siteyi çevrimdışı bırakır. Değerleri burada okuyun, dosya yöneticisi üzerinden değiştirin.option updateveoption deleteengellenmiştir. Seçenekleri görmeden düzenlemek, bir siteyi geri dönülemez şekilde bozmanın yaygın bir yoludur.
Konsol, hiçbir komutta sizin için yedek almaz. Bunu yalnızca Hızlı İşlemler bölümündeki düğmeler yapar. search-replace, core update, plugin update, theme update, db optimize veya db repair yapmadan önce, sitenin Yedeklemeler sayfasından kendiniz bir yedek alın. Bkz. Yedek Alma.
Konsolda Çalışma
Ekran, tek seferde tek bir komutu kabul etmekten daha fazlasını yapar.
Hazır ayar düğmeleri. Komut isteminin üzerinde gruplanmış kısayollar bulunur: Performans (önbelleği temizle, geçici verileri temizle, yeniden yazma kurallarını yenile, autoload kontrolü), Veritabanı (optimize et, kontrol et, onar, boyut), Tanılama (WP sürümü, güncellemeleri kontrol et, çekirdeği doğrula, cron olayları), İçerik (eklentileri, temaları, kullanıcıları listele, cron'u şimdi çalıştır), Güvenlik (yönetici kullanıcılar, eklenti sağlama toplamları, salt değerlerini sıfırla, wp-config) ve Bakım (bakım modunu aç ve kapat, küçük resimleri yeniden oluştur, durum). Tek tıklama komutu çalıştırır.
Geçmiş. Bu sitedeki son 50 komutunuz arasında gezinmek için komut isteminde yukarı ve aşağı oklarına basın.
Parçacıklar. Bir komutun yanındaki yer imi simgesine tıklayarak onu bir adla kaydedin, böylece her ay kullandığınız uzun bir çağrı, bir sonraki sefere tek tıklama olur.
Ortam kartı. Komut isteminin üzerinde, bir kart sitenin PHP sürümünü, WordPress sürümünü, bellek sınırını, şu anda kullanılan belleği, maksimum yükleme boyutunu ve çalıştırma süresi sınırını gösterir; bunların tamamını ve etkin eklenti listenizi panoya kopyalayan bir Destek için Kopyala düğmesiyle birlikte. Bunu bir destek talebine yapıştırın, bir gidiş geliş turundan tasarruf etmiş olursunuz.
Çıktıyı kopyala. Her sonuç bloğunun kopyalama ve temizleme düğmeleri vardır.
Çıktı, komut çalışırken geri akar, böylece uzun bir işlem sessizce beklemek yerine ilerleme gösterir.
Bilinmesi Gereken 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 olarak yayınlanan kopyalarla karşılaştırır ve değiştirilmiş herhangi bir şeyi bildirir. Üzerinde oynama yapıldığından şüphelendiğiniz bir sitede yapılacak en hızlı ilk kontroldür.
option list --autoload=yes, WordPress'in her istekte yüklediği her seçeneği listeler. Şişirilmiş bir autoload tablosu, görünür bir nedeni olmadan yavaş olan bir 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, parolalar dahil olmak üzere hesabınızın etkinlik günlüğüne kaydedilir. Bu şekilde belirlediğiniz bir parolayı, giriş yaptıktan sonra değiştirin. Hesap kurtarma hakkında tüm ayrıntılar Kayıp WordPress Yönetici Parolasını Sıfırlama başlıklı makalededir.
Arama ve Değiştirme
search-replace 'http://old-domain.co.nz' 'https://old-domain.co.nz' --all-tables --dry-run
Her zaman önce deneme çalıştırması (dry run) yapın. Ham bir SQL değiştirmenin bir WordPress veritabanını neden bozduğu da dahil olmak üzere tam anlatım Arama ve Değiştirme Çalıştırma başlıklı makalededir.
Konsol mu, Hızlı İşlemler mi?
İkisi de altta aynı WP-CLI'yi çalıştırır. Şu esasa göre seçin:
| Görev | Daha iyi yol |
|---|---|
| Önbelleği temizleme, eklentileri güncelleme, medyayı yeniden oluşturma | Hızlı İşlemler, tek tıklama ve önce yedek alır |
| Tabloya göre önizlemeli arama ve değiştirme | Hızlı İşlemler, Search & Replace kartı |
| Belirli bir bayrak (flag) gerektiren herhangi bir şey | Konsol |
| Listeleme, inceleme, tanılama | Konsol |
| Gecikmiş tek bir cron olayını çalıştırma | Konsol |
wp-config.php düzenleme veya bir veritabanı içe aktarma | İkisi de değil. Dosya yöneticisini veya phpMyAdmin'i kullanın |
İzin Listesinden Fazlasına İhtiyacınız Olduğunda
Kısıtlanmamış WP-CLI için SSH üzerinden bağlanın ve sitenizin dizininden doğrudan wp çalıştırın. SSH yalnızca anahtar kimlik doğrulaması kullanır, bu yüzden önce sitenin Ayarlar bölümünden, ardından SSH Anahtarları sekmesinden genel anahtarınızı ekleyin. Tam ana bilgisayar, bağlantı noktası ve kullanıcı adı dahil bağlantı bilgileri aynı ekranda gösterilir. Bkz. SSH Anahtarları Ekleme ve SFTP Üzerinden Bağlanma.
Sorun Giderme
"'x y' is not in the allowed command list." Komut izin listesinde değildir. En yakın izin verilen eşdeğer için yukarıdaki tabloyu kontrol edin veya SSH kullanın.
"No results returned. Check that WP-CLI is available." Komut çalıştı ama hiçbir şey yazdırmadı. Genellikle eşleşme bulunmayan bir sorgu için doğru davranıştır.
Komut zaman aşımına uğruyor. Konsol komutları 60 saniyeyle sınırlıdır. Büyük bir medya kütüphanesini yeniden oluşturmak gibi uzun işlemler, daha uzun bir sınır kullanan Hızlı İşlemler üzerinden veya SSH üzerinden çalıştırılmalıdır.
Hiçbir şey çalışmıyor ve düğmeler devre dışı. KapsuleHost hesap rolünüz bu site için salt okunurdur. Bir hesap sahibinden bunu yükseltmesini isteyin.