PHP / Laravel API 开发推荐阅读清单

image.png

社区优秀文章

• Laravel 5.5+passport 放弃 dingo 开发 API 实战，让 API 开发更省心 - 自造车轮。

• API 文档神器 Swagger 介绍及在 PHP 项目中使用 - API 文档撰写方案

• 推荐 Laravel API 项目必须使用的 8 个扩展包

• 使用 Jwt-Auth 实现 API 用户认证以及无痛刷新访问令牌

• 讲讲我最近用 Laravel 做的一个 App 后端项目

• Laravel Passport API 认证使用小结

• 关于 RESTful API 设计的总结

• Laravel 5.5 使用 Passport 实现 Auth 认证

• 使用 Laravel 的 API 资源功能来构建你的 API

• 单个 Laravel 项目同时配置不同域名 api.domain（用户端接口） 和 admin.domain（管理员端）

• 多字段登录通用解决方案

• Laravel 做 API 服务端，VueJS+iView 做 SPA，给新手一个 Demo

• 在 Laravel 中使用 GraphQL 一【获取数据】

• Laravel 开发 RESTful API 的一些心得

• 对 REST 的理解

• 用 Laravel 搭建带 OAuth2 验证的 RESTful 服务

• 在 Laravel 中动态隐藏 API 字段

• Nginx 下部署 HTTPS 与安全调优

  一套安全的 API 方案，第一步要做的事情就是部署 HTTPS

• [译] 2018 PHP 应用程序安全设计指北

  安全必读。

开发 API 必读文章

• Principles of good RESTful API Design（译：好 RESTful API 的设计原则 ）简单易懂，条理清晰，推荐
• Best Practices for Designing a Pragmatic RESTful API（译：RESTful 最佳实践 译文2）有实际的案例 Enchant
• HTTP API Design Guide（译：HTTP API 设计指南）
• Some REST best practices
• 理解 RESTful 架构 - 阮一峰 简单了解什么是 RESTFul
• RESTful API 设计指南 - 阮一峰
• Restful API 的设计规范 实战经验的总结，具有较强的启发意义
• 撰写安全合格的REST API 利用好 HTTP 协议所具备的特征
• Web 服务编程，REST 与 SOAP REST 与传统的面向服务的接口设计的区别，启发性强
• 最佳实践：更好的设计你的 REST API 了解 REST 实现缓存的过程
• Thoughts on RESTful API Design
• REST API Tutorial 全方位介绍 REST
• HTTP 接口设计指北
• Web API Design 接口就是开发人员提供的"界面"，用户体验在接口设计上同样重要，在线查看 2012 版、2013 版
• 架构风格与基于网络应用软件的架构设计 原汁原味的博士论文，由李锟翻译，有经验的同学可以挑战一下
• Microsoft REST API Guidelines 微软官方的 REST API 设计指南，值得参考
• 理解 HTTP 幂等性 讲得很清楚，推荐
• 浅析远程过程调用 RPC 告诉你什么是 RPC
• httpstatuses 一眼看完所有常用的 HTTP 状态码，还可以看详细含义
• json-api 对 API 应该如何利用好 JSON 的一些建议
• 介绍 JSON 无论如何都应该读一遍
• decision-graph.svg 一张大图展示整个 REST API 的验证过程，及各种状态码出现的时机

现成 API 例子

• Github API v3 被很多人参考和引用，比如对分页的处理方法、接口版本的设计等等
• Mailgun Documentation 邮件服务 REST API
• Enchant REST API
• Coinbase API 设计的挺好的，包括官网提供的接口客户端，都是具有参考意义的
• OpenNMS Wiki ReST API
• REST API 使用详解 Lean Cloud 中讲解 REST API 的使用，还集成 Swagger UI 在线调试工具，点击查看。

调试工具

• DHC (aka Dev HTTP Client) Chrome 插件，简单易用，可分类管理，界面友好
• Fiddler2 Windows 下抓包必备，捕捉每一次 REST 请求和响应的详细内容
• Charles Proxy Mac 下抓包必备
• Postman 功能齐全的 API 请求工具

Laravel API 课程

社区有一门实战课程 《Laravel 教程实战高级 - 构架 API 服务器》 ，主要专注于 App 和 SPA 后端 API 服务器实战开发。手把手带你构建一个设计合理的 RESTful API 服务器。本课程涉及的技术话题有：

• RESTFul 的概念及 Github Api 设计分解；
• DingoApi 的介绍及安装；
• PostMan 的介绍及使用；
• 用户认证 —— 手机注册、登录、退出；
• 第三方认证 —— 微信登录、JWT的使用；
• 用户信息 —— 获取个人信息、上传图片接口、修改个人信息；
• 话题接口 —— 发布、修改、删除、列表；
• 话题回复接口 —— 发布、修改、删除、列表；
• 权限控制 —— 权限列表，角色列表；
• 资源推荐接口、活跃用户接口；
• 接口本地化处理；
• API 接口错误代码机制；
• APNS 消息推送服务器端介绍及实现；
• API 测试 —— 单元测试、集成测试、黑盒测试；
• 快速完成 API 文档；
• Passport / OAuth 2.0 认证。

原文见：https://laravel-china.org/docs/dingo-api/2.0.0/recommended-reading