如何使NelmioApiDocBundle与Symfony的FormType协同工作

Question

在FOSRestBundle工作了一段时间之后，我觉得我好像错过了什么。在我看来，FOSRestBundle和Symfony的FormType -有点相似。两者都是您的“数据代理”。每个人都有自己的东西，但最终他们是相似的。

现在，每个人都会迁移到单页应用程序。这意味着每个人都在尝试使用他们现有的FormType并使用FOSRestBundle构建API。但他们不可能轻易地记录下来。NelmioApiDocBundle不适用于FormType。还是我漏掉了什么？

因此，我的问题是:是否可以“告诉”NelmioApiDocBundle使用FormType作为文档(描述所需的数据)？

看起来像--有一个解决这个问题的workaround，但是不工作。

控制器注释：

@ApiDoc(
    resource=true,
    description="Register a new User",
    views = {"v1"},
    input="register_form"
)

FormType：

public function configureOptions(OptionsResolver $resolver)
{
    $resolver->setDefaults(array(
        'data_class' => User::class,
        'csrf_protection'   => false,
        'allow_extra_fields'   => true,
    ));
}

public function getBlockPrefix()
{
    return 'register_form';
}

public function getName()
{
    return 'register_form';
}

service.yml：

register_form:
    class: AppBundle\Form\API\UserRegisterType
    tags:
        - { name: form.type, alias: register_form }

请指教，谢谢！

Answer 1

使用input="register_form"代替input=“AppBundle\Form\API\UserRegisterType”