fix(php): Improve multiline parameter documentation (#5892)

fern/pages/changelogs/php-sdk/2025-02-05.mdx

@@ -0,0 +1,15 @@
+## 0.3.1
+**`(fix):`** Improve multiline parameter docs by writing them above the tag, e.g.
+```php class UpdateUserRequest extends JsonSerializableType {
+    /**
+    * The user to update.
+    *
+    * See [User](https://acme.co/user) for more information.
+    *
+    * @var ?User $user
+    */
+    public ?User $user;
+} ```
+
+**`(fix):`** Add .idea to the generated .gitignore file.
+

generators/php/codegen/src/asIs/.gitignore

@@ -1,3 +1,4 @@
+.idea
 .php-cs-fixer.cache
 .phpunit.result.cache
 composer.lock

generators/php/codegen/src/ast/Comment.ts

@@ -64,14 +64,24 @@ export class Comment extends AstNode {
     }
 
     private writeTag({ writer, tag }: { writer: Writer; tag: Comment.Tag }): void {
+        const docsSplit = tag.docs != null ? tag.docs.split("\n") : undefined;
+        if (docsSplit != null && docsSplit.length > 1) {
+            docsSplit.forEach((line) => {
+                writer.writeLine(` * ${line}`);
+            });
+            writer.writeLine(` *`);
+        }
+
         writer.write(` * @${tag.tagType} `);
         tag.type.write(writer, { comment: true });
         if (tag.name != null) {
             writer.write(` ${tag.name}`);
         }
-        if (tag.docs != null) {
-            writer.write(` ${tag.docs}`);
+
+        if (docsSplit != null && docsSplit.length === 1) {
+            writer.write(` ${docsSplit[0]}`);
         }
+
         writer.newLine();
     }
 }

generators/php/sdk/versions.yml

@@ -1,3 +1,26 @@
+- version: 0.3.1
+  changelogEntry:
+    - type: fix
+      summary: >-
+        Improve multiline parameter docs by writing them above the tag, e.g.
+
+        ```php
+        class UpdateUserRequest extends JsonSerializableType
+        {
+            /**
+            * The user to update.
+            *
+            * See [User](https://acme.co/user) for more information.
+            *
+            * @var ?User $user
+            */
+            public ?User $user;
+        }
+        ```
+    - type: fix
+      summary: >-
+        Add .idea to the generated .gitignore file.
+  irVersion: 53
 - version: 0.3.0
   changelogEntry:
     - type: feat