问题标签 [swagger-php]

For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.

0 投票
1 回答
3298 浏览

swagger-php - 获取请求参数中的@AO\JsonContent

在使用 OpenApi 规范的 swagger 文档中,您可以使用 application/json 将参数中的模式包装到内容中:

发送这样的对象filter={"type":"t-shirt","color":"blue"}。如何在 swagger-php 中做到这一点?

0 投票
1 回答
1559 浏览

php - 带着laravel护照大摇大摆不工作

我想将 swagger 与 laravel 护照联系起来。我的招摇配置文件设置

在我使用注释的 laravel 控制器中

它没有发送它应该发送的标题。我做错了什么还是缺少了什么?我需要这个解决方案,在 Laravel 中使用 OA 3

0 投票
0 回答
390 浏览

openapi - Swagger-PHP/Doctrine 注释、OpenAPI 3 和 JSON:API 格式

谁能告诉我 OpenApi 3 是否支持 JSON:API 格式?我一直在环顾四周,似乎无法确定它是否受支持。目前我正在使用 CakePHP 3.6 和 Swagger-php/doctrine 注释来创建 OA3 文档。

提前致谢。

0 投票
1 回答
133 浏览

laravel - Infyom Swagger:路径参数问题

我已经设置了 Infyom laravel 并成功创建了 API。

我还设置了“appointer/swaggervel”并生成了 swagger URL。

问题在于现在指向的 API URL,如下图所示。

我必须调用完整的 URL,例如:http://localhost:8080/project_folder/public/api/glasses

当前它指向:http://localhost:8080/api/glasses

在此处输入图像描述

0 投票
0 回答
728 浏览

laravel - swagger ui授权按钮在laravel项目中不可见

我正在开发一个 Laravel 7 项目,我使用了包dagbouj-hatem/swaggervel

在此处输入图像描述

我有这个招摇界面:所以我正在寻找一种解决方案来显示招摇授权按钮并使用不记名令牌实现基本身份验证。

先感谢您。

0 投票
1 回答
485 浏览

openapi - OpenApi 3.0 排除内部 api 定义

我们需要使用 Php 注释生成 API 的多个定义。

在生成 api spec(json/yml) 时,需要排除我们不应该暴露给外界的内部 api。

我正在使用 swagger 来生成 api 文档。

OpenApi 3.0 和 swagger 有什么可能吗?我们可以将 api 命名为内部和外部并根据此标签排除吗?

0 投票
0 回答
1826 浏览

symfony - 用户注意事项:未找到必需的@OA\PathItem():symfony 4

在此处输入图像描述我正在使用 symfony 4.4 / nelmio api doc bundle 4.0 / zircote swagger-php 3.0。当我尝试第一个示例时,出现此错误:用户注意:未找到必需的@OA\PathItem()

https://github.com/zircote/swagger-php/blob/3.0.0/Examples/example-object/example-object.php https://github.com/zircote/swagger-php/blob/3.0.0 /Examples/using-refs/ProductController.php

0 投票
1 回答
1532 浏览

swagger-php - 是否需要 nelmio_api_doc.yaml 中的架构部分?

我一直在使用 Swagger-PHP 设置 Nelmio API Doc Bundle。一切都按预期工作,我似乎无法弄清楚/理解的唯一一件事是模式。

在用户控制器中,我有以下注释:

在我的Entity/User课堂上,我将架构定义如下:

在用户控制器中,我也use App\Entity\User;定义了。

在我看来,这足以找到架构,但它不起作用,否则我不会在这里发布:)

我能够使其工作的唯一方法是运行vendor/bin/openapi --format yaml src模式输出并将其复制/粘贴到nelmio_api_doc.yaml文件中。这是我复制/粘贴的架构部分:

所以我的问题是,这是解决它的方法还是应该自动创建架构部分?

感谢您的任何见解。

0 投票
1 回答
1689 浏览

symfony4 - 包含对象的对象的 Swagger 注释问题

我正在为 Symfony 4 项目中的 rest api 编写端到端测试。

我使用 php 7.4、Swagger 注释、nelmio/api-doc-bundle 3.6.1、nelmio/cors-bundle 1.5.6

这是我的方法的控制器代码。

ProfessionDto 是定义交换数据的对象。它包含更多对象作为属性,因为我希望在返回的数据中有一些结构,而不仅仅是一堆键值对。

在 ProfessionDto 类中,我定义了与其他对象相关的属性,例如:

如果我用邮递员或通过我的测试调用 api 并将我的数据作为 json 传递,例如

我收到错误消息: TypeError: Typed property App\Api\Dto\ProfessionDto::$professionArea must be an instance of App\Api\Dto\ProfessionAreaDto or null, array used

我做错了什么?我期望太多了吗?对象中的对象是不可能的吗?

0 投票
2 回答
3818 浏览

laravel - 如何在 swagger-php 数组中上传文件

我想在 json requestBody 的 swagger-php 中上传一个文件 如何在 swagger anonations 的帮助下上传

尝试了很多时间,但运气不佳,如何在 application/json 数组中发送和归档,如果有任何关于此的信息,您能否提供帮助,那么我将解决我的问题,我对此一无所知

当此代码在终端中生成时也没有任何错误并且未显示在 swagger ui 的请求正文中

我想要这种类型的 swagger-ui 正文,以便用户可以填写属性并以 base64 格式添加简历