deprecation contracts

Kontrak Penghentian Symfony

Fungsi dan konvensi umum untuk memicu pemberitahuan penghentian.

Paket ini menyediakan satu fungsi global bernama trigger_deprecation() yang memicu pemberitahuan penghentian yang dibungkam.

Dengan menggunakan pengendali kesalahan PHP khusus seperti yang disediakan oleh komponen Symfony ErrorHandler, penghentian yang dipicu dapat ditangkap dan dicatat untuk ditemukan nanti, baik di lingkungan dev maupun prod.

Fungsi ini memerlukan setidaknya 3 argumen:

• nama paket Komposer yang memicu penghentian
• versi paket yang memperkenalkan penghentian tersebut
• pesan penghinaan tersebut
• lebih banyak argumen dapat diberikan: argumen tersebut akan disisipkan dalam pesan menggunakan format printf()

Contoh:

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

Ini akan menghasilkan pesan berikut: Since symfony/blockchain 8.9: Using "bitcoin" is deprecated, use "fabcoin" instead.

Meskipun tidak direkomendasikan, pemberitahuan penghentian dapat diabaikan sepenuhnya dengan mendeklarasikan function trigger_deprecation() {} dalam aplikasi Anda.