From 903b5bdb8dd65f973b017261456e741d6e91b51e Mon Sep 17 00:00:00 2001
From: phpstan-bot <79867460+phpstan-bot@users.noreply.github.com>
Date: Tue, 10 Mar 2026 14:32:59 +0000
Subject: [PATCH] Report error when using enum case outside of enum

- Added new EnumCaseOutsideEnumRule that reports an error when `case` is used in classes or interfaces instead of enums
- New regression test in tests/PHPStan/Rules/EnumCases/data/bug-14252.php
- The rule is registered at level 0 and uses the identifier `enum.caseOutsideOfEnum`

Closes https://github.com/phpstan/phpstan/issues/14252
---
 .../EnumCases/EnumCaseOutsideEnumRule.php     | 42 +++++++++++++++++++
 .../EnumCases/EnumCaseOutsideEnumRuleTest.php | 35 ++++++++++++++++
 .../Rules/EnumCases/data/bug-14252.php        | 20 +++++++++
 3 files changed, 97 insertions(+)
 create mode 100644 src/Rules/EnumCases/EnumCaseOutsideEnumRule.php
 create mode 100644 tests/PHPStan/Rules/EnumCases/EnumCaseOutsideEnumRuleTest.php
 create mode 100644 tests/PHPStan/Rules/EnumCases/data/bug-14252.php

diff --git a/src/Rules/EnumCases/EnumCaseOutsideEnumRule.php b/src/Rules/EnumCases/EnumCaseOutsideEnumRule.php
new file mode 100644
index 0000000000..ba0290e5ea
--- /dev/null
+++ b/src/Rules/EnumCases/EnumCaseOutsideEnumRule.php
@@ -0,0 +1,42 @@
+<?php declare(strict_types = 1);
+
+namespace PHPStan\Rules\EnumCases;
+
+use PhpParser\Node;
+use PHPStan\Analyser\Scope;
+use PHPStan\DependencyInjection\RegisteredRule;
+use PHPStan\Rules\Rule;
+use PHPStan\Rules\RuleErrorBuilder;
+
+/**
+ * @implements Rule<Node\Stmt\EnumCase>
+ */
+#[RegisteredRule(level: 0)]
+final class EnumCaseOutsideEnumRule implements Rule
+{
+
+	public function getNodeType(): string
+	{
+		return Node\Stmt\EnumCase::class;
+	}
+
+	public function processNode(Node $node, Scope $scope): array
+	{
+		if (!$scope->isInClass()) {
+			return [];
+		}
+
+		$classReflection = $scope->getClassReflection();
+		if ($classReflection->isEnum()) {
+			return [];
+		}
+
+		return [
+			RuleErrorBuilder::message('Enum case can only be used in enums.')
+				->nonIgnorable()
+				->identifier('enum.caseOutsideOfEnum')
+				->build(),
+		];
+	}
+
+}
diff --git a/tests/PHPStan/Rules/EnumCases/EnumCaseOutsideEnumRuleTest.php b/tests/PHPStan/Rules/EnumCases/EnumCaseOutsideEnumRuleTest.php
new file mode 100644
index 0000000000..7c86412167
--- /dev/null
+++ b/tests/PHPStan/Rules/EnumCases/EnumCaseOutsideEnumRuleTest.php
@@ -0,0 +1,35 @@
+<?php declare(strict_types = 1);
+
+namespace PHPStan\Rules\EnumCases;
+
+use PHPStan\Rules\Rule;
+use PHPStan\Testing\RuleTestCase;
+use PHPUnit\Framework\Attributes\RequiresPhp;
+
+/**
+ * @extends RuleTestCase<EnumCaseOutsideEnumRule>
+ */
+class EnumCaseOutsideEnumRuleTest extends RuleTestCase
+{
+
+	protected function getRule(): Rule
+	{
+		return new EnumCaseOutsideEnumRule();
+	}
+
+	#[RequiresPhp('>= 8.1')]
+	public function testRule(): void
+	{
+		$this->analyse([__DIR__ . '/data/bug-14252.php'], [
+			[
+				'Enum case can only be used in enums.',
+				9,
+			],
+			[
+				'Enum case can only be used in enums.',
+				14,
+			],
+		]);
+	}
+
+}
diff --git a/tests/PHPStan/Rules/EnumCases/data/bug-14252.php b/tests/PHPStan/Rules/EnumCases/data/bug-14252.php
new file mode 100644
index 0000000000..d8f86ec336
--- /dev/null
+++ b/tests/PHPStan/Rules/EnumCases/data/bug-14252.php
@@ -0,0 +1,20 @@
+<?php // lint >= 8.1
+
+declare(strict_types = 1);
+
+namespace Bug14252;
+
+class Foo
+{
+	case Active;
+}
+
+interface Bar
+{
+	case Active;
+}
+
+enum Qux
+{
+	case Active;
+}