الإدماج المستمر/متشمم أخطاء كود بي إتش بي
متشمم أخطاء كود بي إتش بي «PHP CodeSniffer» هي أداة لاكتشاف أخطاء أنماط الكود البرمجي في كود بي إتش بي. نستخدم برمجيات Composer في صفة مغلّف للتعامل مع نسخة CodeSniffer وتبعياته وتنفيذه.
في البداية، أحضر تبعيات التطوير البرمجي عن طريق تشغيل composer update
.
لأغلب امتدادات ميدياويكي وسماتها ومكتبات بي إتش بي الخاصة بها، سينتج عن تنفيذ composer test
تنفيذ CodeSniffer أيضًا.
بسبب الحجم الضخم للب ميدياويكي البرمجي، يجري كشفه في صفة أمر منفرد، composer phpcs
.
التنفيذ محليًا دون استخدام Composer
لو مرت بك مشاكل في العمل مع Composer حيث يتوقف بعد برهة، يمكنك تشغيله مباشرة مستخدمًا vendor/bin/phpcs -p -s
.
من الأهمية بمكان تنفيذ إصدار PHP_CodeSniffer الذي ثبته Composer في مستودع مشروعك المحلي في vendor/bin حتى يمكن العثور على كافة الأخطاء البرمجية.
لا تستخدم إصدار النظام الموجود في PATH لديك.
لو كنت تتوقف عن العمل بسبب أخطاء في الذاكرة، يمكنك تشغيله مستخدمًا مزيد من الذاكرة.
vendor/bin/phpcs -p -s -d memory_limit=256M
.
تسمية الإصدارات
نحبّذ أن تبرز إصدار بعينه في ملف composer.json
لديك.
نحن نحاول الالتزام بروح semver.org، إلا أننا لا نلتزم بالمعيار القياسي ذاته.
الأمر الرئيسي الذي يعنينا هو ضمان أنه بغض النظر عن الموقف، لو شغلت composer test
، سوف ينجح لو كان نجح من قبل، وألا يخفق عشوائيًا بسبب نشر إصدار جديد.
إن مسألة فضل البنية عشوائيًا أمر مثير للحنق حينما تحاول دمج رقعة أو مجرد محاولة تطوير شيء وتحتاج لوقف عملك كي تصوب الأمر.
نستخدم حاليًا الرقم 0 في صفة الإصدار الرئيسي، وسنضع الإصدارات الصغرى قيد متشمم الأخطاء البرمجية وإرسال نسخة الرقعة لتصويب الأخطاء أو التحسينات على الأخطاء البرمجية القائمة. لا يوجد ضمان بالاستقرار في شأن كود بي إتش بي البرمجي المضمّن.
انظر أيضا
- Manual:Coding conventions/PHP
- Extension:BoilerPlate - امتداد هيكلي، تشغّل نقطة إدخال الإدماج المستمر الخاصة به
composer test
متشمم أخطاء كود بي إتش بي. - mediawiki-codesniffer - معيار PHC القياسي
- الإدماج المستمر/نقاط الإدخال#بي إتش بي
- كيفية التثبيت - تعليمات في شأن كيفية تثبيت متشمم أخطاء الكود لغرض امتداد
- https://phpcs.toolforge.org/