ما هي أداة WP-CLI، وما أهميتها لمطوري ووردبريس؟

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

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

ما هي WP-CLI؟

WP هي اختصار لكلمة ووردبريس WordPress، وكلمة CLI هي اختصار لعبارة (Command Line Interface) أي واجهة سطر الأوامر.
وبالتالي أداة WP-CLI: هي واجهة سطر أوامر خاصة بالووردبريس، وهي أداة تسمح للمطورين بالقيام بالعديد من المهام المتعلقة بووردبريس من خلال كتابة أوامر نصية مختلفة دون الحاجة لأن يتنقلو ضمن شاشات متصفح الويب وينقروا بالفأرة من مكان لآخر.

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

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

اقرأ المزيد: إنشاء موقع ووردبريس على الخادم المحلي (LocalHost) باستخدام برنامج XAMPP

طريقة تثبيت WP-CLI

إن أداة WP-CLI مصممة بشكل أساسي لنظام التشغيل UNIX والأنظمة الموافقة له مثل (OS X و Linux) وتمكمن المطور من الوصول إلى مواقع ووردبريس البعيدة عبر بروتوكول SSH ، لكن من الممكن كذلك تثبيت أداة WP-CLI وتشغيلها نظام التشغيل ويندوز كما سنشرح في هذه الفقرة.

لتثبيت الأداة على جهازك المحلي الذي يستخدم نظام ويندوز قم بداية بتحميل الملف wp-cli.phar على جهازك المحلي من هنا، كما يمكنك تحميله مباشرة من داخل موجه سطر أوامر ويندوز CMD.EXE من خلال كتابة التعليمة curl المسؤولة عن نقل البيانات من وإلى الخادم كما يلي:

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

بعد اكتمال تحميل الملف wp-cli.phar، قم بنقله إلى أي مسار تختاره في حاسوبك. على سبيل المثال سأختار إنشاء مجلد في القرص المحلي D باسم wp-cli ثم سأضع الملف بداخله.

بعدها عليك أن تضيف مسار الملف d:\wp-cli إلى متغير البيئة path في نظام التشغيل، ويمكن القيام بذلك من خلال النقر بزر الماوس الأيمن فوق أيقونة جهاز الكمبيوتر على سطح المكتب، واختيار خصائص< ثم إعدادات النظام المتقدمة< كما هو مبين في الصورة التالية.

بعدها انقر فوق متغيرات البئية واختر المتغير path، وانقر على زر جديد ثم أضف هنا مسار الملف wp-cli.phar من أجل تمكين الوصول إليه وتشغيل أوامره من داخل أي دليل في سطر الأوامر.

الخطوة التالية هي إنشاء ملف دفعي wp.bat في نفس المجلد الذي وضعت فيه الملف wp-cli.phar كي تجعل هذا الملف قابل للتنفيذ، لذا أنشئء ملف فارغ باسم wp.bat، وقم بالنقر فوقه بزر الماوس الأيمن واختر تحرير ثم اكتب داخله الأوامر التالية:

@ECHO OFF
php "d:/wp-cli/wp-cli.phar" %*
setx path "%path%;d:\wp-cli"

بالطبع عليك تعديل المسار في الأوامر السابقة حسب الموقع الذي أضفت ملفك له.

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

wp --info

إذا تمت المهمة بنجاح فستظهر لك معلومات حول نظام تشغيلك، وإصدار PHP الذي تستخدمه، وإصدار WP-CLI كما في الشاشة التالي:

أو يمكنك كتابة التعليمة التالية للتحقق من عمل الأداة بشكل صحيح:

wp cli version

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

يمكنك تحميل نظام ووردبريس على سيرفر الاستضافة الخاص بك أو على حاسوبك المحلي (بعد أن تكون قد حولته لسيرفر كما ذكرنا بداية باستخدام برامج المحاكاة مثل XAMPP) وذلك من خلال التعليمة wp core download وفي مقالنا اليوم سنطبق التعليمات على خادم محلي.

لكن في حال كنت تريد الاتصال بالخادم الفعلي (وهنا أقصد الخادم البعيد الخاص بالاستضافة) من خلال الأداة WP-CLI وتثبيت نظام ووردبريس عليه يجب أن تملك صلاحية الوصول للسيرفر عبر بروتوكول SSH (Secure Shell) الذي يقوم بتشفير الأوامر ونقل البيانات من وإلى الخادم الخاص بك ويوفر وصول آمن إلى الخادم وتنفيذ أوامر مباشرة عليه.

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

اقرأ المزيد: شرح SSH وأهمية استخدامه لأصحاب مواقع الووردبريس

لنعد الآن للتعليمة wp core download ونثبت ووردبريس على الخادم من خلالها، وانتبه قبل كتابة هذه التعليمة في موجه الأوامر يجب أن  تتأكد من أنك موجود داخل المجلد الجذر للخادم (docroot)، ويمكنك إذا رغبت إنشاء مجلد فرعي خاص بالموقع داخل المجلد الجذر لتنظيم الأمور وهنا سأنشئ مجلد باسم olablog ثم يمكنك بعدها تحميل كور ووردبريس ضمنه وذلك بكتابة التعليمات التالية:

cd C:\xampp\htdocs
mkdir blog
cd olablog
wp core download

بعد اكتمال عملية التحميل بنجاح ستظهر لك رسالة توضيحية في موجه سطر الأوامر كما يلي:

والآن إذا انتقلت لهذا الدليل أو المجلد الذي أنشأته للتو، ستجد أن كافة ملفات أحدث إصدار من نواة نظام ووردبريس قد تم تحميلها بشكل كامل هنا.

اقرأ المزيد: تعرف على نظام برمجة ووردبريس وملفاته الأساسية

وفي حالتنا سيكون موقع وودربريس الخاص بك موجودًا على الرابط التالي: www.yourdomin.com/olablog
وعند الانتقال لهذا الرابط ستظهر رسالة الترحيب الخاصة بتثبيت نظام ووردبريس التي تطالبنا بإدخال معلومات حول المواقع وقاعدة البيانات الخاصة به.

لذلك يتعين عليك الآن إنشاء قاعدة البيانات باستخدام phpMyAdmin ولتكن باسم olablog_db، وبعدها يمكنك إكمال عملية إعداد ووردبريس من خلال شاشة التثيبت.

كما يمكنك كذلك إعداد ملف wp-config.php الخاص بموقعك من خلال كتابة التعليمة wp core config داخل الأداة WP-CLI نفسها وتمرير بيانات اعتماد قاعدة البيانات الخاصة بك كالتالي:

wp core config --dbname=database_name --dbuser=database_user --dbpass=user_password --dbhost=localhost --dbprefix=wp_
  1. -dbname اسم قاعدة البيانات
  2. –dbuser اسم مستخدم قاعدة البيانات
  3. –dbpass كلمة المرور
  4. –dbhost اسم المستضيف لقاعدة البيانات
  5. –dbprefix بادئة الجدول (مطلوبة في حال رغبت في تركيب أكثر من موقع على نفس قاعدة البيانات)

كما تلاحظ عليك تمرير نفس البيانات التي تكتبها عادة في واجهة إعداد قاعدة بيانات ووردبريس لكن بشكل أوامر نصية

وفي حالتنا ستكون البيانات المررة للتعليمة بالشكل التالي:

wp core config --dbname=olablog --dbuser=root --dbpass=root--dbhost=localhost --dbprefix=wp_

ملاحظة:

في حال ظهرت لك رسالة الخطأ التالية mysql’ is not recognized as an internal or external command’ فقم في هذه الحالة إضافة مسار MySQL التالي إلى متغير البيئة path وجرب الرجوع إلى إصدار PHP 7 لأن الأداة غير متوافقة مع PHP 8 بشكل جيد.

c:\xampp\mysql\bin

بعد تنفيذ هذه التعليمة سيتم إنشاء ملف wp-config.php باستخدام بيانات الاعتماد الصحيحة، وسيكون عليك متابعة إعداد نظام ووردبريس وكتابة تعليمة تثبيت ووردبريس مع تمرير المعلومات الخاصة بموقع الويب وبيانات أدمن الموقع كالتالي.

wp core install --url=localhost/olablog --title=localhost/olablog --admin_user=admin --admin_password=olaAdmin123# --admin_email=example@example.com

وهذه التعليمة كذلك تكافئ كما تلاحظ إدخال البيانات الخاصة بالموقع في شاشة تثبيت ووردبريس التالية:

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

أمثلة على أهم تعليمات الأداة WP-CLI

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

تثبيت وتفعيل إضافة جديدة في الموقع

يمكنك تثبيت الإضافات وتفعيلها باستخدام التعليمة wp plugin install التي يمكنك أن تمرر لها كبرامتر الاسم اللطيف slug للإضافة، أو ملف ZIP الخاص بالإضافة، أو عنوان URL الخاص بها.

على سبيل المثال يمكننا تنصيب إضافة contact-form-7 في موقعنا olablog من خلال التعليمة التالية:

wp plugin install contact-form-7

ولتفعيل الإضافة نكتب التعليمة wp plugin activat

wp plugin activate contact-form-7

كما يمكنك تثبيت وتفعيل عدة إضافات بنفس الوقت على موقعك كما يلي:

wp plugin install contact-form-7 really-simple-ssl jetpack --activate

ومن أجل إلغاء تفعيل الإضافة استخدم التعليمة wp plugin deactivat

wp plugin deactivate contact-form-7

ولتفعيل/إلغاء تفعيل كافة الإضافات دفعة واحدة اكتب:

wp plugin activate --all
wp plugin deactivate --all 

إذا قمت بتفعيل الإضافة ثم انتقلت إلى لوحة التحكم واستعرضت الإضافات المثبتة على موقعك ستجد أن الإضافة contact-form-7 قد تم تثبيتها وتنشيطها بالفعل على موقعك ولم تحتج سوى لكتابة تعليمتين بسيطتتين فقط لإنجاز المهمة.

لاستعراض لائحة بأسماء كافة الإضافات المثبتة على موقعك وحالتها وإصدارها يمكنك كتابة التعليمة wp plugin list كما يلي:

بنفس الطريقة يمكنك تثبيت وتفعيل القوالب في ووردبريس مع استبدال كلمة plugin في التعليمات السابقة بكلمة theme. على سبيل المثال لتثبيت وتفعيل قالب أسترا نكتب:

wp theme install astra
wp theme activate astra

تعليمات نواة ووردبريس wp core

يمكنك باستخدام WP-CLI فحص وجود ملفات معطوبة أو معدلة في نظام ووردبريس الأساسي والتحقق من سلامته من خلال التعليمة التالية:

wp core verify-checksums

ويمكنك استعادة ووردبريس لإصدار سابق من خلال كتابة التعليمة التالية:

wp core update --version=6.0.0 --force

كما يمكنك إعادة تثبيت نسخة نظيفة لنواة ووردبريس في موقعك بدون القوالب الافتراضية والإضافات كما يلي:

wp core download --skip-content --force

وأخيرًا يمكنك مسح ذاكرة التخزين المؤقت الافتراضية لموقع ووردبريس باستخدام التعليمة التالية:

wp cache flush

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

يمكنك الاطلاع على قائمة بكافة الأوامر التي يمكنك تطبيقها على موقعك من خلال كتابة التعليمة wp help وستعرضها لك الأداة مرتبة وفق الترتيب الأبجدي كما يلي:

الخلاصة

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

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

المجتمع الأكبر عربيًا لمستخدمي ووردبريس

انضم لمجتمع عرب ووردبريس الأكبر عربيًا لدعم مستخدمي ووردبريس. من خلال المجتمع ستحصل على المساعدة اللازمة في إنشاء موقعك الووردبريس أو تخصيص متجرك على ووكومرس

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