php - phpcs：缺少参数注释

Question

我有以下代码：

/**
 * @param TranscodingJob $transcodingJob
 *
 * @return TranscodingJob
 * @throws \Lexik\Bundle\WorkflowBundle\Exception\WorkflowException
 */
public function onTranscodingJobError(TranscodingJob $transcodingJob) { ...

...我发现当我将鼠标悬停在注释上时，会出现以下注释：

phpcs：缺少参数注释

如何修改我的注释以使投诉消失？

（我尝试在参数的注释上方简单地添加文本，但这似乎并没有解决它。）

Answer 1

您需要为您的 @param 变量添加注释

将您的代码更改为

 /**
 * @param TranscodingJob $transcodingJob comment about this variable
 *
 * @return TranscodingJob
 * @throws \Lexik\Bundle\WorkflowBundle\Exception\WorkflowException
 */