phpdoc不断告诉我我的页面级docblock不存在

Question

PHPDocumenter一直告诉我，我的页面级文档块不存在于我的文件中，我在网上阅读了几页文档以使其工作但仍然不起作用，任何人都知道什么是错的？

<?php
namespace Activis\Catalog\Model;

/**
* This file represents the factory for the domain object Product for the Activis catalog.
* 
* For now, this factory is simple and abstract but will slowly change into a non-static set of factory functions
* The domain model for this object is \Activis\Catalog\Model\Product
*
* @category Domain model factory
* @package  Activis.Catalog.Model
* @author   Mathieu Dumoulin
* @license  LGPL v3
* @link     http://activis.ca/
* @todo     Change the methods in the factory to not be abstract and require an instance of this class
*/
/**
* Declares the catalog's product's domain model factory
* 
* @abstract
* @static
*/
abstract class ProductFactory
{
}

Answer 1

在命名空间声明

之前，页面级文档块应放在文件的顶部