دليلنا لهيكل قيادة WP-CLI

تعد واجهة سطر أوامر WordPress (WP-CLI) أداة رائعة لتحسين سير عمل التطوير لديك. يعد فهم كيفية تنظيم الأوامر أمرًا أساسيًا لاستخدام WP-CLI إلى أقصى إمكاناته. في هذه المقالة ، ستتعلم كيفية بناء أوامر WP-CLI ، بما في ذلك كيفية استخدام الأوامر الرئيسية والفرعية ، بالإضافة إلى المعلمات والمفاتيح.

قبل الغوص في إنشاء الأوامر ، ستحتاج إلى تثبيت WP-CLI. تختلف الطريقة الدقيقة باختلاف نظام التشغيل ، لكن دليلنا لتثبيت وتكوين WP-CLI يحتوي على كل ما تحتاجه.

أوامر الأصل والأوامر الفرعية

يتم تنظيم جميع أوامر WP-CLI تقريبًا بنفس الطريقة. يوجد أمر رئيسي لكل مجال أكبر من الوظائف ، مثل wp core للعمل مع تثبيت WordPress الأساسي. يمكن استخدام كل من هذه الأوامر الأصلية مع عدد من الأوامر الفرعية المختلفة ، ويجب استخدامها مع أمر واحد على الأقل.

أوامر الوالدين تضع الأساس

لن يقوم أي أمر من الوالد بأي شيء مفيد من تلقاء نفسه. على سبيل المثال ، إذا حاولت استخدام wp config بمفرده ، فسترى شيئًا مثل هذا:

~ $ wp config
الاستخدام: wp config create --dbname = --dbuser = [--dbpass = ] [--dbhost = ] [--dbprefix = ] [- dbcharset = ] [- dbcollate = ] [- موقع = ] [--extra-php] [--skip-salts] [--skip-check] [--force] [--config-file = ] [--غير آمن]
   أو: wp config delete [- النوع = ] [--config-file = ]
   أو: تعديل التكوين wp [--config-file = ]
   أو: wp config get [- النوع = ] [- تنسيق = ] [--config-file = ]
   أو: wp config has [- النوع = ] [--config-file = ]
   أو: wp config list [ ...] [- الحقول = ] [- تنسيق = ] [- صارم] [--config-file = ]
   أو: مسار التكوين wp
   أو: wp config set [--إضافة] [- سحب] [- anchor = ] [- التنسيب = ] [- فاصل = ] [- النوع = ] [--config-file = ]
   أو: wp config shuffle-salts [ ...] [--فرض] [--config-file = ] [--غير آمن]

راجع "wp help config" للحصول على مزيد من المعلومات حول أمر معين.

يمنحك هذا وحده بعض الأدلة الجيدة حول كيفية استخدام أمر wp config . يمكنك الحصول على فهم أفضل باتباع نصائحه وإدخال wp help config .

اسم

  wp config

وصف

  يولد ويقرأ ملف wp-config.php.

الخلاصة

  wp config

الأقسام الفرعية

  إنشاء يولد ملف wp-config.php.
  حذف يحذف ثابتًا أو متغيرًا معينًا من ملف wp-config.php.
  تحرير يطلق محرر النظام لتحرير ملف wp-config.php.
  الحصول على قيمة ثابت أو متغير محدد في ملف wp-config.php.
  للتحقق مما إذا كان ثابتًا أو متغيرًا معينًا موجودًا في ملف wp-config.php.
  list تسرد المتغيرات والثوابت والملف المعرف في ملف wp-config.php.
  path يحصل على المسار إلى ملف wp-config.php.
  set يضبط قيمة ثابت أو متغير محدد في ملف wp-config.php.
  shuffle-salts يقوم بتحديث الأملاح المحددة في ملف wp-config.php.

المعلمات العالمية

  - المسار =

يوجد أكثر من 40 أمرًا أصليًا في المجموع في تثبيت WP-CLI الأساسي. تضيف بعض المكونات الإضافية الشائعة ، مثل WooCommerce و BuddyPress ، أوامر الوالدين الخاصة بها ، لذلك قد يحتوي تثبيت WordPress على المزيد. في معظم الحالات ، يمكنك معرفة كيفية استخدام الأمر عن طريق إدخال wp help متبوعًا باسم الأمر الأصل.

يساعد فهم القليل حول كيفية تجميعها عند تعلم استخدام WP-CLI. تجدر الإشارة إلى أن أوامر WP-CLI تستخدم دائمًا الأسماء المفردة في الأوامر. على سبيل المثال ، يتم تسمية الأمر الأصل لإدارة المستخدم باسم wp user بدلاً من "wp users". طالما أنك تتذكر ذلك ، فستجد أن حدسك غالبًا ما يكون صحيحًا. أمر إدارة التعليقات هو ، في الواقع ، wp comment و wp cron هو الأمر الذي تستخدمه لإدارة جداول وأحداث WP-Cron.

يمكنك العثور على ورقة الغش مع بعض أوامر الوالدين الأكثر استخدامًا أدناه.

الأوامر الفرعية تعطي التوجيه

كما ذكرت سابقًا ، لا يعمل أي من هذه الأوامر من تلقاء نفسه. نحتاج أيضًا إلى تحديد أمر فرعي إذا كنا سنصل إلى أي مكان. أوصي بشدة بإعداد إكمال علامة التبويب. سيسمح لك ذلك برؤية الأوامر الفرعية بسهولة. على سبيل المثال ، باستخدام إكمال علامة التبويب يمكننا رؤية الأوامر الفرعية للمكوِّن plugin :

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

سيؤدي الضغط على enter دون تحديد الأمر الفرعي إلى مطالبة WP-CLI بتقديم بعض المساعدة الإضافية:

 $ 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] ....

هل لاحظت اختلافًا في كيفية تقديم المعلمات في نص المساعدة أعلاه؟ بعضها مغلف بعلامات < > ، والبعض الآخر مسبوق بشرطة مزدوجة -- . هذه ليست مصادفة. هم أنواع مختلفة من المعلمات. سنعود إلى ذلك بعد قليل.

من الجيد العمل مع WP-CLI ، حيث أنه غالبًا ما يكون قادرًا على إخبارك أكثر قليلاً عن كل أمر فرعي والمعلمات التي يتوقعها. هذا متسق للغاية في جميع أوامر WP-CLI المضمنة. عندما تفشل في كتابة أمر كامل مع جميع المعلمات المتوقعة ، فسوف يخبرك المزيد عما كان يتوقعه.

ورقة الغش WP-CLI للأوامر الشعبية

تُظهر ورقة الغش أدناه بعض الأوامر الفرعية الأكثر شيوعًا والأوامر الأصلية التي تتعامل معها. هناك العديد والعديد من الأوامر الفرعية المتاحة أكثر من تلك المدرجة هنا. تحتوي بعض أوامر الوالدين ، مثل wp comment ، على أكثر من عشرة أوامر فرعية ، في حين أن البعض الآخر ، مثل wp cron ، لديه عدد قليل فقط.

الفسفور الابيض كور

تكوين الفسفور الابيض

موضوع الفسفور الابيض

البرنامج المساعد الفسفور الابيض

المعلمات والمفاتيح

بالإضافة إلى الأمر الأصل والأمر الفرعي ، تحتاج معظم الأوامر إلى معلمة واحدة على الأقل لتتمكن من القيام بشيء مفيد. على سبيل المثال ، إذا كنت ترغب في تثبيت مكون إضافي ، فأنت بحاجة إلى تحديد المكون الإضافي الذي تريد تثبيته. بطبيعة الحال الشيء نفسه ينطبق على تنشيط أو حذف البرنامج المساعد.

هناك ثلاثة أنواع أساسية من المعلمات التي ستستخدمها مع WP-CLI: المعلمات المرتبة والمعلمات المسماة والمفاتيح.

المعلمات المطلوبة

إذا احتاج الأمر إلى أكثر من معلمة عادية ، فيجب دائمًا ترتيبها بشكل صحيح حتى يعمل الأمر. هذا هو سبب تسميتها بالمعلمات المرتبة . يتم فصلهم دائمًا بمسافة واحدة. إذا كانت قيمة المعلمة نفسها تحتوي على مسافات ، فيجب أن تكون محاطة بعلامات اقتباس.

في نص التعليمات الخاص بأمر ما ، يتم إحاطة المعلمات المرتبة بـ < و > . في المثال التالي لمحاولة استخدام wp post get بدون أي معامِلات ، نرى أن id هو معامل مرتب لأنه محصور في < و > .

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

المعلمات المسماة

يعمل WP-CLI أيضًا كثيرًا مع المعلمات المسماة . يمكن إعطاء هذه بأي ترتيب. يتم التعرف على المعلمة المسماة بواسطة الشرطات المزدوجة قبل الاسم ووجود علامة يساوي بين الاسم والقيمة.

على سبيل المثال ، بالنظر إلى نص المساعدة الخاص wp post get أعلاه ، نرى أن معلمات format fields مسبوقة بشرطة مزدوجة. هذه هي الطريقة التي نعرف بها أنها معلمات مسماة لهذا الأمر.

الترتيب حقًا لا يهم:

 # 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

مفاتيح

هناك أيضًا معلمات مسماة تُستخدم فقط للإشارة إلى قيم نوع صواب / خطأ. تسمى هذه بالمفاتيح ولا تحتاج إلى تحديد قيمة. إذا أضفتها إلى سطر الأوامر ، فسيتم فهمها على أنها تعني "صحيح". إذا حذفتها ، فهي "خاطئة".

ربما يكون أفضل تفسير لذلك من خلال بعض الأمثلة:

 # 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

ليس معقدًا جدًا ، أليس كذلك؟ هذا إلى حد كبير هو المعيار بين أدوات سطر الأوامر. لكن دعنا نضيف تفصيلاً أكثر قليلاً.

الحجج العالمية المسماة

يمكن أن تكون الوسيطات المسماة عالمية بمعنى أن العديد من أوامر WP-CLI تستخدمها ، ولها دائمًا نفس السلوك عند استخدامها.

الحجج المسماة الأخرى تكون منطقية فقط لأمر واحد محدد. هذا النوع من الوسيطة المسماة هو في الأساس مجرد معلمة مسماة. في الأمثلة أعلاه ، يكون المعامل --quiet عالميًا لأنه يؤثر على جميع الأوامر بنفس الطريقة. لكن المعلمة --format لا تعتبر عامة لأنها غير منطقية لجميع الأوامر.

كيفية استخدام أوامر WP-CLI

كمثال ، دعنا نلقي نظرة على كيفية استخدام wp-plugin لتثبيت وتفعيل مكون WordPress الإضافي. إلى جانب إدارة المستخدمين ، يعد هذا أحد المجالات الأولى التي يرغب مستخدمو WP-CLI الجدد في التعرف عليها. حتى إذا لم تكن مهتمًا جدًا بإدارة المكونات الإضافية من سطر الأوامر ، فمن الجدير قراءة هذا القسم للاستعداد للعمل مع WP-CLI.

يعد تثبيت مكون إضافي جديد من مستودع WordPress أمرًا سهلاً للغاية. أنت بحاجة إلى أمر رئيسي ( wp plugin ) ، وأمر فرعي ( install ) ، ومعامل مرتب (slug الرسمي للمكوِّن الإضافي) لتثبيت المكون الإضافي. تنشيط المكون الإضافي يستخدم أمرًا مشابهًا ، ولكن باستخدام أمر فرعي مختلف ( activate ).

ضع كل شيء معًا وسترى شيئًا كهذا:

 # 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.

كما ترى ، يعد تثبيت البرنامج المساعد وتنشيطه شيئين منفصلين في WP-CLI ، تمامًا كما هو الحال عند تثبيت مكون إضافي باستخدام واجهة الويب. لكن تثبيت المكون الإضافي ثم تنشيطه مباشرة أمر شائع جدًا لدرجة أن WP-CLI لديه طريقة للقيام بالأمرين معًا في نفس الوقت:

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

يتمثل أحد الأجزاء الصعبة في العثور على الرابط الصحيح للمكوِّن الإضافي الذي تريده. يتم تحديد جميع المكونات الإضافية من خلال slug الرسمي الخاص بها ، ولكن في كثير من الحالات ، لا تشبه سبيكة slug الاسم الرسمي للمكوِّن الإضافي عن بُعد. يحتوي المكون الإضافي Yoast SEO الشهير على slug wordpress-seo . الرابط الثابت للمكوِّن الإضافي WP Offload Media هو amazon-s3-and-cloudfront .

يتم تعيين Slugs عندما يتم قبول المكونات الإضافية لأول مرة في مستودع مكونات WordPress وتكون المعرفات الفريدة الوحيدة. حتى إذا تغير اسم المكون الإضافي ، فإن الرابط الثابت يظل كما هو. يمكنك دائمًا الانتقال إلى صفحة الويب الخاصة بالمكوِّن الإضافي الريبو والبحث عن المكون الإضافي وإلقاء نظرة على المسار في عنوان URL:

إنه يعمل ، لكنه يفتقر إلى الجودة ويخرجك من جهازك. إليك الطريقة الصحيحة للقيام بذلك باستخدام أمر search الفرعي الخاص بـ WP-CLI:

 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 | | +-----------------------------------------------------------------------+--------------------------+

إذا كنت حريصًا على معرفة المزيد حول إدارة المكونات الإضافية ، فسنغوص في جميع الجوانب الدقيقة لأمر wp plugin في منشور لاحق حول WP-CLI. في الوقت الحالي ، نستخدمها فقط كطريقة لشرح استخدام المعلمات.

تغليف

من المحتمل أن تكون أكبر فائدة ستراها من دمج WP-CLI في سير عمل التطوير الخاص بك هي مدى السرعة التي تتيح لك العمل بها. عمليا أي شيء يمكنك القيام به من مدير WordPress يمكن إنجازه في وقت أقل باستخدام سطر الأوامر.

بمجرد أن تعرف الأساسيات ، يمكنك أن تأخذ WP-CLI إلى أبعد من ذلك مع قائمة حزم WP-CLI التي لا يمكننا العيش بدونها.

يعد فهم كيفية تنظيم الأوامر والأوامر الفرعية والمعلمات أمرًا أساسيًا للحصول على الراحة مع WP-CLI. أعتزم تزويدك بالمعرفة الأساسية التي تحتاجها لبدء التجربة بنفسك. إذا كان لديك أي أسئلة حول كيفية هيكلة أوامر WP-CLI أو معلماتك أو أي شيء آخر متعلق بـ WP-CLI ، فيرجى إبلاغي بذلك في التعليقات.