كيف تستخدم WP-CLI لإدارة ووردبريس؟

# كيف تستخدم WP-CLI لإدارة ووردبريس؟

**الرابط الدائم المقترح (Slug):** `wordpress-wp-cli-guide`

**وصف الميتا:** تعلّم استخدام WP-CLI لإدارة ووردبريس من الطرفية، مع أوامر للإضافات والقوالب والنظام والمنشورات، ونصائح لتجنب أخطاء الأوامر.

**التصنيف:** الإضافات

**الوسوم:** WP-CLI، ووردبريس للمطورين، إدارة ووردبريس، سطر الأوامر

**الكلمة المفتاحية الرئيسية:** WP-CLI

**كلمات مفتاحية ثانوية:** أوامر WP-CLI، إدارة ووردبريس من الطرفية، WordPress CLI

## مقدمة

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

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

لذلك سنركز على الاستخدام العملي الآمن: نبدأ بالأوامر التي تقرأ المعلومات، ثم ننتقل إلى الأوامر التي تغير الموقع مع خطوات تحقق قبل التنفيذ.

## ما هو WP-CLI؟

WP-CLI اختصار لـ WordPress Command Line Interface. وهي أداة مجانية ومفتوحة المصدر لإدارة مواقع ووردبريس من سطر الأوامر.

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

## ماذا تحتاج قبل استخدامه؟

تحتاج إلى:

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

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

## أول أمر: معرفة إصدار WP-CLI

بعد تثبيته، نفذ:

“`bash
wp –info
“`

سيعرض الأمر معلومات عن بيئة WP-CLI وPHP والنظام، مما يساعدك على التأكد من أن الأداة تعمل.

## تحديد مجلد ووردبريس

يجب تنفيذ معظم أوامر WP-CLI من مجلد يحتوي على تثبيت ووردبريس، أو تمرير المسار المناسب باستخدام `–path`.

مثال:

“`bash
cd /var/www/html
wp core version
“`

إذا كنت في مسار مختلف:

“`bash
wp core version –path=/var/www/html
“`

استخدم المسار الحقيقي لموقعك بدل المثال.

## معرفة إصدار ووردبريس

الأمر البسيط هو:

“`bash
wp core version
“`

هذه من أفضل الأوامر للبدء لأنها لا تغير شيئًا في الموقع.

## عرض الإضافات

استخدم:

“`bash
wp plugin list
“`

سيعرض عادة الاسم والحالة والإصدار ومعلومات أخرى بحسب إعدادات الأمر.

يمكنك تحديد إضافة واحدة:

“`bash
wp plugin get plugin-slug
“`

واستخدم اسم الـslug الصحيح للإضافة، وليس الاسم الظاهر فقط في الواجهة.

## معرفة الإضافات القابلة للتحديث

لعرض ما يمكن تحديثه قبل تنفيذ أي تغيير:

“`bash
wp plugin update –all –dry-run
“`

فكرة `–dry-run` مهمة جدًا؛ فهي تسمح لك بمعاينة العملية بدل تنفيذها مباشرة عندما يدعم الأمر هذا الخيار.

بعد مراجعة النتائج، يمكن تحديث إضافة محددة:

“`bash
wp plugin update plugin-slug
“`

وإذا أردت تحديث جميع الإضافات:

“`bash
wp plugin update –all
“`

لا تنفذ التحديث الشامل على موقع حساس دون نسخة احتياطية واختبار مناسب.

## تفعيل وتعطيل الإضافات

لتفعيل إضافة:

“`bash
wp plugin activate plugin-slug
“`

لتعطيلها:

“`bash
wp plugin deactivate plugin-slug
“`

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

## تحديث ووردبريس نفسه

يمكنك معرفة الإصدار أولًا ثم استخدام:

“`bash
wp core check-update
“`

لرؤية ما إذا كان هناك تحديث متاح.

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

“`bash
wp core update
“`

بعد التحديث اختبر الموقع، ولا تعتبر نجاح الأمر في الطرفية دليلًا على أن كل وظائف الموقع تعمل.

## إدارة القوالب

لعرض القوالب:

“`bash
wp theme list
“`

ولمعرفة تفاصيل قالب:

“`bash
wp theme get theme-slug
“`

يمكنك أيضًا تفعيل قالب معروف:

“`bash
wp theme activate theme-slug
“`

استخدم هذا على Staging عندما يكون القالب مرتبطًا بتصميم إنتاجي أو بوظائف خاصة.

## عرض المنشورات

يستطيع WP-CLI التعامل مع المحتوى أيضًا. لعرض المنشورات المنشورة مثلًا:

“`bash
wp post list –post_type=post –post_status=publish
“`

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

## إنشاء منشور من الطرفية

في حالة الحاجة إلى إنشاء محتوى عبر عملية إدارية، يمكن استخدام:

“`bash
wp post create –post_title=”عنوان تجريبي” –post_status=draft
“`

الأفضل في العمليات الآلية أن تبدأ بالحالة `draft` عندما تكون المراجعة البشرية مطلوبة، ثم تنشر بعد التأكد من العنوان والمحتوى والتصنيف والبيانات الوصفية.

## البحث داخل الإعدادات

يستطيع WP-CLI التعامل مع خيارات ووردبريس:

“`bash
wp option get siteurl
“`

وهذا يعرض قيمة خيار الموقع. هناك أوامر متعددة لإدارة الخيارات، لكن تعديلها يجب أن يتم بحذر لأن قيمة خاطئة يمكن أن تمنع الموقع من العمل بالطريقة المتوقعة.

## لماذا لا نبدأ بأوامر الحذف؟

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

لذلك استخدم التسلسل:

1. أمر قراءة للتأكد من الحالة.
2. نسخة احتياطية عند الضرورة.
3. أمر تجريبي أو `–dry-run` إن كان مدعومًا.
4. تنفيذ التغيير.
5. تحقق مباشر من النتيجة.

## تنفيذ أوامر على مواقع متعددة

في بيئة MultiSite أو إدارة عدة مواقع، تصبح أتمتة الأوامر أكثر فائدة. لكن قبل تشغيل أمر على عشرات المواقع، اختبره على موقع واحد.

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

لا تضع كلمات مرور أو مفاتيح API داخل Scripts بطريقة مكشوفة. استخدم آليات أسرار وإعدادات بيئية مناسبة لبيئتك.

## WP-CLI وWordPress Multisite

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

قبل تنفيذ أمر في شبكة، حدد هل المطلوب تغيير موقع واحد أم الشبكة كلها. الخطأ في هذا التفريق قد يؤثر في مواقع متعددة.

ابدأ دائمًا باستعلام أو أمر قراءة يوضح نطاق التنفيذ قبل الأمر التغييري.

## التعامل مع أخطاء WP-CLI

عندما يفشل أمر، لا تحاول تكراره بشكل عشوائي. اقرأ رسالة الخطأ أولًا.

ابحث عن:

– هل أنت داخل المسار الصحيح؟
– هل WP-CLI يستطيع تحميل ووردبريس؟
– هل إصدار PHP مناسب؟
– هل الإضافة أو القالب موجود فعلًا؟
– هل لديك صلاحية كتابة؟
– هل المشكلة من الخادم أم من ووردبريس نفسه؟

إذا كان الأمر يحتاج إلى الاتصال بقاعدة البيانات، راجع إعدادات الاتصال وسجل الخادم بدل تغيير `wp-config.php` عشوائيًا.

## مثال على مهمة صيانة بسيطة

افترض أنك تريد فحص حالة الإضافات في موقع قبل تحديثها. يمكنك تنفيذ:

“`bash
wp core version
wp plugin list
wp plugin update –all –dry-run
“`

بعد مراجعة النتائج، تأخذ نسخة احتياطية، ثم تحدّث ما تحتاجه، ثم تختبر الصفحات الأساسية.

هذا أسلوب أفضل من تشغيل تحديث شامل أولًا ثم البحث عن سبب التعطل إذا حدث.

## متى تستخدم WP-CLI بدل لوحة التحكم؟

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

المطور الذي يتقن الاثنين يستطيع اختيار الأداة الأنسب بدل الاعتماد على طريقة واحدة لكل شيء.

## عادات أمان مهمة

– نفذ الأوامر بحساب وصلاحيات مناسبة.
– لا تلصق أوامر غير مفهومة في خادم الإنتاج.
– راجع المسار قبل أي أمر تغييري.
– خذ نسخة احتياطية للعمليات الحساسة.
– استخدم Staging للتجارب.
– لا تخزن الأسرار داخل Scripts عامة أو مستودعات مكشوفة.
– استخدم `–dry-run` عندما يكون متاحًا ومناسبًا.

## أسئلة شائعة

### هل WP-CLI مناسب للمبتدئين؟

يمكن تعلمه تدريجيًا. ابدأ بأوامر القراءة مثل `wp core version` و`wp plugin list`، ثم انتقل إلى أوامر التغيير بعد فهم أثرها.

### هل يمكن إدارة ووردبريس دون لوحة التحكم باستخدام WP-CLI؟

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

### هل WP-CLI خطر؟

الأداة نفسها ليست المشكلة. الخطر يأتي من تنفيذ أوامر تغييرية دون فهم نطاقها أو دون نسخة احتياطية مناسبة.

### ما فائدة dry-run؟

عندما يدعم الأمر هذا الخيار، يسمح لك بمعاينة العملية أو تقدير ما سيحدث قبل تنفيذ التغيير الفعلي.

### هل يمكن استخدام WP-CLI مع WordPress Multisite؟

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

## الخاتمة

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

ابدأ بخمسة أوامر فقط: `wp –info`، `wp core version`، `wp plugin list`، `wp theme list` و`wp plugin update –all –dry-run`. عندما تصبح هذه الأوامر مألوفة، يمكنك توسيع معرفتك تدريجيًا نحو الأتمتة والصيانة المتقدمة.

## اقتراحات الربط الداخلي

– **أفضل طريقة لتثبيت وإدارة إضافات ووردبريس** — نص الرابط: «إدارة الإضافات وتحديثها».
– **إنشاء إضافة ووردبريس بسيطة للمبتدئين** — نص الرابط: «تطوير إضافة ووردبريس».
– **دليل إدارة WordPress Multisite للمطورين وأصحاب الشبكات** — نص الرابط: «إدارة شبكة WordPress Multisite».

## Alt Text مقترح للصور

– نافذة طرفية تعرض أمر wp –info.
– نتيجة wp plugin list في موقع ووردبريس.
– معاينة تحديثات الإضافات باستخدام WP-CLI وdry-run.
– قائمة قوالب ووردبريس عبر WP-CLI.
– تشغيل أمر WP-CLI من مجلد موقع ووردبريس.