Question

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

通过bash： [username @ dev swagger-php] $ ./bin/swagger [codeigniter controller dir的路径] / controllers -o [targetoutput path] / swagger

Swagger设置位于原始供应商目录中，因为它已下载

[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 \资源（

存在语法错误，但看起来不在该行。我已经在线检查了多个信息来源，但似乎无法摆脱错误。没有单引号，并且打开/关闭括号匹配。如果有这种东西的Swagger / Doctrine注释lint会很好。

接下来我应该探索什么？

Doc / Code摘录：

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条上看到一个)，这个教义很惊讶。

如果你发现了一个让我知道的信息，我还想提供更多描述性的错误信息。

Doctrine / Swagger-php语法错误：[语法错误]预期的PlainValue，得到'）'的位置

1 个答案: