Download the PHP package hxv/phpstan-event-dispatcher-exceptions without Composer
On this page you can find all versions of the php package hxv/phpstan-event-dispatcher-exceptions. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download hxv/phpstan-event-dispatcher-exceptions
More information about hxv/phpstan-event-dispatcher-exceptions
Files in hxv/phpstan-event-dispatcher-exceptions
Package phpstan-event-dispatcher-exceptions
Short Description PHPStan extension and rules for exceptions in Symfony EventDispatcher.
License WTFPL
Informations about the package phpstan-event-dispatcher-exceptions
Since version 0.12.87 PHPStan analyses and checks
thrown exceptions - hooray! pepakriz/phpstan-exception-rules
does the same thing
(and more), but it's nice to have this out of the box.
However, there are some cases that are "too dynamic" for static analysis to work automatically and thus require additional extensions.
This one aims to provide support for Symfony's Event Dispatcher.
Problem
Every time you dispatch an event, any of the handlers can throw an exception - since PHPStan doesn't know anything about them you can:
- ignore them
- remember which event throws which exceptions
- analyse handlers
- do not throw any exceptions in handlers
- catch everything
If you don't choose first or last option, you have to be very careful when modifying handlers - new exceptions can cause problems. If you do - well, you probably do not need this extension.
Solution
Solution to above problem is to annotate exceptions with @throws
tag on class level for every event:
Having exceptions assigned to events analysis can be more complete and warn about new problems.
From now on PHPStan knows that dispatching that event can throw RuntimeException
:
There is also a rule to monitor exceptions thrown in subscribers:
Installation
Require extension in composer:
If you have PHPStan Extension Installer - that's all!
If not - you have to manually add extension to your phpstan.neon
:
All versions of phpstan-event-dispatcher-exceptions with dependencies
phpstan/phpstan Version ^0.12.87
symfony/event-dispatcher Version ^4.3|^5.0