PHP swagger 使用

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;
    
}