Add Method attribute

README.md

@@ -97,6 +97,7 @@ These are the available attributes and their corresponding PHPDoc annotations:
 | Attribute                                                                                                         | PHPDoc Annotations        |
 |-------------------------------------------------------------------------------------------------------------------|---------------------------|
 | [IsReadOnly](https://github.com/php-static-analysis/attributes/blob/main/doc/IsReadOnly.md)                       | `@readonly`               |
+| [Method](https://github.com/php-static-analysis/attributes/blob/main/doc/Method.md)                               | `@method`                 |
 | [Param](https://github.com/php-static-analysis/attributes/blob/main/doc/Param.md)                                 | `@param`                  |
 | [Property](https://github.com/php-static-analysis/attributes/blob/main/doc/Property.md)                           | `@property` `@var`        |
 | [PropertyRead](https://github.com/php-static-analysis/attributes/blob/main/doc/PropertyRead.md)                   | `@property-read`          |

composer.json

@@ -24,8 +24,8 @@
     "prefer-stable": true,
     "require": {
         "php": ">=8.0",
-        "php-static-analysis/attributes": "^0.1.5 || dev-main",
-        "php-static-analysis/node-visitor": "^0.1.5 || dev-main",
+        "php-static-analysis/attributes": "^0.1.6 || dev-main",
+        "php-static-analysis/node-visitor": "^0.1.6 || dev-main",
         "phpstan/phpstan": "^1.8"
     },
     "require-dev": {

tests/MethodAttributeTest.php

@@ -0,0 +1,39 @@
+<?php
+
+namespace test\PhpStaticAnalysis\PHPStanExtension;
+
+class MethodAttributeTest extends BaseAttributeTestCase
+{
+    public function testClassMethodAttribute(): void
+    {
+        $errors = $this->analyse(__DIR__ . '/data/Method/ClassMethodAttribute.php');
+        $this->assertCount(0, $errors);
+    }
+
+    public function testInterfaceMethodAttribute(): void
+    {
+        $errors = $this->analyse(__DIR__ . '/data/Method/InterfaceMethodAttribute.php');
+        $this->assertCount(0, $errors);
+    }
+
+    public function testTraitMethodAttribute(): void
+    {
+        $errors = $this->analyse(__DIR__ . '/data/Method/TraitMethodAttribute.php');
+        $this->assertCount(0, $errors);
+    }
+
+    public function testInvalidClassMethodAttribute(): void
+    {
+        $errors = $this->analyse(__DIR__ . '/data/Method/InvalidClassMethodAttribute.php');
+
+        $expectedErrors = [
+            'PHPDoc tag @method has invalid value (): Unexpected token "\n * ", expected type at offset 14' => 8,
+            'PHPDoc tag @method has invalid value (string): Unexpected token "\n * ", expected \'(\' at offset 32' => 8,
+            'Parameter #1 ...$params of attribute class PhpStaticAnalysis\Attributes\Method constructor expects string, int given.' => 8,
+            'Attribute class PhpStaticAnalysis\Attributes\Method does not have the method target.' => 13,
+            'Call to an undefined method test\PhpStaticAnalysis\PHPStanExtension\data\Method\InvalidClassMethodAttribute::badFunction().' => 31,
+        ];
+
+        $this->checkExpectedErrors($errors, $expectedErrors);
+    }
+}

tests/data/Method/ClassMethodAttribute.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace test\PhpStaticAnalysis\PHPStanExtension\data\Method;
+
+use PhpStaticAnalysis\Attributes\Method;
+use PhpStaticAnalysis\Attributes\Param;
+
+#[Method('string getString()')]
+#[Method(
+    'void setString(string $text)',
+    'static string staticGetter()',
+)]
+class ClassMethodAttribute
+{
+    #[Param(arguments: 'mixed[]')]
+    public function __call(string $name, array $arguments): mixed
+    {
+        $callable = [$this, $name];
+        if (is_callable($callable)) {
+            return call_user_func_array($callable, $arguments);
+        }
+        return null;
+    }
+}
+
+$class = new ClassMethodAttribute();
+$foo = $class->getString();
+$class->setString($foo);
+$bar = ClassMethodAttribute::staticGetter();

tests/data/Method/InterfaceMethodAttribute.php

@@ -0,0 +1,10 @@
+<?php
+
+namespace test\PhpStaticAnalysis\PHPStanExtension\data\Method;
+
+use PhpStaticAnalysis\Attributes\Method;
+
+#[Method('string getString()')]
+interface InterfaceMethodAttribute
+{
+}

tests/data/Method/InvalidClassMethodAttribute.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace test\PhpStaticAnalysis\PHPStanExtension\data\Method;
+
+use PhpStaticAnalysis\Attributes\Method;
+use PhpStaticAnalysis\Attributes\Param;
+
+#[Method(0)]
+#[Method('string')]
+#[Method('count($a)')]
+class InvalidClassMethodAttribute
+{
+    #[Method('string getString()')]
+    public function getName(): string
+    {
+        return "John";
+    }
+
+    #[Param(arguments: 'mixed[]')]
+    public function __call(string $name, array $arguments): mixed
+    {
+        $callable = [$this, $name];
+        if (is_callable($callable)) {
+            return call_user_func_array($callable, $arguments);
+        }
+        return null;
+    }
+}
+
+$class = new InvalidClassMethodAttribute();
+$class->badFunction();

tests/data/Method/TraitMethodAttribute.php

@@ -0,0 +1,10 @@
+<?php
+
+namespace test\PhpStaticAnalysis\PHPStanExtension\data\Method;
+
+use PhpStaticAnalysis\Attributes\Method;
+
+#[Method('string getString()')]
+trait TraitMethodAttribute
+{
+}