symfony - @param注解在symfony2类文件中有什么作用

Question

在 symfony2 和学说 2 中。我有这个

 /**
  * Find a user by its username.
  *
  * @param string  $username
  * @return UserInterface or null if user does not exist
  */
function findUserByUsername($username);

现在我想知道它是否解决了任何目的，或者它是否在数据库中使用这些@param和@return注释做任何事情，或者它们只是为了文档

Answer 1

@param在 phpDocumentor文档中进行了解释。它与 Symfony2 无关。

Answer 2

链接已过时。

这是一个指向当前一个好地址的链接。

https://www.phpdoc.org/docs/latest/references/phpdoc/tags/param.html

下面，无论如何解释的第一行......

@param 标签用于记录函数或方法的单个参数。

使用@param 标签可以记录函数或方法的单个参数的类型和功能。当提供时，它必须包含一个类型来指示预期的内容；另一方面，描述是可选的，但建议在复杂结构的情况下使用，例如关联数组。