Add CS phpdoc_line_span rule for class/method docblocks

Enforces multi-line docblocks on class/interface/trait/enum and method
declarations while preserving existing style for properties and constants.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: DerManoMann

.php-cs-fixer.dist.php

@@ -98,6 +98,7 @@
         'phpdoc_no_alias_tag' => true,
         'phpdoc_param_order' => true,
         'multiline_comment_opening_closing' => true,
+        'phpdoc_line_span' => ['class' => 'multi', 'method' => 'multi', 'property' => null, 'const' => null, 'case' => null, 'function' => null],
 
         'php_unit_attributes' => true,
     ])

docs/snippets/guide/cookbook/enums_an.php

@@ -4,15 +4,19 @@
 
 use OpenApi\Annotations as OA;
 
-/** @OA\Schema() */
+/**
+ * @OA\Schema()
+ */
 enum State
 {
     case OPEN;
     case MERGED;
     case DECLINED;
 }
 
-/** @OA\Schema */
+/**
+ * @OA\Schema
+ */
 class PullRequest
 {
     /** @OA\Property */

src/Generator.php

@@ -73,7 +73,9 @@ public function __construct(?LoggerInterface $logger = null)
         $this->setNamespaces(self::DEFAULT_NAMESPACES);
     }
 
-    /** @deprecated Use {@see Undefined::isDefault()} instead. */
+    /**
+     * @deprecated Use {@see Undefined::isDefault()} instead.
+     */
     public static function isDefault(...$value): bool
     {
         return Undefined::isDefault(...$value);

src/Type/LegacyTypeResolver.php

@@ -17,7 +17,9 @@
  */
 class LegacyTypeResolver extends AbstractTypeResolver
 {
-    /** @inheritdoc */
+    /**
+     * @inheritdoc
+     */
     protected function doAugment(Analysis $analysis, OA\Schema $schema, \Reflector $reflector, string $sourceClass = OA\Schema::class): void
     {
         $docblockDetails = $this->getDocblockTypeDetails($reflector, $schema->_context);

src/Type/TypeInfoTypeResolver.php

@@ -37,7 +37,9 @@
 
 class TypeInfoTypeResolver extends AbstractTypeResolver
 {
-    /** @inheritdoc */
+    /**
+     * @inheritdoc
+     */
     protected function doAugment(Analysis $analysis, OA\Schema $schema, \Reflector $reflector, string $sourceClass = OA\Schema::class): void
     {
         $docblockType = $this->getDocblockType($reflector);

tests/Fixtures/Scratch/ComplexCustomAttributes.php

@@ -66,7 +66,9 @@ public function __construct(
 )]
 class Collection extends OAT\Property
 {
-    /** @param class-string $of */
+    /**
+     * @param class-string $of
+     */
     public function __construct(
         string $of,
         ?string $description = null
@@ -90,7 +92,9 @@ public function __construct(
 )]
 class Item extends OAT\Property
 {
-    /** @param class-string $of */
+    /**
+     * @param class-string $of
+     */
     public function __construct(
         string $of,
         ?string $description = null
@@ -128,7 +132,9 @@ public function __construct(
 #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD | \Attribute::IS_REPEATABLE)]
 class Successful extends OAT\Response
 {
-    /** @param ?class-string $of */
+    /**
+     * @param ?class-string $of
+     */
     public function __construct(
         ?string $of = null,
     ) {

tests/Fixtures/Scratch/CustomAttributes.php

@@ -28,7 +28,9 @@ class CustomProperty extends OAT\Property
 #[\Attribute(\Attribute::TARGET_METHOD | \Attribute::TARGET_PROPERTY | \Attribute::TARGET_PARAMETER | \Attribute::TARGET_CLASS_CONSTANT | \Attribute::IS_REPEATABLE)]
 class CustomItem extends OAT\Property
 {
-    /** @param class-string $of */
+    /**
+     * @param class-string $of
+     */
     public function __construct(
         string $of,
         ?string $description = null
@@ -44,7 +46,9 @@ public function __construct(
 #[\Attribute(\Attribute::TARGET_METHOD | \Attribute::TARGET_PROPERTY | \Attribute::TARGET_PARAMETER | \Attribute::TARGET_CLASS_CONSTANT | \Attribute::IS_REPEATABLE)]
 class CustomList extends OAT\Property
 {
-    /** @param class-string $of */
+    /**
+     * @param class-string $of
+     */
     public function __construct(string $of, ?string $description = null)
     {
         parent::__construct(