理论/ Swagger-php语法错误：[语法错误]预期的PlainValue，got‘)在位置

Question

我正在尝试使用Swagger-php，但是我一直收到错误。

通过bash: username@dev swagger-php$ ./bin/swagger路径到代码点火器控制器dir/控制器-o目标输出路径/swagger

Swagger安装程序在下载时位于原始供应商dir中。

[WARN] [Syntax Error] Expected PlainValue, got ')' at position 546 in Tools_Data->tool_get(...) in /usr/local/apache2/htdocs/jh-intranet/application/controllers/v1/tools_data.php on line 27.
[ERROR] no valid resources found

第27行是/**

第28行是* @SWG\Resource(

有一个语法错误，但看起来不是在那一行。我已经检查了多个来源的信息在线，但似乎无法消除错误。没有单引号，开/闭括号匹配。如果这类事情有一个Swagger/Doctrine注解，那就太好了。

接下来我应该探索什么？

Doc /代码摘录：

use Swagger\Annotations as SWG;
/**
 * @package
 * @category
 * @subpackage
 *
 * @SWG\Model(id="Tool",required="id")
 */
class Tools_Data extends REST_Controller
{

    function __construct()
    {
        parent::__construct();
    }

/**
 * @SWG\Resource(
 *      resourcePath="/v1/tool_data/tool",
 *      @SWG\Api(
 *          path="/v1/tool_data/tool/toolId",
 *          @SWG\Operation(
 *              method="GET", 
 *              summary="Find tool by ID or other filters", 
 *              notes="Returns tool listing",
 *              type="Tools", 
 *              nickname="getTools", 
 *              @SWG\Parameters(
 *                  @SWG\Parameter(
 *                      name="id",
 *                      paramType="path",
 *                      format="int",
 *                      required="false",
 *                      description="Tool ID",
 *                      notes="Can also be a JSON parameter",
 *                  )
 *                  @SWG\Parameter(
 *                      name="clean",
 *                      paramType="query",
 *                      format="bool",
 *                      required="false",
 *                      description="Returns a reduced field listing",
 *                      notes="Returns date_added,title,id,tool_tab_id,resource_id,last_modified  omits published",
 *                  )
 *              )
 *          )
 *      )
 * )
 */

编辑:工作/更正注释：

/**
 * @SWG\Resource(
 *      resourcePath="/v1/tool_data/tool",
 *      @SWG\Api(
 *          path="/v1/tool_data/tool/toolId",
 *          @SWG\Operation(
 *              method="GET", 
 *              summary="Find tool by ID or other filters", 
 *              notes="Returns tool listing",
 *              type="Tools", 
 *              nickname="getTools",
 *              @SWG\Parameters(
 *                  @SWG\Parameter(
 *                      name="id",
 *                      paramType="path",
 *                      format="int",
 *                      required=false,
 *                      description="Tool ID"
 *                  ),
 *                  @SWG\Parameter(
 *                      name="clean",
 *                      paramType="query",
 *                      format="bool",
 *                      required=false,
 *                      description="Returns a reduced field listing"
 *                  )
 *              )
 *          )
 *      )
 * )
 */

Answer 1

在omits published"后面有一个逗号，所以在第27行开始的注释的546字符上看到一个)是很惊讶的。

如果你找到一个链接，让我知道，我也希望有更多的描述性错误信息。