1
こんにちは私はswagger-php仕様を使用してダミーのAPIを作成しています。私はgithubからswagger-phpパッケージをダウンロードしました。また、私はPHPの注釈を使用して有効なjsonファイルを作成しました。今私はコントローラのメソッドでswagger json操作をリンクすることに固執しています。Swaggerの操作swagger-phpのコントローラーメソッドでリンクされました
私のコントローラファイルは次のとおりです。
/**
* @SWG\Get(
* path="/user",
* operationId = "findUser",
* description = "finds user in the system",
* tags={"user"},
* @SWG\Response(
* response=200,
* description="user response",
* @SWG\Schema(
* type="array",
* @SWG\Items(ref="#/definitions/User")
* )
* ),
* @SWG\Response(
* response="default",
* description="unexpected error",
* @SWG\Schema(
* ref="#/definitions/errorModel"
* )
* )
*)
*/
public function findUser()
{
}
/**
* @SWG\Get(
* path="/user/{id}",
* description="Returns a user based on a single ID",
* tags={"user"},
* operationId="findUserById",
* @SWG\Parameter(
* description="ID of pet to fetch",
* format="int64",
* in="path",
* name="id",
* required=true,
* type="integer"
* ),
* @SWG\Response(
* response=200,
* description="user response",
* @SWG\Schema(ref="#/definitions/User")
* ),
* @SWG\Response(
* response="default",
* description="unexpected error",
* @SWG\Schema(ref="#/definitions/errorModel")
* )
*)
*/
public function findUserById()
{
}
/**
* @SWG\Post(
* path="/user",
* operationId="addUser",
* tags={"user"},
* description="Add a new User ",
* @SWG\Parameter(
* name="id",
* in="formData",
* description="Unique id",
* required=true,
* type = "string"
* ),
* @SWG\Parameter(
* name="firstName",
* in="formData",
* description="first name",
* required=true,
* type = "string"
* ),
* @SWG\Parameter(
* name="lastName",
* in="formData",
* description="last name",
* required=true,
* type = "string"
* ),
* @SWG\Parameter(
* name="email",
* in="formData",
* description="email",
* required=true,
* type = "string"
* ),
* @SWG\Parameter(
* name="password",
* in="formData",
* description="password",
* required=true,
* type = "string",
* format = "password"
* ),
* @SWG\Response(
* response=200,
* description="user response",
* @SWG\Schema(ref="#/definitions/User")
* ),
* @SWG\Response(
* response="default",
* description="unexpected error",
* @SWG\Schema(ref="#/definitions/errorModel")
* )
*)
*/
public function addUser()
{
}
/**
* @SWG\Delete(
* path="/user/{id}",
* tags={"user"},
* description="deletes a single user based on the ID supplied",
* operationId="deleteUser",
* @SWG\Parameter(
* description="ID of user to delete",
* format="int64",
* in="path",
* name="id",
* required=true,
* type="integer"
* ),
* @SWG\Response(
* response=200,
* description="user deleted"
* ),
* @SWG\Response(
* response="default",
* description="unexpected error",
* @SWG\Schema(ref="#/definitions/errorModel")
* )
*)
*/
public function deleteUser()
{
}