PHP代码嗅探器不拾取文件,类和函数文档注释


PHP Code Sniffer not Picking up File, Class and Function Doc Comments

我正在将PHPCS实现到我的构建脚本中,并且已经相对轻松地解决了所有错误和警告(以及来自SO的一点帮助:))。

然而,我不明白为什么我仍然得到一个错误,说类缺少文件,类和函数文档注释。

----------------------------------------------------------------------
 FOUND 7 ERRORS AFFECTING 7 LINES
----------------------------------------------------------------------
   2 | ERROR | Missing file doc comment
  28 | ERROR | Missing class doc comment
  45 | ERROR | Missing function doc comment
  59 | ERROR | Missing function doc comment
  73 | ERROR | Missing function doc comment
  88 | ERROR | Missing function doc comment
 102 | ERROR | Missing function doc comment
----------------------------------------------------------------------

下面是PHP类:

<?php
/**
 * EndpointHelper File Doc Comment
 * 
 * @category    EndpointHelper
 * @package     Helper
 * @author      Brian Smith <brian.smith@company.com>
 * @copyright   Copyright 2015 Company, Inc. All rights reserved.
 * @license     GNU General Public License version 2 or later; see LICENSE
 * @link        http://arctg.com
 */
/**
 * EndpointHelper Class Doc Comment
 * 
 * Endpoint Helper to retrieve application wide
 * URLs based on active webinstance.
 * 
 * @category    Class
 * @package     EndpointHelper
 * @author      Brian Smith <brian.smith@company.com>
 * @copyright   Copyright 2015 Company, Inc. All rights reserved.
 * @license     GNU General Public License version 2 or later; see LICENSE
 * @link        http://company.com
 * 
 * @since   1.0.1
 */
class EndpointHelper
{
    /**
     * Component params object
     * 
     * @var type 
     * @since   1.0.1
     */
    private static $params = false;
    /**
     * Retrieve Reservation URL based on web instance
     * 
     * @return String
     * 
     * @since   1.0.1
     */
    public static function getReservationUrl()
    {
        $instance = self::getInstanceType();
        return self::$params->get($instance . '_reservation_api_url');
    }
    /**
     * Retrieve Rental URL based on web instance
     * 
     * @return String
     * 
     * @since   1.0.1
     */
    public static function getRentalUrl()
    {
        $instance = self::getInstanceType();
        return self::$params->get($instance . '_rental_api_url');
    }
    /**
     * Retrieve cache URL based on web instance
     * 
     * @return String
     * 
     * @since   1.0.1
     */
    public static function getCacheUrl()
    {
        $instance = self::getInstanceType();
        return self::$params->get($instance . '_data_cache_api_url');
    }
    /**
     * Retrieve Systems Staging File Sync URL based on web
     * instance.
     * 
     * @return String
     * 
     * @since   1.0.1
     */
    public static function getFileSyncUrl()
    {
        $instance = self::getInstanceType();
        return self::$params->get($instance . '_file_sync');
    }
    /**
     * Private utilty class to retrieve current web instance
     * 
     * @return String
     * 
     * @since   1.0.1
     */
    private static function getInstanceType()
    {
        if (!self::$params)
        {
            self::$params = JComponentHelper::getParams('com_custom');
        }
        return self::$params->get('web_instance');
    }
}

谢谢你的帮助!

这个问题与我从Joomla使用的规则集有关。我最近又尝试了一次,Wiki的作者更新了文章,说你需要使用特定版本的PHP Docs。

清除现有安装并安装列出的版本为我解决了这个问题。