From a29d76d87dfbbb8fe227fa07033a07b788f68e70 Mon Sep 17 00:00:00 2001
From: Tomas Votruba <tomas.vot@gmail.com>
Date: Tue, 22 Sep 2026 12:11:33 +0200
Subject: [PATCH 1/3] group naming rules under 'naming' parameter, on by
 default

---
 README.md                      | 43 +++++++++-------------------------
 composer.json                  |  1 +
 config/naming-rules.neon       | 23 +++++++++++++++++-
 config/phpstan-extensions.neon |  2 ++
 config/static-rules.neon       |  3 ---
 5 files changed, 36 insertions(+), 36 deletions(-)

diff --git a/README.md b/README.md
index 9049aa9a7..02fc1ebd8 100644
--- a/README.md
+++ b/README.md
@@ -36,7 +36,6 @@ Once you have most rules applied, it's best practice to include whole sets:
 includes:
     - vendor/symplify/phpstan-rules/config/code-complexity-rules.neon
     - vendor/symplify/phpstan-rules/config/configurable-rules.neon
-    - vendor/symplify/phpstan-rules/config/naming-rules.neon
     - vendor/symplify/phpstan-rules/config/static-rules.neon
 
     # project specific
@@ -49,6 +48,16 @@ includes:
 
 <br>
 
+The naming rules (class/constant naming and namespace rules, e.g. interface must live in a "Contract" namespace) load automatically and are **enabled by default**. Turn them off with the `naming` parameter:
+
+```yaml
+parameters:
+    symplify:
+        naming: false
+```
+
+<br>
+
 ### Symfony/Laravel container `->get()`/`->make()` return type extensions
 
 Want sharper type inference? The return type extensions are **disabled by default** — enable the ones that fit your stack:
@@ -155,11 +164,6 @@ function run(int $userId)
 
 Interface must be located in "Contract" or "Contracts" namespace
 
-```yaml
-rules:
-    - Symplify\PHPStanRules\Rules\CheckRequiredInterfaceInContractNamespaceRule
-```
-
 ```php
 namespace App\Repository;
 
@@ -188,7 +192,7 @@ interface ProductRepositoryInterface
 
 Class should have suffix "%s" to respect parent type
 
-:wrench: **configure it!**
+On by default via the `naming` parameter with a built-in parent list. To extend it with your own parents, set `naming: false` and register the rule yourself:
 
 ```yaml
 services:
@@ -327,11 +331,6 @@ final class SomeClass extends ParentClass
 
 Interface have suffix of "Interface", trait have "Trait" suffix exclusively
 
-```yaml
-rules:
-    - Symplify\PHPStanRules\Rules\Explicit\ExplicitClassPrefixSuffixRule
-```
-
 ```php
 <?php
 
@@ -829,11 +828,6 @@ class SomeClass
 
 Setter method cannot return anything, only set value
 
-```yaml
-rules:
-    - Symplify\PHPStanRules\Rules\NoReturnSetterMethodRule
-```
-
 ```php
 final class SomeClass
 {
@@ -1091,11 +1085,6 @@ rules:
 
 Attribute must be located in "Attribute" namespace
 
-```yaml
-rules:
-    - Symplify\PHPStanRules\Rules\Domain\RequireAttributeNamespaceRule
-```
-
 ```php
 // app/Entity/SomeAttribute.php
 namespace App\Controller;
@@ -1128,11 +1117,6 @@ final class SomeAttribute
 
 `Exception` must be located in "Exception" namespace
 
-```yaml
-rules:
-    - Symplify\PHPStanRules\Rules\Domain\RequireExceptionNamespaceRule
-```
-
 ```php
 // app/Controller/SomeException.php
 namespace App\Controller;
@@ -1244,11 +1228,6 @@ class SomeClass extends Rule
 
 Constant "%s" must be uppercase
 
-```yaml
-rules:
-    - Symplify\PHPStanRules\Rules\UppercaseConstantRule
-```
-
 ```php
 final class SomeClass
 {
diff --git a/composer.json b/composer.json
index b3c109268..c77b678d8 100644
--- a/composer.json
+++ b/composer.json
@@ -62,6 +62,7 @@
         "phpstan": {
             "includes": [
                 "config/services/services.neon",
+                "config/naming-rules.neon",
                 "config/ctor-rules.neon",
                 "config/mock-rules.neon",
                 "config/phpstan-extensions.neon"
diff --git a/config/naming-rules.neon b/config/naming-rules.neon
index 6636a3f51..0bfffce67 100644
--- a/config/naming-rules.neon
+++ b/config/naming-rules.neon
@@ -1,5 +1,26 @@
-rules:
+conditionalTags:
+    Symplify\PHPStanRules\Rules\Explicit\ExplicitClassPrefixSuffixRule:
+        phpstan.rules.rule: %symplify.naming%
+    Symplify\PHPStanRules\Rules\NoReturnSetterMethodRule:
+        phpstan.rules.rule: %symplify.naming%
+    Symplify\PHPStanRules\Rules\UppercaseConstantRule:
+        phpstan.rules.rule: %symplify.naming%
+    Symplify\PHPStanRules\Rules\ClassNameRespectsParentSuffixRule:
+        phpstan.rules.rule: %symplify.naming%
+
+    # namespace
+    Symplify\PHPStanRules\Rules\Domain\RequireExceptionNamespaceRule:
+        phpstan.rules.rule: %symplify.naming%
+    Symplify\PHPStanRules\Rules\Domain\RequireAttributeNamespaceRule:
+        phpstan.rules.rule: %symplify.naming%
+    Symplify\PHPStanRules\Rules\CheckRequiredInterfaceInContractNamespaceRule:
+        phpstan.rules.rule: %symplify.naming%
+
+services:
     - Symplify\PHPStanRules\Rules\Explicit\ExplicitClassPrefixSuffixRule
     - Symplify\PHPStanRules\Rules\NoReturnSetterMethodRule
     - Symplify\PHPStanRules\Rules\UppercaseConstantRule
     - Symplify\PHPStanRules\Rules\ClassNameRespectsParentSuffixRule
+    - Symplify\PHPStanRules\Rules\Domain\RequireExceptionNamespaceRule
+    - Symplify\PHPStanRules\Rules\Domain\RequireAttributeNamespaceRule
+    - Symplify\PHPStanRules\Rules\CheckRequiredInterfaceInContractNamespaceRule
diff --git a/config/phpstan-extensions.neon b/config/phpstan-extensions.neon
index b5b649d83..547cc98c3 100644
--- a/config/phpstan-extensions.neon
+++ b/config/phpstan-extensions.neon
@@ -1,5 +1,6 @@
 parameters:
     symplify:
+        naming: true
         mocks: false
         ctor: false
         symfonyReturnType: false
@@ -13,6 +14,7 @@ parameters:
 
 parametersSchema:
     symplify: structure([
+        naming: bool()
         mocks: bool()
         ctor: bool()
         symfonyReturnType: bool()
diff --git a/config/static-rules.neon b/config/static-rules.neon
index 8228ec45f..e83679061 100644
--- a/config/static-rules.neon
+++ b/config/static-rules.neon
@@ -3,9 +3,6 @@ rules:
     - Symplify\PHPStanRules\Rules\NoGlobalConstRule
 
     # domain
-    - Symplify\PHPStanRules\Rules\Domain\RequireExceptionNamespaceRule
-    - Symplify\PHPStanRules\Rules\Domain\RequireAttributeNamespaceRule
-    - Symplify\PHPStanRules\Rules\CheckRequiredInterfaceInContractNamespaceRule
     - Symplify\PHPStanRules\Rules\RequireAttributeNameRule
 
     - Symplify\PHPStanRules\Rules\Enum\RequireUniqueEnumConstantRule

From aff1406ed38989c5b9d8db5884aa616673d97134 Mon Sep 17 00:00:00 2001
From: Tomas Votruba <tomas.vot@gmail.com>
Date: Tue, 22 Sep 2026 12:34:51 +0200
Subject: [PATCH 2/3] keep per-rule registration snippets in README

---
 README.md | 32 +++++++++++++++++++++++++++++++-
 1 file changed, 31 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 02fc1ebd8..cb2a1cb22 100644
--- a/README.md
+++ b/README.md
@@ -164,6 +164,11 @@ function run(int $userId)
 
 Interface must be located in "Contract" or "Contracts" namespace
 
+```yaml
+rules:
+    - Symplify\PHPStanRules\Rules\CheckRequiredInterfaceInContractNamespaceRule
+```
+
 ```php
 namespace App\Repository;
 
@@ -192,7 +197,7 @@ interface ProductRepositoryInterface
 
 Class should have suffix "%s" to respect parent type
 
-On by default via the `naming` parameter with a built-in parent list. To extend it with your own parents, set `naming: false` and register the rule yourself:
+:wrench: **configure it!**
 
 ```yaml
 services:
@@ -331,6 +336,11 @@ final class SomeClass extends ParentClass
 
 Interface have suffix of "Interface", trait have "Trait" suffix exclusively
 
+```yaml
+rules:
+    - Symplify\PHPStanRules\Rules\Explicit\ExplicitClassPrefixSuffixRule
+```
+
 ```php
 <?php
 
@@ -828,6 +838,11 @@ class SomeClass
 
 Setter method cannot return anything, only set value
 
+```yaml
+rules:
+    - Symplify\PHPStanRules\Rules\NoReturnSetterMethodRule
+```
+
 ```php
 final class SomeClass
 {
@@ -1085,6 +1100,11 @@ rules:
 
 Attribute must be located in "Attribute" namespace
 
+```yaml
+rules:
+    - Symplify\PHPStanRules\Rules\Domain\RequireAttributeNamespaceRule
+```
+
 ```php
 // app/Entity/SomeAttribute.php
 namespace App\Controller;
@@ -1117,6 +1137,11 @@ final class SomeAttribute
 
 `Exception` must be located in "Exception" namespace
 
+```yaml
+rules:
+    - Symplify\PHPStanRules\Rules\Domain\RequireExceptionNamespaceRule
+```
+
 ```php
 // app/Controller/SomeException.php
 namespace App\Controller;
@@ -1228,6 +1253,11 @@ class SomeClass extends Rule
 
 Constant "%s" must be uppercase
 
+```yaml
+rules:
+    - Symplify\PHPStanRules\Rules\UppercaseConstantRule
+```
+
 ```php
 final class SomeClass
 {

From 60e14abc860ee113236e76133d7c2662542e7115 Mon Sep 17 00:00:00 2001
From: Tomas Votruba <tomas.vot@gmail.com>
Date: Tue, 22 Sep 2026 12:35:57 +0200
Subject: [PATCH 3/3] list ExplicitClassPrefixSuffixRule identifiers in README

---
 README.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/README.md b/README.md
index cb2a1cb22..512cb83dc 100644
--- a/README.md
+++ b/README.md
@@ -341,6 +341,14 @@ rules:
     - Symplify\PHPStanRules\Rules\Explicit\ExplicitClassPrefixSuffixRule
 ```
 
+Reported under these identifiers:
+
+```yaml
+- identifier: symplify.explicitAbstractPrefixName
+- identifier: symplify.explicitInterfaceSuffixName
+- identifier: symplify.explicitTraitSuffixName
+```
+
 ```php
 <?php