Download the PHP package martinsoenen/phpstan-custom-rules without Composer
On this page you can find all versions of the php package martinsoenen/phpstan-custom-rules. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download martinsoenen/phpstan-custom-rules
More information about martinsoenen/phpstan-custom-rules
Files in martinsoenen/phpstan-custom-rules
Package phpstan-custom-rules
Short Description Some custom PHPStan extensions for a better code base
License MIT
Informations about the package phpstan-custom-rules
PHPStan Custom Rules
Some custom PHPStan extensions to improve the readability, maintainability and overall quality of your PHP code base.
Package based on PHPStan. You can find the source package here.
Supported PHP versions
| PHP version | This package version |
|---|---|
| 7.4, 8.x | Latest |
How to use it
1: First, you may use Composer to install this package as a development dependency into your project:
2: Then, create a phpstan.neon or phpstan.neon.dist file in the root of your application. It might look like this:
The most important part is the includes one, that enables the rules of this package.
For all available options, please take a look at the PHPStan documentation: https://phpstan.org/config-reference
3: Finally, you may start analyzing your code using the phpstan console command:
Rules
Boolean Property Naming Rule
Identifier : martinsoenen.booleanPropertyNaming
Ensure that a Boolean is always named with an “is” at the beginning of its name, to clarify the condition it represents.
Max Line Per Class Rule
Identifier : martinsoenen.maxLinePerClass
Guarantee that a class is no more than 100 lines long, to clearly separate roles between classes and encourage clarification.
Max Line Per Method Rule
Identifier : martinsoenen.maxLinePerMethod
Guarantee that a method is no more than 20 lines long, to separate roles between classes and encourage specification.
No Basic Exception Rule
Identifier : martinsoenen.noBasicException
Ensure that no base exceptions are thrown in order to make custom and specific exceptions everywhere for better maintainability.
No Delete Cascade Rule (Laravel)
Identifier : martinsoenen.noCascadeDeleteLaravel
Prevents cascading deletions in SQL to avoid uncontrolled deletions.
This rule forces you to think about the need for a cascading deletion, and to handle such cases in your code if you need to, which also makes it possible to use the observers and events managed by the framework.
This rule only works for Laravel.
A Symfony rule is planned.
No Generic Word Rule
Identifier : martinsoenen.noGenericWord
Prevent generic variable names such as array, string, str, result, res, data to encourage developers to use clear and detailed names such as users, filteredUsers, usersCount, cars, ...
No Laravel Observer Rule
Identifier : martinsoenen.noLaravelObserver
Forbid the use of Observers in Laravel, as the behavior of observers is sometimes incomprehensible and uncontrollable.
This rule encourages the use of Events & Listeners, whose behavior is similar but much more explicit and stable.
No Try Catch Rule
Identifier : martinsoenen.noTryCatch
Prevent try catch usage to ensure that the user uses PHP exceptions.
This makes the code more readable and errors are handled by the framework if there is one.