Solve some cases of dead code

ondrejmirtes · ondrejmirtes · commit e1e8302327e7 · 2025-05-16T14:14:20.000+02:00
diff --git a/build/phpstan.neon b/build/phpstan.neon
@@ -61,7 +61,6 @@ parameters:
 			- 'PHPStan\Reflection\MissingPropertyFromReflectionException'
 			- 'PHPStan\Reflection\MissingConstantFromReflectionException'
 			- 'PHPStan\Type\CircularTypeAliasDefinitionException'
-			- 'PHPStan\Broker\ClassAutoloadingException'
 			- 'LogicException'
 			- 'Error'
 		check:
diff --git a/src/Analyser/UndefinedVariableException.php b/src/Analyser/UndefinedVariableException.php
@@ -5,6 +5,12 @@
 use PHPStan\AnalysedCodeException;
 use function sprintf;
 
+/**
+ * @api
+ *
+ * Unchecked exception thrown from `PHPStan\Analyser\Scope::getVariableType()`
+ * in case the user doesn't check `hasVariableType()` is not `no()`.
+ */
 final class UndefinedVariableException extends AnalysedCodeException
 {
 
diff --git a/src/Broker/ClassAutoloadingException.php b/src/Broker/ClassAutoloadingException.php
diff --git a/src/Broker/ClassNotFoundException.php b/src/Broker/ClassNotFoundException.php
@@ -5,6 +5,13 @@
 use PHPStan\AnalysedCodeException;
 use function sprintf;
 
+/**
+ * @api
+ *
+ * Unchecked exception thrown from `ReflectionProvider` and other places
+ * in case the user does not check the existence of the class beforehand
+ * with `hasClass()` or similar.
+ */
 final class ClassNotFoundException extends AnalysedCodeException
 {
 
diff --git a/src/Broker/ConstantNotFoundException.php b/src/Broker/ConstantNotFoundException.php
@@ -5,6 +5,13 @@
 use PHPStan\AnalysedCodeException;
 use function sprintf;
 
+/**
+ * @api
+ *
+ * Unchecked exception thrown from `ReflectionProvider`
+ * in case the user does not check the existence of the constant beforehand
+ * with `hasConstant()`.
+ */
 final class ConstantNotFoundException extends AnalysedCodeException
 {
 
diff --git a/src/Broker/FunctionNotFoundException.php b/src/Broker/FunctionNotFoundException.php
@@ -5,6 +5,13 @@
 use PHPStan\AnalysedCodeException;
 use function sprintf;
 
+/**
+ * @api
+ *
+ * Unchecked exception thrown from `ReflectionProvider`
+ * in case the user does not check the existence of the function beforehand
+ * with `hasFunction()`.
+ */
 final class FunctionNotFoundException extends AnalysedCodeException
 {
 
