WP-CLI هي واجهة سطر الأوامر لـ WordPress. يمكنك تحديث المكونات الإضافية وتكوين عمليات التثبيت متعددة المواقع وغير ذلك الكثير، دون استخدام متصفح الويب.
أصبحت الصيانة المستمرة ممكنة من خلال:
الإصدار المستقر الحالي هو الإصدار 2.11.0. للحصول على الإعلانات، تابع @wpcli على Twitter أو قم بالتسجيل للحصول على تحديثات عبر البريد الإلكتروني. تحقق من خريطة الطريق للحصول على نظرة عامة على ما تم التخطيط له للإصدارات القادمة.
روابط سريعة: استخدام | تثبيت | الدعم | تمديد | المساهمة | الاعتمادات
يوفر WP-CLI واجهة سطر أوامر للعديد من الإجراءات التي قد تقوم بها في مسؤول WordPress. على سبيل المثال، يتيح لك wp plugin install --activate
(doc) تثبيت وتنشيط مكون WordPress الإضافي:
$ wp plugin install user-switching --activate
Installing User Switching (1.0.9)
Downloading installation package from https://downloads.wordpress.org/plugin/user-switching.1.0.9.zip...
Unpacking the package...
Installing the plugin...
Plugin installed successfully.
Activating ' user-switching ' ...
Plugin ' user-switching ' activated.
Success: Installed 1 of 1 plugins.
يتضمن WP-CLI أيضًا أوامر للعديد من الأشياء التي لا يمكنك القيام بها في مسؤول WordPress. على سبيل المثال، يتيح لك wp transient delete --all
(doc) حذف واحد أو كل العناصر العابرة:
$ wp transient delete --all
Success: 34 transients deleted from the database.
للحصول على مقدمة أكثر اكتمالاً لاستخدام WP-CLI، اقرأ دليل البدء السريع. أو يمكنك التواصل مع أصدقاء Shell للتعرف على الأدوات المساعدة المفيدة لسطر الأوامر.
هل تشعر بالفعل بالراحة مع الأساسيات؟ انتقل إلى القائمة الكاملة للأوامر للحصول على معلومات تفصيلية حول إدارة السمات والمكونات الإضافية، واستيراد البيانات وتصديرها، وتنفيذ عمليات البحث والاستبدال في قاعدة البيانات، والمزيد.
يعد تنزيل ملف Phar طريقة التثبيت الموصى بها لمعظم المستخدمين. إذا كنت بحاجة إلى ذلك، راجع أيضًا وثائقنا حول طرق التثبيت البديلة (Composer، Homebrew، Docker).
قبل تثبيت WP-CLI، يرجى التأكد من أن بيئتك تلبي الحد الأدنى من المتطلبات:
بمجرد التحقق من المتطلبات، قم بتنزيل ملف wp-cli.phar باستخدام wget
أو curl
:
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
بعد ذلك، تحقق من ملف Phar للتأكد من أنه يعمل:
php wp-cli.phar --info
لاستخدام WP-CLI من سطر الأوامر عن طريق كتابة wp
، اجعل الملف قابلاً للتنفيذ وانقله إلى مكان ما في PATH. على سبيل المثال:
chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp
إذا تم تثبيت WP-CLI بنجاح، فيجب أن ترى شيئًا كهذا عند تشغيل wp --info
:
$ wp --info
OS: Linux 5.10.60.1-microsoft-standard-WSL2 # 1 SMP Wed Aug 25 23:20:18 UTC 2021 x86_64
Shell: /usr/bin/zsh
PHP binary: /usr/bin/php8.1
PHP version: 8.1.0
php.ini used: /etc/php/8.1/cli/php.ini
MySQL binary: /usr/bin/mysql
MySQL version: mysql Ver 8.0.27-0ubuntu0.20.04.1 for Linux on x86_64 (( Ubuntu ))
SQL modes:
WP-CLI root dir: /home/wp-cli/
WP-CLI vendor dir: /home/wp-cli/vendor
WP_CLI phar path:
WP-CLI packages dir: /home/wp-cli/.wp-cli/packages/
WP-CLI global config:
WP-CLI project config: /home/wp-cli/wp-cli.yml
WP-CLI version: 2.11.0
يمكنك تحديث WP-CLI wp cli update
(doc)، أو بتكرار خطوات التثبيت.
إذا كان WP-CLI مملوكًا لجذر أو لمستخدم نظام آخر، فستحتاج إلى تشغيل sudo wp cli update
.
هل تريد أن تعيش الحياة على الحافة؟ قم بتشغيل wp cli update --nightly
لاستخدام أحدث إصدار ليلي من WP-CLI. يعد الإصدار الليلي أكثر أو أقل استقرارًا بما يكفي لاستخدامه في بيئة التطوير الخاصة بك، ويتضمن دائمًا أحدث وأكبر ميزات WP-CLI.
يأتي WP-CLI أيضًا مع برنامج نصي لإكمال علامة التبويب لـ Bash وZSH. ما عليك سوى تنزيل wp-completion.bash ومصدره من ~/.bash_profile
:
source /FULL/PATH/TO/wp-completion.bash
لا تنس تشغيل source ~/.bash_profile
بعد ذلك.
إذا كنت تستخدم zsh لـ Shell الخاص بك، فقد تحتاج إلى تحميل bashcompinit
وبدء تشغيله قبل تحديد المصدر. ضع ما يلي في .zshrc
الخاص بك:
autoload bashcompinit
bashcompinit
source /FULL/PATH/TO/wp-completion.bash
يتمتع المشرفون والمساهمون في WP-CLI بتوفر محدود لمعالجة أسئلة الدعم العامة. الإصدار الحالي من WP-CLI هو الإصدار الوحيد المدعوم رسميًا.
عند البحث عن الدعم، يرجى أولاً البحث عن سؤالك في هذه الأماكن:
إذا لم تجد الإجابة في أحد الأماكن أعلاه، يمكنك:
#cli
في WordPress.org Slack للدردشة مع أي شخص قد يكون متاحًا في ذلك الوقت. هذا الخيار هو الأفضل للأسئلة السريعة.تهدف مشكلات GitHub إلى تتبع التحسينات والأخطاء الموجودة في الأوامر الموجودة، وليس الدعم العام. قبل إرسال تقرير بالأخطاء، يرجى مراجعة أفضل ممارساتنا للمساعدة في ضمان معالجة مشكلتك في الوقت المناسب.
من فضلك لا تطرح أسئلة الدعم على تويتر. لا يعد تويتر مكانًا مقبولاً للحصول على الدعم للأسباب التالية: 1) من الصعب إجراء محادثات في أقل من 280 حرفًا، و2) تويتر ليس مكانًا يمكن لشخص لديه نفس سؤالك البحث فيه عن إجابة في محادثة سابقة.
تذكر، ليبر != مجانا؛ يمنحك الترخيص مفتوح المصدر حرية الاستخدام والتعديل، ولكن ليس الالتزام بوقت الآخرين. من فضلك كن محترمًا، وحدد توقعاتك وفقًا لذلك.
الأمر هو الوحدة الذرية لوظيفة WP-CLI. wp plugin install
(doc) أحد الأوامر. wp plugin activate
(doc) أمرًا آخر.
يدعم WP-CLI تسجيل أي فئة أو وظيفة أو إغلاق قابل للاستدعاء كأمر. يقرأ تفاصيل الاستخدام من PHPdoc لرد الاتصال. يتم استخدام WP_CLI::add_command()
(doc) لتسجيل الأوامر الداخلية وأوامر الطرف الثالث.
/**
* Delete an option from the database.
*
* Returns an error if the option didn't exist.
*
* ## OPTIONS
*
* <key>
* : Key for the option.
*
* ## EXAMPLES
*
* $ wp option delete my_option
* Success: Deleted 'my_option' option.
*/
$ delete_option_cmd = function ( $ args ) {
list ( $ key ) = $ args ;
if ( ! delete_option ( $ key ) ) {
WP_CLI :: error ( " Could not delete ' $ key ' option. Does it exist? " );
} else {
WP_CLI :: success ( " Deleted ' $ key ' option. " );
}
};
WP_CLI :: add_command ( ' option delete ' , $ delete_option_cmd );
يأتي WP-CLI مزودًا بعشرات الأوامر. إن إنشاء أمر WP-CLI مخصص أسهل مما يبدو. اقرأ كتاب طبخ الأوامر لمعرفة المزيد. تصفح مستندات API الداخلية لاكتشاف مجموعة متنوعة من الوظائف المفيدة التي يمكنك استخدامها في أمر WP-CLI المخصص.
نحن نقدر لك أخذ زمام المبادرة للمساهمة في WP-CLI. بفضلك أنت والمجتمع من حولك، أصبح WP-CLI مشروعًا رائعًا.
لا تقتصر المساهمة على التعليمات البرمجية فقط. نحن نشجعك على المساهمة بالطريقة التي تناسب قدراتك، من خلال كتابة البرامج التعليمية، أو تقديم عرض توضيحي في اجتماعك المحلي، أو مساعدة المستخدمين الآخرين في الإجابة على أسئلة الدعم الخاصة بهم، أو مراجعة وثائقنا.
اقرأ إرشادات المساهمة الخاصة بنا في الكتيب للحصول على مقدمة شاملة لكيفية المشاركة. يساعد اتباع هذه الإرشادات في توضيح أنك تحترم وقت المساهمين الآخرين في المشروع. وفي المقابل، سيبذلون قصارى جهدهم للرد بالمثل على هذا الاحترام عند العمل معك، عبر المناطق الزمنية وفي جميع أنحاء العالم.
لدى WP-CLI مشرف واحد على المشروع: schlessera.
في بعض الأحيان، نمنح حق الوصول للكتابة للمساهمين الذين أثبتوا، على مدى فترة من الزمن، أنهم قادرون واستثمروا في دفع المشروع إلى الأمام.
اقرأ وثيقة الحوكمة في الدليل لمزيد من التفاصيل التشغيلية حول المشروع.
إلى جانب المكتبات المحددة في Composer.json، استخدمنا تعليمات برمجية أو أفكارًا من المشاريع التالية:
wp shell
wp media regenerate
wp search-replace
wp export
wp import
wp scaffold plugin-tests