使用Slim框架实现基本的REST API

REST API是一种广泛应用于服务器和客户端之间的网络通信接口设计风格。首先要明确的是，REST是一种API设计风格，或是理解成一种设计思想，而不是一个具体的技术、编程语言等（有点类似于模块化编程思想）。本文参考了一篇国外的文章，简单介绍了使用Slim框架实现基本REST API的过程。

本文参考文章 《How to create REST API for Android app using PHP, Slim and MySQL》

本文源码可在GitHub下载： https://github.com/jzj1993/Slim-REST-API

需要准备的工具和环境

• USBWebServer / XAMPP或其他支持PHP的服务器站点软件包（Apache，PHP，MySQL）
  可参考《USBWebserver：快速搭建本地PHP环境的好工具》 http://www.hainter.com/usbwebserver
• Chrome浏览器 + Advanced Rest Client插件（或其他REST API测试工具）
• Slim框架程序包，Composer（Slim已经包含在附件的工程源码中，Composer可以不安装）
• PHP编辑器：例如NetBeans，SublimeText等

新建数据库和数据表

进入phpmyAdmin数据库管理页面，执行如下SQL指令，新建数据库，并初始化数据表。

1. CREATE DATABASE task_manager;
3. USE task_manager;
5. CREATE TABLE IF NOT EXISTS `users` (
6. `id` int(11) NOT NULL AUTO_INCREMENT,
7. `name` varchar(250) DEFAULT NULL,
8. `email` varchar(255) NOT NULL,
9. `password_hash` text NOT NULL,
10. `api_key` varchar(32) NOT NULL,
11. `status` int(1) NOT NULL DEFAULT ‘1‘,
12. `created_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
13. PRIMARY KEY (`id`),
14. UNIQUE KEY `email` (`email`)
15. );
17. CREATE TABLE IF NOT EXISTS `tasks` (
18. `id` int(11) NOT NULL AUTO_INCREMENT,
19. `task` text NOT NULL,
20. `status` int(1) NOT NULL DEFAULT ‘0‘,
21. `created_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
22. PRIMARY KEY (`id`)
23. );
25. CREATE TABLE IF NOT EXISTS `user_tasks` (
26. `id` int(11) NOT NULL AUTO_INCREMENT,
27. `user_id` int(11) NOT NULL,
28. `task_id` int(11) NOT NULL,
29. PRIMARY KEY (`id`),
30. KEY `user_id` (`user_id`),
31. KEY `task_id` (`task_id`)
32. );
34. ALTER TABLE `user_tasks` ADD FOREIGN KEY ( `user_id` ) REFERENCES `task_manager`.`users` (
35. `id`
36. ) ON DELETE CASCADE ON UPDATE CASCADE ;
38. ALTER TABLE `user_tasks` ADD FOREIGN KEY ( `task_id` ) REFERENCES `task_manager`.`tasks` (
39. `id`
40. ) ON DELETE CASCADE ON UPDATE CASCADE;

编写程序

由于参考文章中已经对程序进行了介绍，这里跳过此步骤，直接解压源文件到服务器站点的根目录。根据数据库的登录密码，将include/Config.php中数据库的用户名、密码进行修改。

测试

启动服务器，输入如下网址可进入Slim欢迎界面 http://localhost/libs

从浏览器直接输入网址，可进入默认的HelloWorld界面 http://localhost/v1

使用Chrome插件进行REST API测试

根据参考文章中的内容，这里测试register的API，其他API的测试方法一样。启动Chrome的插件Advanced Rest Client，填写相关数据。其中API的网址如下，在Payload中添加字段name，email，password，选择POST方法；最后点击Send按钮，即可发送数据到服务器端。
http://localhost/v1/register

经过处理，就会返回注册成功的消息，如图。

在phpmyAdmin中可以看到，新注册的用户信息已经保存在数据库中了。

本文由jzj1993原创，转载请注明来源：http://www.hainter.com/slim-rest-api