الصفحة الرئيسية>كود المصدر JSP>فئات أخرى
تنزيل

قواعد صارمة وذات رأي إضافية ل phpstan

يركز Phpstan على العثور على الأخطاء في الكود الخاص بك. ولكن في PHP ، هناك الكثير من الفسحة في كيفية كتابة الأشياء. يحتوي هذا المستودع على قواعد إضافية تدور حول الكود المكتوب بدقة وقوية دون أي صب فضفاض لأولئك الذين يريدون سلامة إضافية في البرمجة الدفاعية للغاية:

  • تتطلب booleans في if ، elseif ، المشغل الثلاثية ، بعد ! وعلى جانبي && و || .
  • تتطلب معاملات رقمية أو صفائف في + والمعاملات الرقمية في - / * / / / ** / % .
  • تتطلب المعامل الرقمي في $var++ ، $var-- ، ++$var --$var .
  • تحتوي هذه الوظائف على معلمة $strict لتحسين السلامة من النوع ، يجب ضبطها على true :
    • in_array (المعلمة الثالثة)
    • array_search (المعلمة الثالثة)
    • array_keys (المعلمة الثالثة ؛ فقط إذا تم توفير المعلمة 2nd $search_value )
    • base64_decode (المعلمة الثانية)
  • لا يمكن استخدام المتغيرات المخصصة في while حلقة الحلقة for الأولي للحلقة بعد الحلقة.
  • لا يمكن استخدام المتغيرات المحددة في Foreach دائمًا بفضل المصفوفات غير الفارغة بعد الحلقة.
  • يجب أن تتطابق الأنواع في حالة switch وقيمة case . يقارنها PHP بشكل فضفاض بشكل افتراضي ويمكن أن يؤدي ذلك إلى نتائج غير متوقعة.
  • تحقق من أن الأساليب المعلنة بشكل ثابت تسمى بشكل ثابت.
  • عدم السماح empty() - إنها مقارنة فضفاضة للغاية (انظر اليدوي) ، يوصى باستخدامها بشكل أكثر صرامة.
  • عدم السماح بعامل Ternary Shortary القصيرة ( ?: :) - يعني مقارنة ضعيفة ، يوصى باستخدام مشغل COALESCE NULL ( ?? ) أو عامل ثلاثي مع حالة صارمة.
  • عدم السماح المتغيرات المتغيرة ( $$foo ، $this->$method() etc.)
  • عدم السماح المتغيرات فوق الكتابة مع مفتاح foreach ومتغيرات القيمة
  • دائمًا ما instanceof حقيقيًا ، وظائف فحص النوع is_* والمقارنات الصارمة === / !== . يمكن إيقاف تشغيل هذه الشيكات عن طريق تعيين checkAlwaysTrueInstanceof / checkAlwaysTrueCheckTypeFunctionCall / checkAlwaysTrueStrictComparison إلى False.
  • الحالة الصحيحة لأسماء الوظائف المشار إليها ودعاها.
  • الحالة الصحيحة لأسماء الأسلوب الموروثة والتنفيذ.
  • التنافس لأنواع المعلمات والتباين لأنواع الإرجاع في الأساليب الموروثة (المعروف أيضًا باسم مبدأ استبدال Liskov - LSP)
  • تحقق من LSP حتى للطرق الثابتة
  • تتطلب الاتصال بمنشئ الوالدين
  • عدم السماح باستخدام مشغل backtick ( $ls = `ls -la` )
  • يجب أن يستخدم الإغلاق $this مباشرة بدلاً من استخدام $this المتغير بشكل غير مباشر

قواعد إضافية تأتي في الإصدارات اللاحقة!

تثبيت

لاستخدام هذا الامتداد ، اطلبه في الملحن: 

 composer require --dev phpstan/phpstan-strict-rules

إذا قمت أيضًا بتثبيت Phpstan/Extension-instholer ، فأنت جميعًا قد تم تعيينه!

التثبيت اليدوي

إذا كنت لا ترغب في استخدام phpstan/extension-installer ، فقم بتضمين القواعد. neon في تكوين Phpstan لمشروعك: 

 includes:
    - vendor/phpstan/phpstan-strict-rules/rules.neon

تعطيل القواعد

يمكنك تعطيل القواعد باستخدام معلمات التكوين: 

 parameters :
	strictRules :
		disallowedLooseComparison : false
		booleansInConditions : false
		uselessCast : false
		requireParentConstructorCall : false
		disallowedBacktick : false
		disallowedEmpty : false
		disallowedImplicitArrayCreation : false
		disallowedShortTernary : false
		overwriteVariablesWithLoop : false
		closureUsesThis : false
		matchingInheritedMethodNames : false
		numericOperandsInArithmeticOperators : false
		strictFunctionCalls : false
		dynamicCallOnStaticMethod : false
		switchConditionsMatchingType : false
		noVariableVariables : false
		strictArrayFilter : false
		illegalConstructorMethodCall : false

بصرف النظر عن تقديم قواعد مخصصة جديدة ، فإن قواعد Phpstan-Strict أيضًا تغير القيم الافتراضية لبعض معلمات التكوين الموجودة في Phpstan نفسها. تم توثيق هذه المعلمات على phpstan.org.

تمكين القواعد واحدة تلو الأخرى

إذا كنت لا ترغب في البدء في استخدام جميع القواعد الصارمة المتاحة في وقت واحد ولكن واحد أو اثنتين فقط ، يمكنك!

يمكنك تعطيل جميع القواعد من rules.neon المضمنة. neon مع: 

 parameters :
	strictRules :
		allRules : false

ثم يمكنك إعادة تمكين القواعد الفردية مع معلمات التكوين: 

 parameters :
	strictRules :
		allRules : false
		booleansInConditions : true

حتى مع strictRules.allRules تم ضبطها على false ، جزء من هذه الحزمة لا يزال ساري المفعول. ذلك لأن قواعد phpstan-strict أيضًا تغير القيم الافتراضية لبعض معلمات التكوين الموجودة في Phpstan نفسها. تم توثيق هذه المعلمات على phpstan.org.

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل