在 "nelmio_api_doc "下未识别的选项 "sandbox, swagger"。可用的选项是 "区域"、"文档"、"模型"

Question

nelmioapi-doc-bundle等包后，安装了：nelmioapi-doc-bundle (我的composer.json粘贴在下面)，我得到了以下错误。

InvalidConfigurationException Unrecognized options "sandbox, swagger" under "nelmio_api_doc". 可用的选项是 "区域"，"文档"，"模型"。.

我想弄清楚发生了什么事，已经好几天了，请大家帮忙。

这是我的composer.json。

{
  "type": "project",
  "license": "proprietary",
  "require": {
    "php": "^7.1.3",
    "ext-ctype": "*",
    "ext-iconv": "*",
    "cocur/slugify": "^3.2",
    "dompdf/dompdf": "^0.8.3",
    "friendsofsymfony/oauth-server-bundle": "^1.6",
    "friendsofsymfony/rest-bundle": "^2.5",
    "friendsofsymfony/user-bundle": "~2.0",
    "inacho/php-credit-card-validator": "^1.0",
    "jms/serializer-bundle": "^3.3",
    "nelmio/api-doc-bundle": "^3.4",
    "sensio/framework-extra-bundle": "^5.3",
    "symfony/apache-pack": "^1.0",
    "symfony/asset": "4.2.*",
    "symfony/console": "4.2.*",
    "symfony/dotenv": "4.2.*",
    "symfony/expression-language": "4.2.*",
    "symfony/filesystem": "4.2.*",
    "symfony/finder": "4.2.*",
    "symfony/flex": "^1.1",
    "symfony/form": "4.2.*",
    "symfony/framework-bundle": "4.2.*",
    "symfony/monolog-bundle": "^3.1",
    "symfony/orm-pack": "*",
    "symfony/process": "4.2.*",
    "symfony/security-bundle": "4.2.*",
    "symfony/serializer-pack": "*",
    "symfony/swiftmailer-bundle": "^3.2",
    "symfony/translation": "4.2.*",
    "symfony/twig-bundle": "4.2.*",
    "symfony/validator": "4.2.*",
    "symfony/web-link": "4.2.*",
    "symfony/yaml": "4.2.*",
    "twig/extensions": "^1.5",
    "zircote/swagger-php": "*"
  },
  "require-dev": {
    "symfony/debug-pack": "*",
    "symfony/maker-bundle": "^1.0",
    "symfony/profiler-pack": "*",
    "symfony/test-pack": "*",
    "symfony/web-server-bundle": "4.2.*"
  },
  "config": {
    "preferred-install": {
      "*": "dist"
    },
    "sort-packages": true
  },
  "autoload": {
    "psr-4": {
      "App\\": "src/"
    }
  },
  "autoload-dev": {
    "psr-4": {
      "App\\Tests\\": "tests/"
    }
  },
  "replace": {
    "paragonie/random_compat": "2.*",
    "symfony/polyfill-ctype": "*",
    "symfony/polyfill-iconv": "*",
    "symfony/polyfill-php71": "*",
    "symfony/polyfill-php70": "*",
    "symfony/polyfill-php56": "*"
  },
  "scripts": {
    "auto-scripts": {
      "cache:clear": "symfony-cmd",
      "assets:install %PUBLIC_DIR%": "symfony-cmd"
    },
    "post-install-cmd": [
      "@auto-scripts"
    ],
    "post-update-cmd": [
      "@auto-scripts"
    ]
  },
  "conflict": {
    "symfony/symfony": "*"
  },
  "extra": {
    "symfony": {
      "allow-contrib": false,
      "require": "4.2.*"
    }
  }
}

这是我的nelmio_api_doc.yaml。

nelmio_api_doc:
  sandbox:
    enabled: true
    authentication:
      delivery: http
      type: bearer
    body_format:
      formats: [json, form] # array of enabled body formats,
      default_format: json
  swagger:
    api_base_path: /api
    swagger_version: "1.2"
    api_version: "0.1"
    info:
      title: API
      description: "REST API"

我试过：composer更新和composer安装。

Answer 1

你必须更新 nelmio/api-doc-bundle 从2.x到3.x。

您的配置似乎适合2.x版本，请务必按照以下步骤进行操作。迁移到3.x的指南.

对于一个类似的问题，我替换了 sandbox 与 documentation.

同样，按照指南，你也可以更换其他的东西。

最有可能的是，类似于下面的工作。

nelmio_api_doc:
  documentation: #<-- notice this change.
    enabled: true
    authentication:
      delivery: http
      type: bearer
    body_format:
      formats: [json, form] # array of enabled body formats,
      default_format: json

    api_base_path: /api
    swagger_version: "1.2"
    info:
      title: API
      description: "REST API"
      version: "0.1" # <-- notice this has been moved.