deprecation contracts

عقود إهمال Symfony

وظيفة عامة واصطلاح لإثارة إشعارات الإهمال.

توفر هذه الحزمة وظيفة عامة واحدة تسمى trigger_deprecation() والتي تقوم بتشغيل إشعارات الإهمال الصامتة.

باستخدام معالج أخطاء PHP مخصص مثل ذلك الذي يوفره مكون Symfony ErrorHandler، يمكن اكتشاف عمليات الإيقاف التي تم تشغيلها وتسجيلها لاكتشافها لاحقًا، سواء في بيئات التطوير أو الإنتاج.

تتطلب الدالة 3 وسيطات على الأقل:

• اسم حزمة Composer التي تؤدي إلى الإيقاف
• إصدار الحزمة التي قدمت الإهمال
• رسالة الإهمال
• يمكن توفير المزيد من الوسائط: سيتم إدراجها في الرسالة باستخدام تنسيق printf()

مثال:

 trigger_deprecation ( ' symfony/blockchain ' , ' 8.9 ' , ' Using "%s" is deprecated, use "%s" instead. ' , ' bitcoin ' , ' fabcoin ' );

سيؤدي هذا إلى إنشاء الرسالة التالية: Since symfony/blockchain 8.9: Using "bitcoin" is deprecated, use "fabcoin" instead.

على الرغم من أنه لا يوصى بذلك، إلا أنه يمكن تجاهل إشعارات الإهمال تمامًا عن طريق الإعلان عن function trigger_deprecation() {} في تطبيقك.