根据代码标准，@file是一个Doc-Block注解（针对每个文件），是对该文件用途的描述。
例如，想象一下你的模型文件Users.php及其所有方法，你可以在文件注解中输入如下内容：

/**
 @file
   This file will store all model methods to recover/update/delete Users.php
 ....
*/

@filesource，afaik，类似于@example标记，您可以查看pear文档here

@file不是recognized tag。
具有讽刺意味的是，很难找到和浏览关于这个主题的文档。
但是https://pear.php.net/package/PhpDocumentor/docs/latest/phpDocumentor/tutorial_tags.pkg.html建议文件的DocBlock应该是文件中的第一个DocBlock：
举个例子：

1. /**
2.  * tags demonstration
3.  * @author this tag is parsed, but this @version tag is ignored
4.  * @version 1.0 this version tag is parsed
5.  */

......并且没有必要专门对其进行注解。