fusio

关于

Fusio 是一个开源 API 管理平台，有助于创建创新的 API 解决方案。

用例

• API-产品
  Fusio 帮助您创建出色的 API 产品，除了构建 API 之外，它还提供开发人员门户，开发人员可以在其中注册以及通过 API 获利的方式
• API网关
  Fusio 可以用作内部 API 和微服务的网关。它处理所有常见功能，如授权、速率限制和模式验证
• SPA后端
  Fusio 可以用作后端，使用流行的 Javascript 框架（例如 Angular、React 或 Vue）构建 SPA。它提供了一个强大的代码生成器，可以自动为您的API生成SDK
• 低代码平台
  Fusio 允许您无需编码知识即可构建 API 端点。即它提供了一个实体生成器，您可以使用它轻松创建完整的 CRUD API。
• API框架
  对于更复杂的用例，您还可以使用 Fusio 作为框架从头开始构建完整的 API。这意味着您可以构建自定义操作，在其中可以使用广泛的 PHP 生态系统来解决您的任务。

特征

Fusio 可帮助您构建提供开箱即用的企业功能的 API，以便您可以专注于您的业务案例。请查看我们的文档网站以获取更多信息。以下功能列表为您提供了初步概述：

• OpenAPI 生成
  Fusio 自动为定义的路由生成 OpenAPI 规范
• SDK生成
  Fusio 可以根据定义的架构自动为您的 API 生成客户端 SDK
• 网络钩子支持
  Fusio 包含一个 webhook 系统，有助于为您的 API 构建发布/订阅
• 速率限制
  Fusio 提供了一种根据用户或应用程序对请求进行速率限制的方法
• 授权
  Fusio使用OAuth2进行API授权
• 货币化
  Fusio 提供简单的支付系统来针对特定路线收费
• 验证
  Fusio 使用 TypeSchema 自动验证传入的请求数据
• 分析
  Fusio 监控所有 API 活动并将其显示在仪表板上
• 用户管理
  Fusio 提供了一个开发者应用程序，新用户可以通过 GitHub、Google、Facebook 或通过普通电子邮件注册登录或注册新帐户

应用程序

Fusio 提供了许多有助于使用 API 的应用程序。大多数应用程序都是简单的 JS 应用程序，它们与 Fusio 的内部 API 配合使用。您可以在我们的市场上查看所有可用应用程序的列表。您可以通过 CLI 命令（即php bin/fusio marketplace:install fusio或通过后端应用程序安装此类应用程序。

所有应用程序都安装到apps/文件夹中。您需要通过定义APP_APPS_URL变量来告诉 Fusio .env文件中的 apps 文件夹的公共 url。根据您的设置，这可以是自定义子域，例如https://apps.acme.com ，也可以只是子文件夹https://acme.com/apps 。

后端

后端应用程序是配置和管理 API 的主要应用程序。安装程序会自动安装此应用程序。该应用程序位于/apps/fusio/ 。

VS代码

Fusio 提供了 VSCode 扩展，可用于简化动作开发。这意味着您可以直接在 VSCode 编辑器中开发每个操作。

软件开发工具包

为了使用 Fusio 构建和集成应用程序，我们提供了多个 SDK，您可以使用它们来处理 Fusio 实例，也可以简单地手动与 REST API 对话。

语言	GitHub	包裹	例子
C#	GitHub	努格特	例子
去	GitHub		例子
爪哇	GitHub	梅文	例子
JavaScript	GitHub	国家公共管理
PHP	GitHub	包装学家	例子
Python	GitHub	皮伊	例子

框架

框架	GitHub	包裹	例子
角	GitHub	国家公共管理	例子

休息API

领域	文档	规格
后端	重新文档	开放API
消费者	重新文档	开放API
系统	重新文档	开放API

生态系统

Fusio 是一个开源项目，您可以根据 Apache 2.0 许可证条款免费将其用于私人和商业项目。除了我们的核心产品之外，我们还提供附加服务来增强 Fusio 的功能。

• SDK生成器
  SDKgen 是一个功能强大的代码生成器，可以自动为您的 REST API 构建客户端 SDK。
• API基因
  根据您的数据模型生成完全可用且可自定义的 API。
• APImon
  APImon 提供直观的服务来监控和分析 API 端点。
• 类型模式
  一种 JSON 格式，以语言中立的格式描述数据模型。
• 类型API
  用于描述用于类型安全代码生成的 REST API 的 OpenAPI 替代方案。
• 类型集线器
  用于设计和构建 API 模型和客户端 SDK 的协作平台。
• PSX
  一个创新的 PHP 框架，致力于构建完全类型化的 REST API。

安装

可以通过 Composer 或手动文件下载来安装 Fusio。

作曲家

 composer create-project fusio/fusio

下载

https://github.com/apioo/fusio/releases

配置

您可以按照以下步骤手动安装 Fusio，也可以使用基于浏览器的安装程序public/install.php 。请注意，出于安全原因，强烈建议在安装后删除安装程序脚本。

• 调整配置文件
  打开Fusio目录中的.env文件，并将APP_URL更改为指向公共文件夹的域。还将数据库凭据插入到APP_CONNECTION键中。可选将APP_APPS_URL调整为应用程序文件夹的公共 url（如果您想使用应用程序）。
• 执行安装命令
  安装脚本将 Fusio 数据库架构插入到提供的数据库中。可以使用以下命令php bin/fusio migrate来执行。
• 创建管理员用户
  安装完成后，您必须创建一个新的管理员帐户。因此，您可以使用以下命令php bin/fusio adduser 。选择帐户类型“管理员”。
• 安装后端应用程序
  要通过管理面板管理您的 API，您需要安装后端应用程序。可以使用以下命令安装该应用程序php bin/fusio marketplace:install fusio

您可以通过使用浏览器访问APP_URL来验证安装。您应该看到安装成功的 API 响应。

如果您想在特定数据库上安装 Fusio，则需要调整APP_CONNECTION参数。您可以使用以下连接字符串：

• MySQL： pdo-mysql://root:test1234@localhost/fusio
• PostgreSQL: pdo-pgsql://postgres:postgres@localhost/fusio
• SQLite： pdo-sqlite:///fusio.sqlite

一般来说，可以在我们的数据库抽象层支持的所有数据库上安装 Fusio，但我们的内部测试用例仅涵盖 MySQL、PostgreSQL 和 SQLite，因此不能保证一切正常。

码头工人

可以通过 docker 设置 Fusio。这样做的优点是您无需配置即可自动获得完整运行的 Fusio 系统。这对于测试和评估尤其有用。要设置容器，您必须签出存储库并运行以下命令：

 docker-compose up -d

这将使用预定义的后端帐户构建 Fusio 系统。凭证取自docker-compose.yml中的环境变量FUSIO_BACKEND_USER 、 FUSIO_BACKEND_EMAIL和FUSIO_BACKEND_PW 。如果您计划在互联网上运行容器，则必须更改这些凭据。

域名

默认情况下，完整的 Fusio 项目可以托管在单个域上。在此设置中，您的 API 在根目录提供服务，开发人员门户和后端应用程序直接从 /apps 文件夹提供服务。此设置很容易使用，因为它不需要配置。如果您想在生产环境中运行 Fusio，我们建议创建以下子域结构：

• api.acme.com
  仅包含为您的 API 提供服务的 Fusio，在这种情况下，您可以从 public/ 文件夹中删除 apps/ 文件夹
• 开发者.acme.com
  包含外部开发人员可以注册的开发人员门户应用程序
• fusio.acme.com
  可选的后端应用程序，您可以在其中管理 Fusio 实例。您也可以将其托管在一个完全独立的内部域上，后端应用程序只需要访问 Fusio API。

当然这只是一个建议，您可以自由选择您喜欢的域名。

文档

请查看我们的官方文档网站，我们捆绑了所有文档资源：https://docs.fusio-project.org/

支持

晋升

如果您是博主或杂志，如果您愿意报道​​ Fusio，我们将非常高兴。请查看我们的“关于”页面的“媒体”部分，下载官方图标集。如果您有任何疑问，请直接给我们留言，以便我们帮助您创建精彩的内容。

咨询

如果您是公司或自由职业者，并且想要获取如何使用 Fusio 的详细信息，您可以联系我们进行咨询。在研讨会中，我们尝试找到如何使用/集成 Fusio 的最佳方法，我们还尝试解释功能并回答您的问题。

捐款

如果该项目可以帮助您产生收入，或者一般来说如果您想支持该项目，请查看我们存储库中的捐赠选项。

伙伴

以下列表显示了Fusio项目的所有合作伙伴。我们要感谢每一位支持我们实现将 API 开发提升到新水平的愿景的合作伙伴。如果您有兴趣在这里列出，请随时赞助我们的项目。