PHPackages phpstan/phpstan-deprecation-rules - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Testing & Quality](/categories/testing) 4. / 5. phpstan/phpstan-deprecation-rules ActivePhpstan-extension[Testing & Quality](/categories/testing) phpstan/phpstan-deprecation-rules ================================= PHPStan rules for detecting usage of deprecated classes, methods, properties, constants and traits. 2.0.4(3mo ago)44979.0M—3.1%24[17 issues](https://github.com/phpstan/phpstan-deprecation-rules/issues)[6 PRs](https://github.com/phpstan/phpstan-deprecation-rules/pulls)20MITPHPPHP ^7.4 || ^8.0CI passing Since Jun 24Pushed today4 watchersCompare [ Source](https://github.com/phpstan/phpstan-deprecation-rules)[ Packagist](https://packagist.org/packages/phpstan/phpstan-deprecation-rules)[ RSS](/packages/phpstan-phpstan-deprecation-rules/feed)WikiDiscussions 2.0.x Synced 1mo ago READMEChangelog (10)Dependencies (4)Versions (37)Used By (20) Rules for detecting usage of deprecated classes, methods, properties, constants and traits. =========================================================================================== [](#rules-for-detecting-usage-of-deprecated-classes-methods-properties-constants-and-traits) [![Build](https://github.com/phpstan/phpstan-deprecation-rules/workflows/Build/badge.svg)](https://github.com/phpstan/phpstan-deprecation-rules/actions)[![Latest Stable Version](https://camo.githubusercontent.com/9778fecb7103b169aaba239a9c523115df5ae99fc173a7a137e134034bd94279/68747470733a2f2f706f7365722e707567782e6f72672f7068707374616e2f7068707374616e2d6465707265636174696f6e2d72756c65732f762f737461626c65)](https://packagist.org/packages/phpstan/phpstan-deprecation-rules)[![License](https://camo.githubusercontent.com/9e83f095b59116d92f871fd56d8dd813d73cf8570219893dcb611e62a5b4e913/68747470733a2f2f706f7365722e707567782e6f72672f7068707374616e2f7068707374616e2d6465707265636174696f6e2d72756c65732f6c6963656e7365)](https://packagist.org/packages/phpstan/phpstan-deprecation-rules) - [PHPStan](https://phpstan.org/) Installation ------------ [](#installation) To use this extension, require it in [Composer](https://getcomposer.org/): ``` composer require --dev phpstan/phpstan-deprecation-rules ``` If you also install [phpstan/extension-installer](https://github.com/phpstan/extension-installer) then you're all set! Manual installationIf you don't want to use `phpstan/extension-installer`, include rules.neon in your project's PHPStan config: ``` includes: - vendor/phpstan/phpstan-deprecation-rules/rules.neon ``` Deprecating code you don't own ------------------------------ [](#deprecating-code-you-dont-own) This extension emits deprecation warnings on code, which uses properties/functions/methods/classes which are annotated as `@deprecated`. In case you don't own the code which you want to be considered deprecated, use [PHPStan Stub Files](https://phpstan.org/user-guide/stub-files) to declare deprecations for vendor files like: ``` /** @deprecated */ class ThirdPartyClass {} ``` Custom deprecation markers -------------------------- [](#custom-deprecation-markers) You can implement extensions to support even e.g. custom `#[MyDeprecated]` attribute. [Learn more](https://phpstan.org/developing-extensions/custom-deprecations). Custom deprecated scopes ------------------------ [](#custom-deprecated-scopes) Usage of deprecated code is not reported in code that is also deprecated: ``` /** @deprecated */ function doFoo(): void { // not reported: anotherDeprecatedFunction(); } ``` If you have [a different way](https://github.com/phpstan/phpstan-deprecation-rules/issues/64) of marking code that calls deprecated symbols on purpose and you don't want these calls to be reported either, you can write an extension by implementing the [`DeprecatedScopeResolver`](https://github.com/phpstan/phpstan-deprecation-rules/blob/1.1.x/src/Rules/Deprecations/DeprecatedScopeResolver.php) interface. For example if you mark your PHPUnit tests that test deprecated code with `@group legacy`, you can implement the extension this way: ``` class GroupLegacyScopeResolver implements DeprecatedScopeResolver { public function isScopeDeprecated(Scope $scope): bool { $function = $scope->getFunction(); return $function !== null && $function->getDocComment() !== null && strpos($function->getDocComment(), '@group legacy') !== false; } } ``` And register it in your [configuration file](https://phpstan.org/config-reference): ``` services: - class: GroupLegacyScopeResolver tags: - phpstan.deprecations.deprecatedScopeResolver ``` [Learn more about Scope](https://phpstan.org/developing-extensions/scope), a core concept for implementing custom PHPStan extensions. ### Health Score 76 — ExcellentBetter than 100% of packages Maintenance91 Actively maintained with recent releases Popularity72 Solid adoption and visibility Community56 Growing community involvement Maturity79 Established project with proven stability Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~100 days Recently: every ~113 days Total 29 Last Release 81d ago Major Versions 0.12.6 → 1.0.02021-09-23 1.2.x-dev → 2.0.02024-10-26 PHP version history (4 changes)0.10PHP ~7.1 0.12.5PHP ^7.1 || ^8.0 1.1.0PHP ^7.2 || ^8.0 2.0.0PHP ^7.4 || ^8.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/258cf2d2422f7e9ac5f7e1bb7a331f3fb717a11e51de7a3de2d6025507bd63cf?d=identicon)[ondrejmirtes](/maintainers/ondrejmirtes) --- Top Contributors [![ondrejmirtes](https://avatars.githubusercontent.com/u/104888?v=4)](https://github.com/ondrejmirtes "ondrejmirtes (94 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (16 commits)")[![staabm](https://avatars.githubusercontent.com/u/120441?v=4)](https://github.com/staabm "staabm (13 commits)")[![iluuu1994](https://avatars.githubusercontent.com/u/1752683?v=4)](https://github.com/iluuu1994 "iluuu1994 (11 commits)")[![localheinz](https://avatars.githubusercontent.com/u/605483?v=4)](https://github.com/localheinz "localheinz (11 commits)")[![renovate-bot](https://avatars.githubusercontent.com/u/25180681?v=4)](https://github.com/renovate-bot "renovate-bot (10 commits)")[![paxal](https://avatars.githubusercontent.com/u/1848817?v=4)](https://github.com/paxal "paxal (9 commits)")[![ruudk](https://avatars.githubusercontent.com/u/104180?v=4)](https://github.com/ruudk "ruudk (5 commits)")[![cs278](https://avatars.githubusercontent.com/u/17377?v=4)](https://github.com/cs278 "cs278 (4 commits)")[![villfa](https://avatars.githubusercontent.com/u/2891564?v=4)](https://github.com/villfa "villfa (3 commits)")[![herndlm](https://avatars.githubusercontent.com/u/5738896?v=4)](https://github.com/herndlm "herndlm (2 commits)")[![Khartir](https://avatars.githubusercontent.com/u/5592420?v=4)](https://github.com/Khartir "Khartir (2 commits)")[![Kocal](https://avatars.githubusercontent.com/u/2103975?v=4)](https://github.com/Kocal "Kocal (2 commits)")[![eiriksm](https://avatars.githubusercontent.com/u/865153?v=4)](https://github.com/eiriksm "eiriksm (1 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")[![clxmstaab](https://avatars.githubusercontent.com/u/47448731?v=4)](https://github.com/clxmstaab "clxmstaab (1 commits)")[![barryvdh](https://avatars.githubusercontent.com/u/973269?v=4)](https://github.com/barryvdh "barryvdh (1 commits)")[![step-security-bot](https://avatars.githubusercontent.com/u/89328645?v=4)](https://github.com/step-security-bot "step-security-bot (1 commits)")[![szepeviktor](https://avatars.githubusercontent.com/u/952007?v=4)](https://github.com/szepeviktor "szepeviktor (1 commits)")[![TomasVotruba](https://avatars.githubusercontent.com/u/924196?v=4)](https://github.com/TomasVotruba "TomasVotruba (1 commits)") --- Tags deprecationsphpphp7phpstanstatic-analysisstatic-code-analysisstatic analysis ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/phpstan-phpstan-deprecation-rules/health.svg) ``` [![Health](https://phpackages.com/badges/phpstan-phpstan-deprecation-rules/health.svg)](https://phpackages.com/packages/phpstan-phpstan-deprecation-rules) ``` ### Alternatives [larastan/larastan Larastan - Discover bugs in your code without running it. A phpstan/phpstan extension for Laravel 6.4k43.5M5.2k](/packages/larastan-larastan)[phpstan/phpstan-symfony Symfony Framework extensions and rules for PHPStan 78768.9M1.5k](/packages/phpstan-phpstan-symfony)[phpstan/phpstan-doctrine Doctrine extensions for PHPStan 66766.6M1.1k](/packages/phpstan-phpstan-doctrine)[phpstan/phpstan-strict-rules Extra strict and opinionated rules for PHPStan 69661.6M3.9k](/packages/phpstan-phpstan-strict-rules)[phpstan/phpstan-phpunit PHPUnit extensions and rules for PHPStan 529102.1M8.6k](/packages/phpstan-phpstan-phpunit)[spaze/phpstan-disallowed-calls PHPStan rules to detect disallowed method & function calls, constant, namespace, attribute, property & superglobal usages, with powerful rules to re-allow a call or a usage in places where it should be allowed. 33320.0M375](/packages/spaze-phpstan-disallowed-calls) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)