如何不被php-cs-fixer修改一些注释？

Question

我在php文件中有这样的注释，用来构建我的swagger：

/**
 * @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",

请参阅第一行的tranformation /** ==> /*。后果:我的swagger文件不再生成。

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

我尝试更改此参数/值：

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

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

Answer 1

根据manual this is phpdoc选项，将其设置为false，这样就不会从phpdoc注释中删除额外的*。

但请阅读phpdoc_to_comment选项的描述：

文档块只能在结构元素上使用。

所以，也许你的注释不是关于结构元素的，而应该是/*而不是/**