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

KPanel includes a WP-CLI console that runs commands against your WordPress site from the browser, with no SSH client and no server login. This guide covers where to find it, exactly which commands…

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

فتح وحدة التحكم

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

وحدة تحكم WP-CLI على موقع WordPress في KPanel

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

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 التعسفي والقشرة التعسفية ستجعل وحدة التحكم معادلة لموجه جذر في علامة تبويب المتصفح.
db import, db export, db drop, db query و db reset محظورة. الاستيراد والإعادة تدمر قاعدة البيانات بدون خطوة تأكيد؛ db query هو موجه SQL غير مقيد. استخدم phpMyAdmin بدلاً من ذلك: الوصول إلى قاعدة البيانات الخاصة بك باستخدام phpMyAdmin.
config set و config delete محظورة. كتابة wp-config.php سيئة تأخذ الموقع إلى وضع عدم الاتصال. اقرأ القيم هنا، غير القيم من خلال مدير الملفات.
option update و option delete محظورة. تحرير الخيارات بشكل أعمى هو طريقة شائعة لكسر موقع بما يتجاوز الاسترجاع.

وحدة التحكم لا تأخذ نسخة احتياطية لك على أي أمر. فقط الأزرار في قسم Quick Actions تفعل ذلك. قبل search-replace, core update, plugin update, theme update, db optimize أو db repair، احم موقعك بنفسك من علامة تبويب Backups الخاصة بالموقع. انظر أخذ نسخة احتياطية.

العمل في وحدة التحكم

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

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

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

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

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

نسخ الإخراج. كل كتلة نتيجة لها أزرار نسخ وحذف.

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

أوامر جديرة بالمعرفة

التشخيص

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 الإدارية المفقودة.

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

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

شغل دائمًا الجفاف أولاً. الشرح الكامل، بما في ذلك السبب في أن استبدال SQL الخام يفسد قاعدة بيانات WordPress، موجود في تشغيل البحث والاستبدال.

وحدة التحكم أم Quick Actions؟

كلاهما يشغل نفس WP-CLI تحتها. اختر على هذا الأساس:

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

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

للحصول على WP-CLI غير مقيد، تصل عبر SSH وشغل wp مباشرة من مجلد موقعك. يستخدم SSH المفاتيح فقط، لذا أضف مفتاحك العام أولاً من علامة تبويب Files للموقع، ثم SSH Keys. تُعرض تفاصيل الاتصال، بما في ذلك المضيف والمنفذ واسم المستخدم بالضبط، على نفس الشاشة. انظر إضافة مفاتيح SSH و الاتصال عبر SFTP.

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

"'x y' غير موجود في قائمة الأوامر المسموحة." الأمر ليس في قائمة السماح. تحقق من الجدول أعلاه للحصول على أقرب مكافئ مسموح به، أو استخدم SSH.

"لم يتم إرجاع أي نتائج. تحقق من أن WP-CLI متاح." الأمر تشغل ولكن لم يطبع أي شيء. عادة السلوك الصحيح للاستعلام بدون تطابقات.

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

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