php - phpcodesniffer“标签不能与文档注释中的参数标签分组”产生的错误是什么

Question

/**
  * @param Varien_Event_Observer $observer eventobserver
  * @return void
  */

phpCodesniffer 为上述行生成以下错误。

41 | 错误 | 标签不能与文档注释中的参数标签分组。

会是什么原因？

Answer 1

PHP_CodeSniffer 在函数 doc 块中的两个连续行中隔离一组参数。所以在paramtag line和returntag line之间加一行就可以兼容PHP_CodeSniffer。

/**
  * @param Varien_Event_Observer $observer eventobserver
  *
  * @return void
  */

Answer 2

在 phpstan 中，您必须隔离代码块以显示和调试参数

/**
 * Create a new user instance after a valid registration.
 *
 * @param array $data comment
 * 
 * @return \App\Models\User
 */