由phpcodesniffer生成的错误是什么？“标签不能与文档注释中的参数标记分组”。

Question

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

phpCodesniffer为上面的行生成以下错误。

41 \\ ERROR \\标签不能与文档注释中的参数标记分组。

原因是什么？

Answer 1

PHP_CodeSniffer在函数doc块中的两个连续行中分离一组参数。因此，在param标记行和return标记行之间添加一行将使其与PHP_CodeSniffer兼容。

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

Answer 2

在phpstan中，必须隔离代码块以显示和调试params。

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