Синтаксическая ошибка Doctrine/Swagger-php: [Синтаксическая ошибка] Ожидаемое PlainValue, получено ')' в позиции [закрыт ⇐ Php

[Anonymous]

Я пытаюсь использовать Swagger-php, но постоянно получаю сообщение об ошибке
Через bash:
[username@dev swagger-php]$ ./bin/swagger [path to codeigniter controller dir]/controllers -o [targetoutput path]/swagger

Установка Swagger находится в исходном каталоге поставщика в том виде, в котором она была загружена.

[WARN] Ожидается [синтаксическая ошибка] PlainValue, получил ')' в позиции 546 в Tools_Data->tool_get(...) в /usr/local/apache2/htdocs/jh-intranet/application/controllers/v1/tools_data.php в строке 27.

[ОШИБКА] действительные ресурсы не найдены

Строка 27 — /**

Строка 28 — * @SWG \Resource(
Есть синтаксическая ошибка, но похоже, что она не в этой строке.
Я проверил несколько источников информации в Интернете, но, похоже, не могу избавиться от нее. об ошибке.
Нет одинарных кавычек и совпадение открывающих/закрывающих круглых скобок.
Было бы неплохо, если бы для подобных вещей существовал анализ аннотаций Swagger/Doctrine.
Что мне следует изучить дальше?
Отрывок из документа/кода:
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"
* )
* )
* )
* )
* )
*/


Подробнее здесь: https://stackoverflow.com/questions/212 ... nvalue-got