php - WordPress中“at”符号的目的是什么？

Question

我已经在 WordPress 上开发了几年了，我一直@在主题和插件评论中看到“at”（）标志。

它是干什么用的？它在 WordPress 中是否有特殊用途？还是只是一般的编程文档？到目前为止，我还没有找到任何关于它的信息。

我在代码中看到的示例：

@see woocommerce_output_product_data_tabs()
@uses load_theme_textdomain() For translation/localization support.
@since Twenty Thirteen 1.0
@return void
@param string $title Default title text for current view.

如果某处有关于这是什么以及应该如何使用它的文档，我很想找到它，因为这个问题一直困扰着我一段时间。

Answer 1

它们是PHPDoc 的标签，它是 Javadoc 的 PHP 等价物。这些注释块稍后可以通过phpDocumentor之类的工具进行解析，以生成有用的文档。

Answer 2

它使错误消息静音（在插件和主题中阻止它们显示给用户）。有关更多信息，请参阅此 StackOverflow 线程：https ://stackoverflow.com/a/1032169/1293256