From a53d9e1e97c32eaff2ad7e7b3339d04256611feb Mon Sep 17 00:00:00 2001
From: Tomas Votruba <tomas.vot@gmail.com>
Date: Mon, 24 Aug 2026 19:51:40 +0100
Subject: [PATCH] [NoMissnamedDocTagRule] skip @return/@param inside constant
 prose docblock

---
 src/Rules/NoMissnamedDocTagRule.php                |  2 +-
 .../Fixture/SkipConstantPartOfComment.php          | 14 ++++++++++++++
 .../NoMissnamedDocTagRuleTest.php                  |  1 +
 3 files changed, 16 insertions(+), 1 deletion(-)
 create mode 100644 tests/Rules/NoMissnamedDocTagRule/Fixture/SkipConstantPartOfComment.php

diff --git a/src/Rules/NoMissnamedDocTagRule.php b/src/Rules/NoMissnamedDocTagRule.php
index 0fb0be027..b3de6e50b 100644
--- a/src/Rules/NoMissnamedDocTagRule.php
+++ b/src/Rules/NoMissnamedDocTagRule.php
@@ -87,7 +87,7 @@ public function processNode(Node $node, Scope $scope): array
                 continue;
             }
 
-            $matches = Strings::match($classConst->getDocComment()->getText(), '#(@param|@return)\b#mi');
+            $matches = Strings::match($classConst->getDocComment()->getText(), '#\*\s(@param|@return)\b#mi');
             if ($matches === null) {
                 continue;
             }
diff --git a/tests/Rules/NoMissnamedDocTagRule/Fixture/SkipConstantPartOfComment.php b/tests/Rules/NoMissnamedDocTagRule/Fixture/SkipConstantPartOfComment.php
new file mode 100644
index 000000000..55ce53c8f
--- /dev/null
+++ b/tests/Rules/NoMissnamedDocTagRule/Fixture/SkipConstantPartOfComment.php
@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Symplify\PHPStanRules\Tests\Rules\NoMissnamedDocTagRule\Fixture;
+
+final class SkipConstantPartOfComment
+{
+    /**
+     * Using 10-level array @return docblocks makes code very hard to read,
+     * lets limit it to reasonable level
+     */
+    private const int MAX_NESTING = 3;
+}
diff --git a/tests/Rules/NoMissnamedDocTagRule/NoMissnamedDocTagRuleTest.php b/tests/Rules/NoMissnamedDocTagRule/NoMissnamedDocTagRuleTest.php
index d2f5cea35..a716fd42a 100644
--- a/tests/Rules/NoMissnamedDocTagRule/NoMissnamedDocTagRuleTest.php
+++ b/tests/Rules/NoMissnamedDocTagRule/NoMissnamedDocTagRuleTest.php
@@ -41,6 +41,7 @@ public static function provideData(): Iterator
 
         yield [__DIR__ . '/Fixture/SkipValidPropertyTag.php', []];
         yield [__DIR__ . '/Fixture/SkipPartOfComment.php', []];
+        yield [__DIR__ . '/Fixture/SkipConstantPartOfComment.php', []];
     }
 
     /**