deprecation contracts

สัญญาเลิกใช้ Symfony

ฟังก์ชันและแบบแผนทั่วไปเพื่อทริกเกอร์ประกาศการเลิกใช้งาน

แพ็คเกจนี้มีฟังก์ชันโกลบอลเดียวชื่อ trigger_deprecation() ที่ทริกเกอร์การแจ้งเตือนการเลิกใช้งานแบบเงียบ

ด้วยการใช้ตัวจัดการข้อผิดพลาด PHP แบบกำหนดเอง เช่น ตัวจัดการข้อผิดพลาดของ Symfony ErrorHandler ที่ให้มา จะสามารถตรวจจับและบันทึกการเลิกใช้งานที่ถูกทริกเกอร์ไว้เพื่อการค้นพบในภายหลัง ทั้งในสภาพแวดล้อม dev และ prod

ฟังก์ชันต้องการอาร์กิวเมนต์อย่างน้อย 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() {} ในแอปพลิเคชันของคุณ