جدول المحتويات:
هذا مشروع تجريبي لتقديم مثال على مهاراتي في البرمجة الموجهة للكائنات باستخدام PHP، وكتابة اختبارات PHPUnit الوحدوية، والاستفادة من أدوات مثل Composer (مدير تبعيات PHP)، وGit (نظام تحكم في الإصدار الموزع)، و يونكس شل. يعكس أيضًا معرفتي بمنصات التطوير الحديثة مثل GitHub (مركز مستودعات التعليمات البرمجية المصدر عبر الإنترنت)، وCodecov (للحصول على رؤى تغطية التعليمات البرمجية)، وCircleCI (التكامل المستمر والتسليم المستمر).
لم يتم كتابة هذا المشروع بأي حال من الأحوال معتقدًا استخدامه في الإنتاج، ولكن يمكن استخدامه كما تريد تحت مسؤوليتك الكاملة. يمكنك أيضًا تشعبها واستخدامها كأساس لمشروعك الخاص إذا وجدت أنها مفيدة.
OoWordpressNonces عبارة عن حزمة مؤلفة لـ WordPress للتعامل مع WordPress Nonces باستخدام نهج البرمجة الشيئية .
لا تحل محل نظام WordPress Nonces الأصلي، هذه الحزمة ليست سوى غلاف، باستخدام نهج OOP ، لوظائف WordPress Nonces الأصلية.
الكود بسيط وواضح بذاته وموثق بالكامل. في مصدر التعليمات البرمجية، تحتوي كل طريقة فئة على رابط لوظيفة WordPress الأصلية التي تغلفها. لمزيد من التفاصيل، يمكنك عرض وثائق WordPress الرسمية لـ Nonces
يمكنك تثبيت OoWordpressNonces عن طريق إضافة مواصفات مستودع الحزمة هذه إلى ملف composer.json
الخاص بمشروعك:
{
"repositories": [
{
"type": "vcs",
"url": "https://github.com/josepcrespo/oo-wordpress-nonces"
}
],
"require": {
"josepcrespo/oo-wordpress-nonces": "master"
}
}
ثم قم بتشغيل php composer.phar update
.
في هذا القسم، يمكنك الحصول على تعليمات إعداد هذا المشروع على جهازك المحلي لأغراض التطوير والاختبار.
استنساخ المشروع باستخدام Git:
git clone https://github.com/josepcrespo/oo-wordpress-nonces.git
أو قم بتنزيل ملف ZIP يحتوي على جميع ملفات المشروع: https://github.com/josepcrespo/oo-wordpress-nonces/archive/master.zip
قبل البدء في تثبيت Composer:
- يعد تثبيت PHP على نظامك متطلبًا إلزاميًا. إذا كانت بيئة التطوير الخاصة بك تعمل على نظام التشغيل macOS، فإنني أوصي بتثبيتها باستخدام Homebrew
- قبل البدء في استخدام Homebrew ، يوصى بشدة بتثبيت Xcode وتحديثه. يمكنك تثبيت/تحديث Xcode باستخدام متجر تطبيقات macOS.
- إذا كنت تستخدم نظام التشغيل macOS ، فستحتاج أيضًا إلى تثبيت أدوات سطر أوامر Xcode. لتثبيت/تحديث أدوات سطر أوامر Xcode ، اكتب هذا الأمر باستخدام Terminal.app (بعد تثبيت Xcode أو تحديثه):
xcode-select --install
لتثبيت Composer بسرعة في الدليل الحالي، يرجى الرجوع إلى صفحة تنزيل Composer الرسمية للحصول على الإرشادات المحدثة.
لتثبيت التبعيات المحددة لمشروعك، ما عليك سوى تشغيل أمر Composer install في الدليل الجذر للمشروع باستخدام Terminal.app (إذا كنت تستخدم macOS ) أو باستخدام Shell المفضل لديك:
php composer.phar install
قد ترغب في الاطلاع على إرشادات Composer الرسمية لتثبيت التبعيات لمزيد من التفاصيل.
إذا استخدمت خيار --filename
في تثبيت Composer
- ربما قمت بتثبيت الملحن الخاص بك باستخدام خيار تثبيت
--filename
، على سبيل المثال بهذه الطريقة:php composer-setup.php --filename=composer
في هذه الحالة، يجب عليك تشغيلcomposer install
لتثبيت التبعيات.
تم إجراء الاختبارات الوحدوية لهذه الحزمة باستخدام PHPUnit.
cp phpunit.xml.dist phpunit.xml
vendor/bin/phpunit
بعد تشغيل الاختبارات، يمكنك عرض نتائج تغطية الاختبارات عن طريق فتح ملف index.html
الذي تم إنشاؤه ضمن المجلد tests/code-coverage-reports/html-format/
.
إذا ألقى PHPUnit رسالة خطأ تفيد بأنه لا يمكنه العثور على بعض الفئات المستخدمة في الاختبارات.
- استخدم أمر Composer التالي، ثم أعد تشغيل الاختبارات.
php composer.phar dump-autoload
أنت بحاجة إلى تمكين ملحق Xdebug PHP.
- يتم تكوين وظيفة تغطية التعليمات البرمجية الخاصة بـ PHPUnit افتراضيًا لهذا المشروع. إنه يستخدم مكون PHP_CodeCoverage ، والذي بدوره يعزز وظيفة تغطية التعليمات البرمجية التي يوفرها ملحق Xdebug لـ PHP.
- إذا كنت لا تريد رؤية تغطية التعليمات البرمجية، أو إذا لم تتمكن من تمكين ملحق Xdebug بشكل صحيح، فيمكنك إزالة إدخال
الكامل الموجود في ملف التكوين phpunit.xml.