wp-chinese-converter/vendor/symfony/deprecation-contracts
feibisi 81b2237d50 Refactor core and modules, update dependencies
Introduces new core abstractions and module management classes, adds several new modules (modern cache, REST API, SEO enhancement), and removes deprecated/disabled assets and code. Updates vendor dependencies, including Symfony components and php-opencc, and cleans up related files. This refactor improves code organization, extensibility, and modernizes the plugin's architecture.
2025-09-28 04:43:51 +08:00
..
CHANGELOG.md Refactor core and modules, update dependencies 2025-09-28 04:43:51 +08:00
composer.json Refactor core and modules, update dependencies 2025-09-28 04:43:51 +08:00
function.php Refactor core and modules, update dependencies 2025-09-28 04:43:51 +08:00
LICENSE Refactor core and modules, update dependencies 2025-09-28 04:43:51 +08:00
README.md Refactor core and modules, update dependencies 2025-09-28 04:43:51 +08:00

Symfony Deprecation Contracts

A generic function and convention to trigger deprecation notices.

This package provides a single global function named trigger_deprecation() that triggers silenced deprecation notices.

By using a custom PHP error handler such as the one provided by the Symfony ErrorHandler component, the triggered deprecations can be caught and logged for later discovery, both on dev and prod environments.

The function requires at least 3 arguments:

  • the name of the Composer package that is triggering the deprecation
  • the version of the package that introduced the deprecation
  • the message of the deprecation
  • more arguments can be provided: they will be inserted in the message using printf() formatting

Example:

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

This will generate the following message: Since symfony/blockchain 8.9: Using "bitcoin" is deprecated, use "fabcoin" instead.

While not recommended, the deprecation notices can be completely ignored by declaring an empty function trigger_deprecation() {} in your application.