freefri/cake-rest-api

CakePHP Rest API

安装数: 1,889

依赖项: 11

建议者: 0

安全: 0

星标: 0

关注者: 2

分支: 0

开放问题: 0

类型:cakephp-plugin

0.5.18 2024-08-07 07:55 UTC

README

CakePHP 4.x 的 Rest API

配置

  • 某些配置可以使用环境变量完成(在项目中搜索 env( 以查找用法)。

  • 当与插件一起工作时,某些配置可以从主配置(config/app.php 文件)中完成)。

    • 使用键 Swagger 是可选的,但可以帮助自定义某些目录(搜索 read('Swagger 以获取详细信息)。
    • 从主 App 配置的兄弟配置使用插件的命名空间,后跟单词 Plugin

例如,如果您的插件命名空间为 Example,请创建以下配置文件

return [
    'debug' => false,
    'App' => [ ... ],
    'Swagger' => [ ... ]
    'ExamplePlugin' => [
        'tablePrefix' => 'example_',
        'routePath' => '/api/v1',
    ],
];

以下配置可以使用

  • tablePrefix:(可选)如果您想为数据库表添加前缀,例如 myplugin_users。可以为空字符串。
  • routePath: 为插件中所有路由的路径定义

Swagger

为了使包含 openapi 描述的 swagger UI 可用,必须创建一个新的控制器 SwaggerJsonController,并定义相应的路由。可以在该控制器中重写 getContent 方法,以添加对主规范信息(标题、描述、版本等)的自定义。Swagger 生成配置可以如上所述的配置部分进行配置。

在任何控制器中测试函数 $this->skipNextRequestInSwagger() 可以用来不添加下一个请求。

许可

本站源代码受 MIT 许可 许可,可在 LICENSE 文件中找到。