feat: Add PHPStan-Rule MLL\Utils\PHPStan\Rules\VariableNameIdToIDRule

CHANGELOG.md

@@ -9,6 +9,12 @@ See [GitHub releases](https://github.com/mll-lab/php-utils/releases).
 
 ## Unreleased
 
+## v5.7.0
+
+### Added
+
+- Add PHPStan-Rule `MLL\Utils\PHPStan\Rules\VariableNameIdToIDRule`
+
 ## v5.6.0
 
 ### Added

src/PHPStan/Rules/VariableNameIdToIDRule.php

@@ -0,0 +1,41 @@
+<?php declare(strict_types=1);
+
+namespace MLL\Utils\PHPStan\Rules;
+
+use Illuminate\Support\Str;
+use PhpParser\Node;
+use PHPStan\Analyser\Scope;
+use PHPStan\Rules\Rule;
+use PHPStan\Rules\RuleErrorBuilder;
+
+/**
+ * @implements Rule<Node\Expr\Variable>
+ */
+class VariableNameIdToIDRule implements Rule
+{
+    private const WHITELIST = ['Identifier'];
+
+    public function getNodeType(): string
+    {
+        return Node\Expr\Variable::class;
+    }
+
+    public function processNode(Node $node, Scope $scope): array
+    {
+        if (
+            $node instanceof Node\Expr\Variable
+            && is_string($node->name)
+            && \Safe\preg_match('/Id/', $node->name)
+            && ! Str::contains($node->name, self::WHITELIST)
+        ) {
+            return [
+                RuleErrorBuilder::message(sprintf(
+                    'Variable name "$%s" should use "ID" instead of "Id".',
+                    $node->name,
+                ))->build(),
+            ];
+        }
+
+        return [];
+    }
+}