المرجع: تعارض نوع الإرجاع مقابل #[\ReturnTypeWillChange] السمة

السياق:
في PHP 8.1، تحديد أنواع الإرجاع لـ تصبح الأساليب أكثر انتشارًا، مما يؤدي إلى حدوث تعارضات مع التطبيقات الحالية.

المشكلة:
عندما يتغير نوع الإرجاع الخاص بالطريقة من نوع متوافق إلى نوع غير متوافق أو يكون غير محدد، يتم الإهمال التالي يظهر الإشعار:

Deprecated: Return type of [Method Name] should either be compatible with ..., or the #[\ReturnTypeWillChange] attribute should be used...

آثار التباين المشترك لنوع الإرجاع:
قدم PHP 7.0 أنواع الإرجاع، مما يضمن السلوك المتسق لاستدعاء التعليمات البرمجية بناءً على العقد المحدد. يجب أن تحافظ فئات الامتداد أو التنفيذ على نفس أنواع الإرجاع أو أكثر تحديدًا.

خلفية الإهمال:
مع إضافة Union Types في PHP 8.0، اكتسبت الوظائف والأساليب الداخلية نوع الإرجاع تحديد. ومع ذلك، فإن فرض هذه الأنواع قد يؤدي إلى قطع التوافق مع الإصدارات السابقة. بدلاً من ذلك، تم تقديم إشعار إهمال لإجراء تغييرات مؤقتة.

الغرض من # [\ReturnTypeWillChange] السمة:
تشير هذه السمة إلى تغيير مخطط له في نوع الإرجاع. يتجاهل PHP 8.1 إشعار الإيقاف للطرق المميزة بهذه السمة، مما يسمح بدعم إصدارات PHP الأقدم.

ما يجب فعله:

1. حدد الطريقة المذكورة في إشعار الإهمال ونوع الإرجاع المتوقع.
2. إذا أمكن، قم بتغيير نوع الإرجاع للطريقة ليتوافق مع النوع المتوقع.
3. إذا لزم الأمر، قم بمنع إشعار الإهمال مؤقتًا عن طريق إضافة #[ \ReturnTypeWillChange] السمة.

ملاحظة: من المحتمل أن تكون أنواع الإرجاع القسرية في PHP 9.0، لذا خطط لمعالجة سمات #[\ReturnTypeWillChange] وفقًا لذلك.