PHPackages                             voku/phpstan-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. voku/phpstan-rules

ActivePhpstan-extension

voku/phpstan-rules
==================

Provides additional rules for phpstan/phpstan.

3.6.0(1y ago)3385.9k—7.5%1[2 issues](https://github.com/voku/phpstan-rules/issues)[6 PRs](https://github.com/voku/phpstan-rules/pulls)5MITPHPPHP ^7.4 || ^8.0

Since Feb 17Pushed 1mo ago2 watchersCompare

[ Source](https://github.com/voku/phpstan-rules)[ Packagist](https://packagist.org/packages/voku/phpstan-rules)[ Docs](https://github.com/voku/phpstan-rules)[ Fund](https://www.paypal.me/moelleken)[ GitHub Sponsors](https://github.com/voku)[ RSS](/packages/voku-phpstan-rules/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (3)Versions (48)Used By (5)

[![Build Status](https://github.com/voku/phpstan-rules/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/voku/phpstan-rules/actions)[![codecov.io](https://camo.githubusercontent.com/88653bef82b5b320342c4f66d9a8622ba6bb855e1be0517b2da100217f010bdd/68747470733a2f2f636f6465636f762e696f2f6769746875622f766f6b752f7068707374616e2d72756c65732f636f7665726167652e7376673f6272616e63683d6d6173746572)](https://codecov.io/github/voku/phpstan-rules?branch=master)[![Latest Stable Version](https://camo.githubusercontent.com/6fcc8cd9af38e77693aae1bf60fb5dd3ef2d93d65fc5b4e6c1bb4f81e88fa7f7/68747470733a2f2f706f7365722e707567782e6f72672f766f6b752f7068707374616e2d72756c65732f762f737461626c65)](https://packagist.org/packages/voku/phpstan-rules)[![License](https://camo.githubusercontent.com/adb5b7a02378558abdb56dc9f0eb534b8ea1c2c23449c955bf473ae3334b84c1/68747470733a2f2f706f7365722e707567782e6f72672f766f6b752f7068707374616e2d72756c65732f6c6963656e7365)](https://packagist.org/packages/voku/phpstan-rules)[![Donate to this project using Paypal](https://camo.githubusercontent.com/0d6e4d8b50b5983a58205941b1a581b1305903393b7a39da574e3f60af3c7f5b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f70617970616c2d646f6e6174652d79656c6c6f772e737667)](https://www.paypal.me/moelleken)[![Donate to this project using Patreon](https://camo.githubusercontent.com/f9e075baad95563481d35174d43ef50757281abb6bc795d0f473fad452afa030/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f70617472656f6e2d646f6e6174652d79656c6c6f772e737667)](https://www.patreon.com/voku)

phpstan-rules
=============

[](#phpstan-rules)

Provides additional rules for [`phpstan/phpstan`](https://github.com/phpstan/phpstan).

Installation
------------

[](#installation)

Run

```
$ composer require --dev voku/phpstan-rules
```

Usage
-----

[](#usage)

All the [rules](https://github.com/voku/phpstan-rules#rules) provided (and used) by this library are included in [`rules.neon`](rules.neon).

When you are using [`phpstan/extension-installer`](https://github.com/phpstan/extension-installer), `rules.neon` will be automatically included.

Otherwise, you need to include `rules.neon` in your `phpstan.neon`:

```
includes:
	- vendor/voku/phpstan-rules/rules.neon
```

Rules
-----

[](#rules)

### IfConditionHelper

[](#ifconditionhelper)

This helper is used by different "condition"-rules: if - and - or - not - ternary

💡 We use this "hack" (helper) to run the check for all kind of conditions.

- double negative string conditions. e.g. `(string)$foo != ''` is the same as `(string)$foo`
    -
- double negative integer conditions. e.g. `(int)$foo != 0` is the same as `(int)$foo`
    -
- double negative boolean conditions. e.g. `(bool)$foo != false` is the same as `(bool)$foo`
    -
- double negative null conditions. Use "!==" instead if needed
    -
- check 0 vs '' conditions, the behavior was changed in PHP 8
    -
- check possible insane comparisons. e.g. `0 == '0foo'`, the behavior was changed in PHP 8
    -
- check insane comparisons. e.g. `0 === '0'` or `false && true`
- check non-empty string is never empty
- check non-empty string is always empty
- check non-empty array is never empty
- do not compare objects with another type
- do not use magic string-concat for objects with "\_\_toString()"
- do not allow assignments. e.g. `if ($a = 0)` (see "checkForAssignments")
- do not allow Yoda conditions. e.g. `ìf (0 == $a)` (see "checkYodaConditions")

#### Configuration

[](#configuration)

If you want to configure a list of classes / subclasses that can NOT be used in conditions directly:

e.g.:

- ok: `if ($emailValueObject->isValid())`
- error: `if ($emailValueObject != '')`

```
parameters:
    voku:
        classesNotInIfConditions: [
            AbstractValueObject
        ]
```

If you want to check assignments e.g. in "if"-conditions you can use this:

```
parameters:
    voku:
        checkForAssignments: true
```

If you want to check Yoda conditions can use this:

```
parameters:
    voku:
        checkYodaConditions: true
```

### ExtendedBinaryOpRule

[](#extendedbinaryoprule)

This rule will check "+", "\*", "/", "-", ... (operators) and "." (concatenation) for compatible types.

It's included in the default `rules.neon` so that you don't need to add it manually.

### DisallowedCallMethodOnNull

[](#disallowedcallmethodonnull)

This code is copy&pasted from \[`phpstan/phpstan-src`\] and I used it to prevent `Call to a member function on null` errors while I wasn't already on level 8 where all kind of "NULL" checks are already covered by default.

e.g.

```
rules:
    - voku\PHPStan\Rules\DisallowedCallMethodOnNullRule
```

### Support

[](#support)

For support and donations please visit [Github](https://github.com/voku/phpstan-rules/) | [Issues](https://github.com/voku/phpstan-rules/issues) | [PayPal](https://paypal.me/moelleken) | [Patreon](https://www.patreon.com/voku).

For status updates and release announcements please visit [Releases](https://github.com/voku/phpstan-rules/releases) | [Twitter](https://twitter.com/suckup_de) | [Patreon](https://www.patreon.com/voku/posts).

For professional support please contact [me](https://about.me/voku).

### Thanks

[](#thanks)

- Thanks to [GitHub](https://github.com) (Microsoft) for hosting the code and a good infrastructure including Issues-Managment, etc.
- Thanks to [IntelliJ](https://www.jetbrains.com) as they make the best IDEs for PHP and they gave me an open source license for PhpStorm!
- Thanks to [Travis CI](https://travis-ci.com/) for being the most awesome, easiest continous integration tool out there!
- Thanks to [StyleCI](https://styleci.io/) for the simple but powerfull code style check.
- Thanks to [PHPStan](https://github.com/phpstan/phpstan) && [Psalm](https://github.com/vimeo/psalm) for relly great Static analysis tools and for discover bugs in the code!

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance67

Regular maintenance activity

Popularity41

Moderate usage in the ecosystem

Community21

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 70.2% of commits — single point of failure

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 ~27 days

Recently: every ~43 days

Total

40

Last Release

498d ago

Major Versions

1.10.0 → 2.0.02022-07-22

2.0.0 → 3.0.02022-07-29

PHP version history (2 changes)1.0.0PHP ^7.2 || ^8.0

3.6.0PHP ^7.4 || ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/6456fe693db197c458272cb758bf78958bc7d3e787ccd59db4bf3cf41654316a?d=identicon)[voku](/maintainers/voku)

---

Top Contributors

[![voku](https://avatars.githubusercontent.com/u/264695?v=4)](https://github.com/voku "voku (80 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (18 commits)")[![Slamdunk](https://avatars.githubusercontent.com/u/152236?v=4)](https://github.com/Slamdunk "Slamdunk (8 commits)")[![renovate-bot](https://avatars.githubusercontent.com/u/25180681?v=4)](https://github.com/renovate-bot "renovate-bot (7 commits)")[![mend-bolt-for-github[bot]](https://avatars.githubusercontent.com/in/16809?v=4)](https://github.com/mend-bolt-for-github[bot] "mend-bolt-for-github[bot] (1 commits)")

---

Tags

PHPStanphpstan-rulesphpstan-extreme-rules

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/voku-phpstan-rules/health.svg)

```
[![Health](https://phpackages.com/badges/voku-phpstan-rules/health.svg)](https://phpackages.com/packages/voku-phpstan-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)[ergebnis/phpstan-rules

Provides rules for phpstan/phpstan.

4428.9M187](/packages/ergebnis-phpstan-rules)[ekino/phpstan-banned-code

Detected banned code using PHPStan

2925.6M92](/packages/ekino-phpstan-banned-code)[shipmonk/dead-code-detector

Dead code detector to find unused PHP code via PHPStan extension. Can automatically remove dead PHP code. Supports libraries like Symfony, Doctrine, PHPUnit etc. Detects dead cycles. Can detect dead code that is tested.

3462.2M52](/packages/shipmonk-dead-code-detector)[sidz/phpstan-rules

Set of PHPStan rules

31408.9k12](/packages/sidz-phpstan-rules)[ticketswap/phpstan-error-formatter

A minimalistic error formatter for PHPStan

87578.8k35](/packages/ticketswap-phpstan-error-formatter)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)