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() {} .