# Deprecation

> A deprecation is an announcement that a feature will be removed in a future version of a piece of software; until then, the feature can still be used.

Original page: https://t10.de/en/glossary/deprecation
Publisher: total10 GmbH, https://t10.de/en/glossary

PHP reports deprecated code through `E_DEPRECATED` notices. The [PHP manual](https://www.php.net/manual/en/errorfunc.constants.php) describes them as run-time notices which, if enabled, warn about code that will not work in future versions. Since PHP 8.4, developers can also mark their own functions as deprecated with the `#[\Deprecated]` attribute. Calling such a function then raises the corresponding notice, `E_USER_DEPRECATED`.

Among the features PHP 8.4 deprecates are implicitly nullable parameter types. Parameters are the named inputs of a function. If a parameter has null as its default value, it silently accepts null, even where its declared type does not allow null.

The Semantic Versioning FAQ says that before functionality is removed in a new major release (one that raises the first part of the version number), at least one minor release (one that raises the second) should contain the deprecation. Users can then move smoothly to the new API.

In a running Shopware 5 shop, deprecation notices are harmless at first, because they are not errors. If a plugin treats every such notice as an error, however, a single one of them can abort execution. Ahead of a PHP upgrade, we therefore go through the deprecation notices in the shop's error log to see where changes are needed.

## See also

- [EOL](https://t10.de/en/glossary/eol): EOL (end of life) is the point at which a vendor or project stops supporting a software version, so that users may be exposed to unpatched security vulnerabilities.
- [Software release](https://t10.de/en/glossary/software-release): A software release is a published, deployable version of a piece of software, made available under a fixed version number for download and installation.
- [Regression](https://t10.de/en/glossary/regression): A regression is a defect or loss of quality in software caused by a change; regression tests look for such defects in the parts that were not changed.
- [PHPStan](https://t10.de/en/glossary/phpstan): PHPStan is an open-source static analysis tool for PHP that finds errors in code without running it and without the need to write tests.

## Sources

1. [PHP-Handbuch: Fehlerbehandlung, Vordefinierte Konstanten](https://www.php.net/manual/de/errorfunc.constants.php), The PHP Group (php.net), accessed 2026-11-16
2. [Semantic Versioning 2.0.0, deutsche Fassung](https://semver.org/lang/de/), Semantic Versioning (semver.org), accessed 2026-11-16
3. [PHP Manual: The Deprecated attribute](https://www.php.net/manual/en/class.deprecated.php), The PHP Group (php.net), accessed 2026-11-16
4. [PHP Manual: Migrating from PHP 8.3.x to PHP 8.4.x, Deprecated Features](https://www.php.net/manual/en/migration84.deprecated.php), The PHP Group (php.net), accessed 2026-11-16
