PHP 中的 API 基础

引言

《API Foundations in PHP》一书（作者：John Folds，2017 年出版，共 238 页）是一本关于使用 PHP 语言创建现代 Web API 的实用指南。在微服务和移动应用时代，能够熟练设计和实现 API 已成为后端开发人员的关键技能之一。这本书理论内容不多——它侧重于具体示例和逐步构建一个完整的 RESTful API。

书籍内容

作者循序渐进地引导读者完成 API 开发的各个阶段：从环境配置到在生产服务器上部署。主要关注点包括：

• REST 原则和端点的正确设计；
• 在不使用框架的情况下，使用纯 PHP 组织路由；
• 处理 HTTP 方法（GET, POST, PUT, DELETE）；
• 身份验证和授权（令牌, JWT, OAuth 2.0）；
• 错误处理和验证数据；
• 使用 Postman 和 PHPUnit 测试 API；
• API 文档编写（Swagger/OpenAPI）。

每一章都包含可直接应用于项目的现成代码。在书的结尾，读者将获得一个完全可用的、用于管理任务（TODO 应用）并带有 MySQL 数据库的 API。

适合读者

本书面向初级和中级 PHP 开发人员，他们已熟悉语言基础（变量、函数、类、PDO），并希望学习如何创建 API。对于那些从过程式编程转向面向对象编程，并想了解现代后端服务是如何构建的人来说，本书也很有用。建议 Web 开发新手先学习基础的 PHP 和 SQL。

读者将学到什么

• 如何为 API 设计数据库结构；
• 如何在不使用框架的情况下实现 RESTful 路由；
• 如何处理 JSON 请求并生成正确的 HTTP 响应；
• 如何实现基于令牌的身份验证（JWT）；
• 如何保护 API 免受常见漏洞（SQL 注入、XSS、CSRF）的攻击；
• 如何为 API 编写单元测试；
• 如何为其他开发人员编写 API 文档。

本书优势

实践导向。 与许多学术出版物不同，Folds 提供了现成的解决方案，可以针对具体任务进行调整。代码编写整洁，带有注释并遵循 PSR 标准。

不依赖框架。 作者仅使用原生 PHP，这有助于更深入地理解 API 的工作机制。阅读本书后，可以轻松过渡到 Laravel、Symfony 或 Slim。

循序渐进的结构。 每一章在逻辑上都承接上一章，并在最后给出一个完整的项目。这有助于巩固所学内容。

时效性。 尽管出版于 2017 年，但书中描述的原则（REST、JWT、PDO）在 2025 年仍然是行业标准。

推荐人群

本书对以下人群有用：

• 希望掌握 API 创建的 PHP 开发人员；
• 学习后端开发的学生和初级程序员；
• 从其他语言（Python、Java）转向 PHP 的开发人员；
• 所有想从内部了解现代 Web 服务如何工作的人。

如果您正在寻找一本关于 PHP API 的简洁而内容丰富的指南——这本书将是一个很好的选择。它不能替代官方文档，但能为独立开发打下坚实的基础。