# استخدام WP-CLI على موقع ووردبريس الخاص بك

Source: https://support.kapsulehost.com/ar-ae/wordpress-wp-cli

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

## فتح الوحدة الطرفية

1. سجّل الدخول إلى [KPanel](https://kpanel.kapsulehost.com) وانقر على **المواقع** في الشريط الجانبي الأيسر.
2. انقر على موقع WordPress الخاص بك.
3. افتح تبويب **WordPress**، ثم قسم **Console**.

![وحدة WP-CLI الطرفية على موقع WordPress في KPanel](https://support.kapsulehost.com/help/screenshots/wordpress-wp-cli.c3f61741.webp)

يبدأ الإدخال بالفعل بـ `wp` ثابت، لذا لا تكتب إلا ما يأتي بعده. `plugin list`، وليس `wp plugin list`. اضغط على Enter أو انقر على **Run**.

> **Note:** **Console** هو أحد الأقسام التي تظهر في الخطط المُدارة. في الخطط الأخرى، ينتهي شريط التبويبات برابط **+8 on Managed** بدلاً من ذلك. كل إجراء موصوف هنا وليس أمراً خاماً له زر مكافئ في مكان آخر من KPanel، فلا شيء خارج متناولك: الوحدة الطرفية هي مجرد طريقة أسرع للوصول إلى المحرك نفسه.

تُنفَّذ الأوامر باسم مستخدم النظام الخاص بموقعك، داخل دليل موقعك. ولا يمكنها رؤية أو لمس أي موقع آخر.

## ما الذي تُنفّذه الوحدة الطرفية وما الذي لا تُنفّذه

تستخدم الوحدة الطرفية قائمة سماح. لا يُقبل إلا بادئات الأوامر أدناه، وأي شيء آخر يُرفض قبل وصوله إلى الخادم مع رسالة تُسمّي الأمر الذي رفضته.

| المجال | المسموح به |
|---|---|
| النواة | `core version`, `core check-update`, `core update`, `core is-installed`, `core verify-checksums` |
| الإضافات | `plugin list`, `plugin update`, `plugin install`, `plugin activate`, `plugin deactivate`, `plugin status`, `plugin get`, `plugin delete`, `plugin verify-checksums` |
| القوالب | `theme list`, `theme update`, `theme install`, `theme activate`, `theme status`, `theme get`, `theme delete` |
| المستخدمون | `user list`, `user get`, `user create`, `user update`, `user set-role`, `user delete`, `user reset-password`, `user add-cap`, `user remove-cap`, `user generate` |
| قاعدة البيانات | `db size`, `db tables`, `db optimize`, `db repair`, `db check` |
| التخزين المؤقت والبيانات العابرة | `cache flush`, `cache get`, `cache set`, `cache add`, `cache delete`, `transient get`, `transient set`, `transient delete` |
| قواعد إعادة الكتابة | `rewrite flush`, `rewrite list`, `rewrite structure` |
| Cron | `cron event list`, `cron event run`, `cron schedule list` |
| الإعداد | `config get`, `config list`, `config has`, `config shuffle-salts` |
| وضع الصيانة | `maintenance-mode activate`, `maintenance-mode deactivate`, `maintenance-mode status` |
| فحص للقراءة فقط | `option get`, `option list`, `post list`, `post get`, `comment list`, `comment get` |
| الوسائط واللغة | `media regenerate`, `language core install`, `language core update` |
| البحث والاستبدال | `search-replace` |

الاستثناءات المتعمَّدة أهم من الأوامر المُدرَجة:

- **`eval` و`shell`** محظوران. فتنفيذ PHP أو أوامر shell عشوائية سيجعل الوحدة الطرفية مكافئة لموجه جذر (root) داخل تبويب متصفح.
- **`db import` و`db export` و`db drop` و`db query` و`db reset`** محظورة. فالاستيراد وإعادة التعيين يُتلفان قاعدة البيانات دون أي خطوة تأكيد؛ و`db query` هو موجه SQL غير مقيّد. استخدم phpMyAdmin بدلاً من ذلك: [الوصول إلى قاعدة بياناتك عبر phpMyAdmin](https://support.kapsulehost.com/ar-ae/sites-phpmyadmin).
- **`config set` و`config delete`** محظوران. فأي كتابة خاطئة في `wp-config.php` تُخرج الموقع عن الخدمة. اقرأ القيم هنا، وغيّرها من خلال مدير الملفات.
- **`option update` و`option delete`** محظوران. فتعديل الخيارات بشكل أعمى طريقة شائعة لتعطيل موقع بشكل يصعب إصلاحه.

> **Warning:** لا تأخذ الوحدة الطرفية نسخة احتياطية عنك في أي أمر. الأزرار الموجودة في قسم **الإجراءات السريعة** هي وحدها التي تفعل ذلك. قبل تنفيذ `search-replace` أو `core update` أو `plugin update` أو `theme update` أو `db optimize` أو `db repair`، خذ نسخة احتياطية بنفسك من صفحة **النسخ الاحتياطية** الخاصة بالموقع. راجع [أخذ نسخة احتياطية](https://support.kapsulehost.com/ar-ae/taking-a-backup).

## العمل في الوحدة الطرفية

الشاشة تقدّم أكثر من مجرد قبول أمر واحد في كل مرة.

**أزرار جاهزة مسبقاً.** تظهر اختصارات مجمّعة أعلى موجه الأوامر: الأداء (تفريغ ذاكرة التخزين المؤقت، مسح البيانات العابرة، تفريغ قواعد إعادة الكتابة، فحص التحميل التلقائي)، وقاعدة البيانات (تحسين، فحص، إصلاح، الحجم)، والتشخيص (إصدار WordPress، فحص التحديثات، التحقق من النواة، أحداث cron)، والمحتوى (عرض قائمة الإضافات والقوالب والمستخدمين، تشغيل cron الآن)، والأمان (مستخدمو الإدارة، التحقق من سلامة الإضافات، إعادة تعيين الـ salts، wp-config)، والصيانة (تفعيل وإلغاء تفعيل وضع الصيانة، إعادة توليد الصور المصغّرة، الحالة). نقرة واحدة تُنفّذ الأمر.

**السجل.** اضغط على السهمين لأعلى ولأسفل في موجه الأوامر للتنقّل بين آخر 50 أمراً نفّذتها على هذا الموقع.

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

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

**نسخ المخرجات.** تحتوي كل كتلة نتائج على أزرار نسخ ومسح.

تتدفّق المخرجات أثناء تنفيذ الأمر، لذا تُظهر العملية الطويلة تقدماً بدلاً من البقاء صامتة.

## أوامر يستحق معرفتها

### التشخيص

```
core version
core verify-checksums
plugin verify-checksums --all
plugin list --status=active --format=table
db size --tables
option list --autoload=yes
```

`verify-checksums` يقارن ملفات النواة والإضافات لديك بالنسخ الرسمية المنشورة ويُبلغ عن أي شيء مُعدَّل. إنه أسرع فحص أولي لموقع تشك في أنه تم العبث به.

`option list --autoload=yes` يسرد كل خيار يُحمّله WordPress مع كل طلب. جدول التحميل التلقائي المتضخّم من أكثر الأسباب شيوعاً لموقع بطيء دون سبب ظاهر.

### الصيانة الدورية

```
cache flush
transient delete --all
rewrite flush
db optimize
cron event list
cron event run --due-now
```

### المستخدمون

```
user list --role=administrator --format=table
user create jo jo@example.com --role=editor
user update 4 --user_pass='a-long-unique-password'
```

كل ما يُكتب هنا يُسجَّل في سجل نشاط حسابك، بما في ذلك كلمات المرور. غيّر أي كلمة مرور ضبطتها بهذه الطريقة فور تسجيل الدخول. التفاصيل الكاملة حول استعادة الحساب موجودة في [إعادة تعيين كلمة مرور مدير WordPress المفقودة](https://support.kapsulehost.com/ar-ae/wordpress-reset-password).

### البحث والاستبدال

```
search-replace 'http://old-domain.co.nz' 'https://old-domain.co.nz' --all-tables --dry-run
```

نفّذ دائماً تشغيلاً تجريبياً (dry run) أولاً. الشرح الكامل، بما في ذلك سبب إتلاف الاستبدال المباشر عبر SQL لقاعدة بيانات WordPress، موجود في [تنفيذ عملية بحث واستبدال](https://support.kapsulehost.com/ar-ae/wordpress-search-replace).

## الوحدة الطرفية أم Quick Actions؟

كلاهما يُشغّل نفس محرك WP-CLI في الخلفية. اختر بناءً على ما يلي:

| المهمة | المسار الأفضل |
|---|---|
| تفريغ ذاكرة التخزين المؤقت، تحديث الإضافات، إعادة توليد الوسائط | **الإجراءات السريعة**، نقرة واحدة وتأخذ نسخة احتياطية أولاً |
| البحث والاستبدال مع معاينة حسب الجدول | **الإجراءات السريعة**، بطاقة Search & Replace |
| أي شيء يتطلب علامة محددة | الوحدة الطرفية |
| العرض والفحص والتشخيص | الوحدة الطرفية |
| تنفيذ حدث cron واحد متأخر | الوحدة الطرفية |
| تعديل `wp-config.php` أو استيراد قاعدة بيانات | لا هذا ولا ذاك. استخدم مدير الملفات أو phpMyAdmin |

## عندما تحتاج إلى أكثر من قائمة السماح

للحصول على WP-CLI غير مقيّد، اتصل عبر SSH ونفّذ `wp` مباشرة من دليل موقعك. يستخدم SSH المصادقة بالمفتاح فقط، لذا أضف مفتاحك العام أولاً من **الإعدادات** الخاصة بالموقع، ثم تبويب **مفاتيح SSH**. تفاصيل الاتصال، بما في ذلك المضيف والمنفذ واسم المستخدم بالضبط، تظهر على نفس تلك الشاشة. راجع [إضافة مفاتيح SSH](https://support.kapsulehost.com/ar-ae/adding-ssh-keys) و[الاتصال عبر SFTP](https://support.kapsulehost.com/ar-ae/sftp-access).

## استكشاف الأخطاء وإصلاحها

**"'x y' is not in the allowed command list."** الأمر ليس ضمن قائمة السماح. راجع الجدول أعلاه لإيجاد أقرب أمر مكافئ مسموح به، أو استخدم SSH.

**"No results returned. Check that WP-CLI is available."** تم تنفيذ الأمر لكنه لم يطبع شيئاً. هذا سلوك صحيح عادةً لاستعلام لا توجد له نتائج مطابقة.

**انتهاء مهلة الأمر.** أوامر الوحدة الطرفية محدودة بـ 60 ثانية. العمليات الطويلة مثل إعادة توليد مكتبة وسائط كبيرة ينبغي تنفيذها من **الإجراءات السريعة**، التي تستخدم حداً زمنياً أطول، أو عبر SSH.

**لا شيء يعمل والأزرار معطّلة.** دور حسابك في KapsuleHost للقراءة فقط بالنسبة لهذا الموقع. اطلب من مالك الحساب رفع صلاحياتك.