Question

我正在将NelmioApiDocBundle与PHP框架 Symfony3 一起用于 REST API 。我想在/ api / doc页面中显示我的参数说明。如果不手动添加参数，这可能吗？我想从输入/输出类中导入它。

这就是我的文档的外观：

这是我的 @ApiDoc 控制器操作（/ api / user / login）生成文档：

 * @ApiDoc(
 *     section = "user",
 *     resource = true,
 *     description = "Checks the user credentials and returns an authentication & refresh token if they are correct",
 *     input = { "class" = "AppBundle\Libraries\Core\User\LoginRequest", "name" = "" },
 *     output = { "class" = "AppBundle\Libraries\Core\User\LoginResponse", "name" = "" },
 *      statusCodes = {
 *          200 = "Returned when successful",
 *          400 = "Returned when request syntax is incorrect",
 *          404 = "Returned when the page is not found",
 *          429 = "Returned when the client sent too many requests during a time period",
 *          500 = "Returned when an internal server error occured",
 *          501 = "Returned when an unavailable request method is user (GET, POST, DELETE, PUT, ...)",
 *          503 = "Returned when the service is unavailable at the moment eg. due to maintenance or overload"
 *      },
 *
 * )

AppBundle \ Libraries \ Core \ User \ LoginRequest class ：

class LoginRequest implements JsonSerializable
{
    /**
     * The username.
     *
     * @var string
     *
     * @Assert\NotBlank()
     * @Assert\Type("string")
     */
    public $username;

    /**
     * The password.
     *
     * @var string
     *
     * @Assert\NotBlank()
     * @Assert\Type("string")
     */
    public $password;

    /**
     * Defines whether or not to save the refresh token as cooke.
     *
     * @var bool
     *
     * @Assert\NotBlank()
     * @Assert\Type("bool")
     */
    public $rememberPassword;

    public function getUsername()
    {
        return $this->username;
    }

    public function setUsername($username)
    {
        $this->username = $username;
    }

    public function getPassword()
    {
        return $this->password;
    }

    public function setPassword($password)
    {
        $this->password = $password;
    }

    public function getRememberPassword()
    {
        return $this->rememberPassword;
    }

    public function setRememberPassword($rememberPassword)
    {
        $this->rememberPassword = $rememberPassword;
    }

    public function jsonSerialize()
    {
        return [
                'username' => $this->username,
                'password' => $this->password,
                'rememberPassword' => $this->rememberPassword
        ];
    }
}

我想使用这个类的描述，例如。用户名：＆＃34;用户名。＆＃34;，用于密码：＆＃34;密码。＆＃34;并且对于rememberPassword：＆＃34;定义是否将刷新令牌保存为cooke。＆＃34;。

感谢您的帮助。

问候奥兰多

Answer 1

NelmioApiDoc仅在少数地方为以后生成的视图提取数据。但是您可以做的一件事就是将您的描述添加到实体/模型类的表单类型中。

public function buildForm(FormBuilderInterface $builder, array $options)
{
    $builder->add('rememberPassword', CheckboxType::class, array(
        'label' => 'input.remember.password',
        // description will be passed to table in ApiDoc view
        'description' => 'Defines whether or not to save the refresh token as cookie',
    ));
}

我知道您想知道是否有办法自动将更多信息添加到文档中，但是只有少数几种。但是，如果您想添加其他信息，则可以通过注释来完成，例如下面的示例。

/**
 * Lorem ipsum dolor sit amet
 *
 * #### Example of expected response ####
 *     [
 *         {
 *             "username": "Lorem ipsum dolor sit amet",
 *             "password": "Lorem ipsum dolor sit amet",
 *             "rememberPassword": {
 *                 "1": "Lorem ipsum dolor sit amet",
 *                 "2": "Lorem ipsum dolor sit amet",
 *                 "3": "Lorem ipsum dolor sit amet"
 *             },
 *         },
 *         ...
 *     ]
 *
 * @ApiDoc(
 *     section = "user",
 *     resource = true,
 *     description = "Checks the user credentials and returns an authentication & refresh token if they are correct",
 *     input = { "class" = "AppBundle\Libraries\Core\User\LoginRequest", "name" = "" },
 *     output = { "class" = "AppBundle\Libraries\Core\User\LoginResponse", "name" = "" },
 *      statusCodes = {
 *          200 = "Returned when successful",
 *          400 = "Returned when request syntax is incorrect",
 *          404 = "Returned when the page is not found",
 *          429 = "Returned when the client sent too many requests during a time period",
 *          500 = "Returned when an internal server error occured",
 *          501 = "Returned when an unavailable request method is user (GET, POST, DELETE, PUT, ...)",
 *          503 = "Returned when the service is unavailable at the moment eg. due to maintenance or overload"
 *      },
 *
 * )
 *
 */
public function getLoginRequestAction()
{
// your code
}

Symfony - NelmioApiDocBundle：显示从类导入的参数说明

1 个答案: