php - 如何不修改 php-cs-fixer 的某些注释？

Question

我在 php 文件中有这种注释，以构建我的招摇：

/**
 * @OA\Get(
 *      path="/additional_roles",
 *      tags={"additional_roles"},
 *      summary="Get list of additional roles",
 *      description="Returns list of additional roles",

每次我运行 php-cs-fixer 时，注释都会被替换为：

/*
 * @OA\Get(
 *      path="/additional_roles",
 *      tags={"additional_roles"},
 *      summary="Get list of additional roles",
 *      description="Returns list of additional roles",

请参阅第一行的转换 /** ==> /*。后果：不再生成我的招摇文件。

我有一个 .php_cs.dist 文件，其中包含一些 php-cs-fixer 的规则。我正在搜索要更改的参数以防止这种转换。

我试图改变这个参数/值：

'align_multiline_comment' => [
            'comment_type' => 'phpdocs_only',
        ],

没有成功。在此配置文件中更改的正确参数是什么？

Answer 1

根据手册，这是phpdoc_to_comment选项，将其设置为false，以免*从 phpdoc 注释中删除额外内容。

但请阅读phpdoc_to_comment选项的描述：

Docblocks 应该只用于结构元素。

那么，也许您的评论不是关于结构元素，并且确实应该有/*而不应该/**？