PHP swagger 使用
namespace api\demo\controller;
use OpenApi\Annotations as OA;
/**
* Class IndexController
* @package api\demo\controller
*/
class IndexController extends RestBaseController
{
/**
* @OA\Post(
* tags={"demo"},
* path="/demo/Index/index",
* description="swagger测试",
* @OA\RequestBody(
* required=true,
* description="
* 参数内容描述
* {
* ......
* }
* ",
* @OA\MediaType(
* mediaType="application/x-www-form-urlencoded",
* @OA\Schema(ref="#/components/schemas/IndexRequestBean")
* )
* ),
* @OA\Response(response="200", description="An example resource"),
* @OA\Response(response="default", description="An example resource")
* )
*/
/**
* [index swagger测试]
* @return [type] [description]
*/
public function index()
{
$this->success('success');
}
}
<?php
namespace api\demo\swagger\request\index;
use OpenApi\Annotations as OA;
/**
* @OA\Schema(@OA\Xml(name="IndexRequestBean"))
*/
class IndexRequestBean
{
/**
* @OA\Property()
* @var int
*/
public $wechat_user_id;
/**
* @OA\Property()
* @var string
*/
public $user_name;
}