رموز الخروج

WP-CLIWP-CLI WP-CLI هي واجهة سطر الأوامر لـ WordPress، وتُستخدم لتنفيذ المهام الإدارية ومهام التطوير بطريقة برمجية. صفحة المشروع هي http://wp-cli.org/ https://make.wordpress.org/cli/ يتبع اصطلاحات Unix المعتمدة على نطاق واسع لرموز الخروج: تشير القيمة 0 إلى النجاح (تم استيفاء الشرط الأساسي للأمر)، بينما تشير القيم غير الصفرية إلى عدم استيفاء الشرط الأساسي. ويمكن أن يمثل ذلك إما خطأً تشغيليًا (تعذّر على الأمر تنفيذ العملية المطلوبة) أو نتيجة سلبية متوقعة يُفترض أن تختبرها البرامج النصية المستدعية (مثل «غير مثبت»). ويمكن للبرامج النصية التي تستدعي أوامر WP-CLI فحص رمز الخروج لتحديد ما إذا كان ينبغي المتابعة أو إعادة المحاولة أو الإيقاف.

رموز الخروج القياسية

تُعد WP_CLI::error() (التوثيق) الطريقة الاصطلاحية للإبلاغ عن فشل والخروج بالرمز 1.

يمكن استخدام WP_CLI::halt() (التوثيق) للخروج برمز محدد غير صفري عندما يحتاج الأمر إلى إيصال نتيجة معينة إلى البرنامج النصي المستدعي.

رموز الخروج للأوامر ذات النتائج المنطقية

صُممت بعض الأوامر لإيصال نتيجة ثنائية مباشرةً من خلال رمز الخروج بدلًا من الإخراج. لا تزال هذه الأوامر تستخدم الرمزين القياسيين 0/1، لكن 1 يعني «لم يتحقق الشرط» بدلًا من «خطأ تشغيلي». مثال:

• ينتهي wp plugin is-installed <plugin> بالرمز 0 إذا كان المكوّن الإضافيالمكوّن الإضافي المكوّن الإضافي هو جزء من برنامج يحتوي على مجموعة من الوظائف التي يمكن إضافتها إلى موقع WordPress. ويمكنه توسيع الوظائف أو إضافة ميزات جديدة إلى مواقع WordPress الخاصة بك. تُكتب إضافات WordPress بلغة البرمجة PHP وتتكامل بسلاسة مع WordPress. وقد تكون مجانية في دليل إضافات WordPress.org https://wordpress.org/plugins/ أو إضافات مدفوعة من جهة خارجية. مثبتًا، وبالرمز 1 إذا لم يكن مثبتًا.
• يتبع wp theme is-installed <theme> النمط نفسه.
• ينتهي wp core is-installed بالرمز 0 عند تثبيت WordPress، وبالرمز 1 عند عدم تثبيته.

استخدم رمز الخروج 1 للإشارة إلى «عدم تحقق الشرط» (بدلًا من الإشارة إلى خطأ) عندما:

1. تكون نتيجة الأمر ثنائية (نجاح/فشل، موجود/غير موجود) ويُراد اختبارها مباشرةً في شرط shell.
2. يكون القصد موثقًا صراحةً حتى يعرف مؤلفو البرامج النصية أن رمز الخروج يحمل معنى النتيجة، لا معنى الخطأ.

لا تُرجع رمز خروج غير صفري للحالات الإعلامية بدلًا من كونها نتيجة حاسمة (مثلًا، يظل أمر القائمة الذي لا يعثر على أي عناصر عملية ناجحة — فقد أعاد قائمة فارغة).

استخدام رموز الخروج في البرامج النصية

نظرًا إلى أن WP-CLI يستخدم رموز الخروج القياسية، يمكنك استخدام أوامر WP-CLI مباشرةً في شروط shell:

# تحقق من تثبيت مكوّن إضافي قبل محاولة تفعيله
if wp plugin is-installed my-plugin; then
    wp plugin activate my-plugin
else
    echo "المكوّن الإضافي غير مثبت"
    exit 1
fi

يمكنك أيضًا فحص $? بعد أي أمر من أوامر WP-CLI للتحقق مما إذا كان قد نجح:

wp core update
if [ "$?" -ne 0 ]; then
    echo "فشل التحديث"
fi