构建 API 的正确方法

Question

我有一个小型 API，可根据请求为移动应用提供一些 JSON。这是我第一次开发这样的东西，但它运行良好。

我现在想验证和改进 API 的结构，因为我在没有太多经验的情况下拼凑起来。我目前的实现如下：

• 在我的公共网络目录中，我有一个名为“API”的文件夹
• 在这个文件夹中，我有两个子目录，“LiveScores”和“YesterdaysScores”。
• 每个文件夹都有一个 index.php 文件。此文件查询我的数据库并以 JSON 格式返回结果。
• 我的应用程序访问它想要的数据的特定路径。（例如 www.blabla.com/api/LiveScores）

我的第一个问题是有很多冗余。例如，两个 index.php 文件几乎相同，只是 SQL WHERE 子句不同。这似乎不是最理想的。

除此之外，我希望得到有关“正确”方法的反馈。

Answer 1

您可能需要考虑使用 API 框架。一些流行的 PHP（似乎正在积极维护/改进）包括：

• Slim
• Tonic
• PhlyRestfully（用于 Zend Framework 2）
• FRAPI
• epiphany

Answer 2

您还可以考虑使用 MongoDB (http://www.mongodb.org/)，并直接在其之上构建您的 API 层。如果您想使用 Web 框架，有很多选择。有大量原生驱动供您选择（http://docs.mongodb.org/ecosystem/drivers/）。

无论如何，应该可以快速轻松地构建和管理您的特定 API，因为您可以存储和运行来自 MongoDB 的 JSON 文档的复杂查询。它也是一个 NoSQL 数据库，并且比您现在使用的 RDBM 在扩展方面要好得多；由于存在大量移动设备，您需要一种方法以低延迟横向扩展请求的高并发性。

但是，您需要花时间学习文档建模方法和 MongoDB。有一些免费的在线培训课程可以学习基础知识https://education.10gen.com/。