Ошибка SWAGGER-PHP при создании .json. Я не могу загрузить значения из своей модели.

Привет, ребята, я попытался устранить эту ошибку, которая сохраняется, когда я генерирую swagger.json, ошибка говорит:

[ПРЕДУПРЕЖДЕНИЕ] [Синтаксическая ошибка] Ожидаемое значение, получил '@' в \App\Http\Controllers... и в моем коде OHH iM WORKING WITH LUMEN.

/**
 * @SWG\Put(
 *   path="/v1/resource/{id1}/rsc/{id2}",
 *   summary="Update ...",
 *   operationId="update",
 *   tags={"Update"},  
 *
 *
 *   @SWG\Response(response=200, description="Json [client] "),
 *   @SWG\Response(response=404, description="Recurso no encontrado"),
 *   @SWG\Response(response=500, description="[error] Error interno del servidor"),
 *   @SWG\Parameter(
 *     name="id1",
 *     in="path",
 *     description="Id1.",
 *     required=true,
 *     type="integer"
 *   ),
 *   @SWG\Parameter(
 *     name="id2",
 *     in="path",
 *     description="Id2",
 *     required=true,
 *     type="integer"
 *   ),
 *   @SWG\Parameter(
 *     name="JSON update body",
 *     in="body",
 *     description="Request.",
 *     required=true,
 *     @SWG\Schema(type="array",@Model(type=vendor\LibModel\DAO\src\Model\Hospital))
 *   )
 *  )
 */
 public function update($id1,$id2, Request $request){...}

Когда я проверяю, json не генерирует определения -> «определения»: {}. Моя модель определила это следующим образом, я не знаю, проблема в том, что моя модель находится в другом пространстве имен, потому что она определена как поставщик или что-то декларативное, чего мне не хватает:

/**
 * Class Hospital
 *
 *
 * @SWG\Definition(
 *   definition="Hospital"
 * )
 *
 */
class Hospital extends Model
{

    /**
     * @SWG\Property(format="string")
     * @var string
     */
    protected $name;

    /**
     * @SWG\Property(format="string")
     * @var string
     */
    protected $email;

.. и на мой взгляд swagger m появляется ОШИБКА ... я думаю, это потому, что он не загружает значения модели, спасибо, кто может мне помочь


person Jose Enrique Lopez    schedule 14.03.2018    source источник


Ответы (1)


Анализатор доктрины жалуется на @Model, который не является частью swagger-php.

Обозначение swagger-php:

 * @SWG\Parameter(
 *     name="JSON update body",
 *     in="body",
 *     description="Request.",
 *     required=true,
 *     @SWG\Schema(
 *         type="array",
 *         @SWG\Items(ref="#/definitions/Hospital")
 *     )
 * )

Я не хочу использовать NelmioApiDocBundle (который использует эту аннотацию @Model), проверьте их руководства, чтобы узнать, как чтобы настроить это.

person Bob Fanger    schedule 12.04.2018