WP-CLI Komut Yapısı Kılavuzumuz

WordPress komut satırı arayüzü (WP-CLI), geliştirme iş akışınızı geliştirmek için inanılmaz bir araçtır. Komutların nasıl yapılandırıldığını anlamak, WP-CLI'yi tam potansiyeliyle kullanmanın anahtarıdır. Bu makalede, üst ve alt komutların yanı sıra parametreler ve anahtarların nasıl kullanılacağı da dahil olmak üzere WP-CLI komutlarının nasıl yapılandırılacağını öğreneceksiniz.

Komut oluşturmaya başlamadan önce WP-CLI'yi yüklemeniz gerekir. Kesin yöntem işletim sistemine göre farklılık gösterir, ancak WP-CLI'yi yükleme ve yapılandırma kılavuzumuz ihtiyacınız olan her şeye sahiptir.

Üst Komutlar ve Alt Komutlar

Neredeyse tüm WP-CLI komutları aynı şekilde yapılandırılmıştır. Çekirdek WordPress kurulumuyla çalışmak için wp core gibi daha geniş her işlevsellik alanı için bir üst komut vardır. Bu ana komutların her biri, bir dizi farklı alt komutla kullanılabilir ve en az bir tane ile kullanılmalıdır.

Ebeveyn Komutları Temeli Atıyor

Hiçbir ebeveyn komutu kendi başına yararlı bir şey yapmaz. Örneğin, wp config tek başına kullanmayı denerseniz, şöyle bir şey görürsünüz:

~$ wp yapılandırması
kullanım: wp yapılandırma oluşturma --dbname= --dbuser= [--dbpass= ] [--dbhost= ] [--dbprefix= ] [--dbcharset= ] [--dbcollate= ] [--yerel ayar= ] [--extra-php] [--atlama-tuzları] [--atlama-kontrol] [--force] [--config-file= ] [--güvensiz]
   veya: wp yapılandırma silme [--tipi= ] [--config-dosyası= ]
   veya: wp config edit [--config-file= ]
   veya: wp yapılandırma alma [--tipi= ] [--format= ] [--config-dosyası= ]
   veya: wp yapılandırmasında [--tipi= ] [--config-dosyası= ]
   veya: wp yapılandırma listesi [ ...] [--alanlar= ] [--format= ] [--strict] [--config-file= ]
   veya: wp yapılandırma yolu
   veya: wp yapılandırma seti [--add] [--raw] [--çapa= ] [--yerleşim= ] [--ayırıcı= ] [--tipi= ] [--config-dosyası= ]
   veya: wp config shuffle-tuzları [ ...] [--force] [--config-file= ] [--güvensiz]

Belirli bir komut hakkında daha fazla bilgi için 'wp help config' konusuna bakın.

Bu tek başına size wp config komutunu nasıl kullanacağınız konusunda oldukça iyi ipuçları verir. Tavsiyesini takip ederek ve wp help config girerek daha da iyi bir anlayış elde edebilirsiniz.

İSİM

  wp yapılandırması

TANIM

  wp-config.php dosyasını oluşturur ve okur.

ÖZET

  wp yapılandırması

ALT KOMUTLAR

  create Bir wp-config.php dosyası oluşturur.
  delete wp-config.php dosyasından belirli bir sabiti veya değişkeni siler.
  edit wp-config.php dosyasını düzenlemek için sistem düzenleyiciyi başlatır.
  get wp-config.php dosyasında tanımlanan belirli bir sabitin veya değişkenin değerini alır.
  wp-config.php dosyasında belirli bir sabit veya değişken olup olmadığını kontrol eder.
  list Değişkenleri, sabitleri ve wp-config.php dosyasında tanımlanan dosya içeriğini listeler.
  path wp-config.php dosyasının yolunu alır.
  set wp-config.php dosyasında tanımlanan belirli bir sabitin veya değişkenin değerini ayarlar.
  shuffle-salts wp-config.php dosyasında tanımlanan tuzları yeniler.

KÜRESEL PARAMETRELER

  --yol=

Çekirdek WP-CLI kurulumunda toplamda 40'tan fazla ebeveyn komutu vardır. WooCommerce ve BuddyPress gibi bazı popüler eklentiler kendi ana komutlarını ekler, böylece WordPress kurulumunuz daha da fazlasına sahip olabilir. Çoğu durumda, wp help ve ardından ana komutun adını girerek komutu nasıl kullanacağınızı öğrenebilirsiniz.

Nasıl gruplandıklarını biraz anlamak, WP-CLI kullanmayı öğrenirken yardımcı olur. WP-CLI komutlarının komutlarda neredeyse her zaman tekil isimler kullandığını belirtmekte fayda var. Örneğin, kullanıcı yönetimi için üst komuta "wp users" yerine wp user adı verilir. Bunu hatırladığınız sürece, sezginizin genellikle doğru olduğunu göreceksiniz. Yorumları yönetme komutu aslında wp comment comment'dir ve wp cron , WP-Cron programlarını ve olaylarını yönetmek için kullanacağınız komuttur.

Aşağıda en sık kullanılan ebeveyn komutlarından bazılarını içeren bir hile sayfası bulabilirsiniz.

Alt komutlar yön verir

Daha önce de belirttiğim gibi, bu komutların hiçbiri gerçekten kendi başlarına çalışmıyor. Ayrıca bir yere varacaksak bir alt komut belirtmemiz gerekiyor. Sekme tamamlamayı ayarlamanızı şiddetle tavsiye ederim. Bu, alt komutları kolayca görmenizi sağlar. Örneğin, sekme tamamlamayı kullanarak plugin için alt komutları görebiliriz:

 $ wp plugin [TAB] activate get list toggle auto-updates install path uninstall deactivate is-active search update delete is-installed status verify-checksums

Alt komutu belirtmeden enter tuşuna basmak, WP-CLI'den bazı ek yardımlar sunmasını ister:

 $ wp plugin usage: wp plugin activate [<plugin>...] [--all] [--network] or: wp plugin auto-updates <command> or: wp plugin deactivate [<plugin>...] [--uninstall] [--all] [--network] or: wp plugin delete [<plugin>...] [--all] or: wp plugin get <plugin> [--field=<field>] [--fields=<fields>] [--format=<format>] or: wp plugin install <plugin|zip|url>... [--version=<version>] [--force] [--activate] [--activate-network] [--insecure] ....

Yukarıdaki yardım metninde parametrelerin nasıl sunulduğu konusunda bir fark gördünüz mü? Bazıları < > işaretleri içine alınmıştır, diğerleri çift tire ile önek olarak eklenmiştir -- . Bu bir tesadüf değil; bunlar farklı parametre türleridir. Buna birazdan döneceğiz.

WP-CLI ile çalışmak güzeldir, çünkü genellikle size her bir alt komut ve beklediği parametreler hakkında biraz daha fazla bilgi verebilir. Bu, tüm yerleşik WP-CLI komutları boyunca çok tutarlıdır. Beklenen tüm parametrelerle tam bir komut yazamadığınızda, size ne beklediği hakkında daha fazla bilgi verecektir.

WP-CLI Popüler Komutların Hile Sayfası

Aşağıdaki hile sayfası, daha yaygın olan bazı alt komutları ve birlikte gittikleri ana komutları gösterir. Burada listelenenlerden çok daha fazla alt komut mevcuttur. wp comment gibi bazı üst komutlar bir düzineden fazla alt komuta sahipken, wp cron gibi diğerleri sadece birkaçına sahiptir.

WP Çekirdeği

WP Yapılandırması

WP Teması

WP Eklentisi

Parametreler ve Anahtarlar

Bir üst komuta ve bir alt komuta ek olarak, komutların çoğunun yararlı bir şeyler yapabilmesi için en az bir parametreye ihtiyacı vardır. Örneğin, bir eklenti kurmak istiyorsanız, hangi eklentinin kurulacağını belirtmeniz gerekir. Doğal olarak aynı şey bir eklentiyi etkinleştirmek veya silmek için de geçerlidir.

WP-CLI ile kullanacağınız temel olarak üç tür parametre vardır: sıralı parametreler, adlandırılmış parametreler ve anahtarlar.

Sıralı Parametreler

Bir komutun birden fazla normal parametreye ihtiyacı varsa, komutun çalışması için her zaman doğru şekilde sıralanmaları gerekir. Bu nedenle sıralı parametreler olarak adlandırılırlar. Her zaman tek bir boşlukla ayrılırlar. Parametre değerinin kendisi boşluk içeriyorsa, tırnak içine alınması gerekir.

Bir komutun yardım metninde, sıralı parametreler < ve > ile çevrilidir. Aşağıdaki wp post get herhangi bir parametre olmadan kullanmaya çalışma örneğinde, < ve > içine alındığı için id sıralı bir parametre olduğunu görüyoruz.

 $ wp post get usage: wp post get <id> [--field=<field>] [--fields=<fields>] [--format=<format>]

Adlandırılmış Parametreler

WP-CLI, adlandırılmış parametrelerle de çok çalışır. Bunlar herhangi bir sırayla verilebilir. Adlandırılmış bir parametre, adından önceki çift tire ve ad ile değer arasında eşittir işareti bulunmasıyla tanınır.

Örneğin, yukarıdaki wp post get yardım metnine baktığımızda, format ve fields parametrelerinin önüne çift tire konduğunu görüyoruz. Bu komut için parametreler olarak adlandırıldıklarını bu şekilde biliyoruz.

Sipariş gerçekten önemli değil:

 # This will get the the title field for post id 1 in JSON format $ wp post get 1 --fields=title --format=json # This is the same command, order of named parameters doesn't matter: $ wp post get 1 --format=json --fields=title # This is also exactly the same, you can put named parameters before the ordered ones: $ wp post get --format=json --fields=title 1

Anahtarlar

Yalnızca doğru/yanlış tür değerlerini belirtmek için kullanılan adlandırılmış parametreler de vardır. Bunlara anahtar denir ve belirtilen bir değere ihtiyaç duymazlar. Bunları komut satırına eklerseniz, "doğru" oldukları anlaşılır. Bunları atlarsanız, "yanlış" olurlar.

Belki de bu en iyi birkaç örnekle açıklanabilir:

 # Passing "hello-dolly" as regular ordered parameter $ wp plugin activate hello-dolly # Passing a regular ordered parameter with spaces requires quotes $ wp plugin search "WP Offload Media" # Passing the value 'json' to the named parameter 'format' $ wp plugin list --format=json # Setting the 'quiet' switch to true $ wp plugin activate hello-dolly --quiet

O kadar karmaşık değil, ha? Bu, komut satırı araçları arasında hemen hemen normdur. Ama küçük bir ayrıntı daha ekleyelim.

Genel Adlandırılmış Argümanlar

Adlandırılmış bağımsız değişkenler, birçok WP-CLI komutunun bunları kullanması anlamında genel olabilir ve kullanıldıklarında her zaman aynı davranışa sahiptirler.

Diğer adlandırılmış bağımsız değişkenler yalnızca belirli bir komut için anlamlıdır. Bu tür adlandırılmış bağımsız değişken aslında yalnızca adlandırılmış bir parametredir. Yukarıdaki örneklerde --quiet parametresi globaldir çünkü tüm komutları aynı şekilde etkiler. Ancak --format parametresi, tüm komutlar için bir anlam ifade etmediğinden genel olarak kabul edilmez.

WP-CLI Komutları Nasıl Kullanılır

Örnek olarak, bir WordPress eklentisini kurmak ve etkinleştirmek için wp-plugin nasıl kullanılacağına bakalım. Kullanıcıları yönetmenin yanı sıra bu, yeni WP-CLI kullanıcılarının öğrenmek istediği ilk alanlardan biridir. Eklentileri komut satırından yönetmekle pek ilgilenmiyor olsanız bile, WP-CLI ile çalışmaya ısınmak için bu bölümü okumaya değer.

WordPress deposundan yeni bir eklenti yüklemek çok basittir. Eklentiyi yüklemek için bir üst komuta ( wp plugin ), bir alt komuta ( install ) ve sıralı bir parametreye ( eklentinin resmi slug'u ) ihtiyacınız vardır. Eklentiyi etkinleştirmek benzer bir komut kullanır, ancak farklı bir alt komutla ( activate ).

Her şeyi bir araya getirin ve şöyle bir şey görmelisiniz:

 # Installing a plugin $ wp plugin install hello-dolly Installing Hello Dolly (1.7.2) Downloading installation package from https://downloads.wordpress.org/plugin/hello-dolly.1.7.2.zip... The authenticity of hello-dolly.1.7.2.zip could not be verified as no signature was found. Unpacking the package... Installing the plugin... Plugin installed successfully. Success: Installed 1 of 1 plugins. $ wp plugin activate hello-dolly Plugin 'hello-dolly' activated. Success: Activated 1 of 1 plugins.

Gördüğünüz gibi, bir eklentiyi kurmak ve etkinleştirmek, tıpkı web arayüzünü kullanarak bir eklenti kurduğunuzda olduğu gibi, WP-CLI'de iki ayrı şeydir. Ancak bir eklentiyi kurmak ve ardından doğrudan etkinleştirmek o kadar yaygındır ki, WP-CLI'nin her ikisini de aynı anda yapmanın bir yolu vardır:

 # Installing AND activating a plugin in one go $ wp plugin install --activate hello-dolly

Zor kısımlardan biri, istediğiniz eklenti için doğru sümüklüböceği bulmaktır. Tüm eklentiler, resmi bilgileriyle tanımlanır, ancak çoğu durumda, eklentinin resmi adıyla uzaktan yakından benzerlik göstermez. Çılgınca popüler olan Yoast SEO eklentisi, wordpress-seo eklentisine sahiptir. Kendi eklentimiz olan WP Offload Media eklentisi amazon-s3-and-cloudfront .

Sümüklü böcekler, eklentiler WordPress eklenti deposuna ilk kez kabul edildiğinde atanır ve tek benzersiz tanımlayıcılardır. Eklentinin adı değişse bile sümüklü böcek aynı kalır. Her zaman eklenti deposu web sayfasına gidebilir, eklentiyi arayabilir ve URL'deki yola bakabilirsiniz:

Çalışır, ancak incelikten yoksundur ve sizi terminalinizden çıkarır. WP-CLI'nin search alt komutunu kullanarak bunu yapmanın doğru yolu:

 wp plugin search "wp offload media" --per-page=1 --fields=name,slug Success: Showing 1 of 66 plugins. +-----------------------------------------------------------------------+--------------------------+ | name | slug | +-----------------------------------------------------------------------+--------------------------+ | WP Offload Media Lite for Amazon S3, DigitalOcean Spaces, and Google | amazon-s3-and-cloudfront | | Cloud Storage | | +-----------------------------------------------------------------------+--------------------------+

Eklentileri yönetme hakkında daha fazla bilgi edinmek istiyorsanız, WP-CLI hakkında daha sonraki bir wp plugin komutunun tüm önemli cesur yönlerine dalacağız. Şimdilik bunu sadece parametreleri kullanmayı göstermenin bir yolu olarak kullanıyoruz.

Toplama

WP-CLI'yi geliştirme iş akışınıza entegre etmenin en büyük yararı, muhtemelen ne kadar hızlı çalışmanıza izin vermesidir. Pratik olarak WordPress yöneticisinden yapabileceğiniz her şey, komut satırını kullanarak daha kısa sürede gerçekleştirilebilir.

Temel bilgileri öğrendikten sonra, onsuz yaşayamayacağımız WP-CLI paketleri listemizle WP-CLI'yi daha da ileriye taşıyabilirsiniz.

Komutların, alt komutların ve parametrelerin nasıl yapılandırıldığını anlamak, WP-CLI ile rahat olmanın anahtarıdır. Amacım, kendi başınıza denemeye başlamanız için ihtiyaç duyduğunuz temel bilgileri size sağlamaktır. WP-CLI komutlarınızı, parametrelerinizi veya WP-CLI ile ilgili herhangi bir şeyi nasıl yapılandıracağınızla ilgili herhangi bir sorunuz varsa, lütfen yorumlarda bana bildirin.