随着web开发的发展，restful api已经成为了现代web应用程序的标准之一。相比于传统的api，restful api具有更高的灵活性和可扩展性。php和mysql作为广泛应用的web开发工具，也可以用来构建restful api。本文将详细介绍如何使用php和mysql构建restful api，并提供代码实例和注意事项。
一、RESTful API简介
RESTful API是一种基于HTTP协议和标准数据格式的Web API设计形式。它通常使用HTTP动词（GET、POST、PUT、DELETE等）对资源进行操作，并使用HTTP状态码表示操作结果。RESTful API的设计原则包括资源、表述性状态转移、统一接口、自包含性和超媒体。
二、使用PHP和MySQL构建RESTful API
- 安装和配置PHP和MySQL
首先需要安装和配置PHP和MySQL，这里不再赘述。安装完成后可以使用phpinfo函数验证PHP是否正常工作，或者在MySQL中创建一个测试数据库来验证MySQL是否正常工作。
立即学习“PHP免费学习笔记（深入）”；
- 创建RESTful API的基本结构
接下来，需要创建RESTful API的基本结构。首先是数据库连接，使用以下代码：
<?php
//数据库连接参数
define('DB_HOST', 'localhost');
define('DB_USER', 'root');
define('DB_PASS', '');
define('DB_NAME', 'test');
//建立数据库连接
function connect() {
$mysqli = new mysqli(DB_HOST, DB_USER, DB_PASS, DB_NAME);
if(mysqli_connect_errno()) {
die("Database connection failed: " . mysqli_connect_error());
}
return $mysqli;
}
//关闭数据库连接
function disconnect($mysqli) {
$mysqli -> close();
}
?>需要注意的是，这里使用了面向对象的mysqli连接，而不是传统的mysql连接方式。
接下来需要创建基本的RESTful API类，也就是定义HTTP请求和响应的行为。这里定义了四个HTTP动词：GET、POST、PUT和DELETE。使用以下代码：
<?php
require_once('db_connect.php');
class Rest {
protected $request;
protected $mysqli;
protected $method;
protected $args;
protected $resource = '';
protected $statusCodes = array(
200 => 'OK',
201 => 'Created',
202 => 'Accepted',
204 => 'No Content',
400 => 'Bad Request',
401 => 'Unauthorized',
403 => 'Forbidden',
404 => 'Not Found',
406 => 'Not Acceptable',
500 => 'Internal Server Error'
);
public function __construct() {
$this -> mysqli = connect();
$this -> request = explode('/', trim($_SERVER['PATH_INFO'], '/'));
$this -> method = $_SERVER['REQUEST_METHOD'];
$this -> args = $_SERVER['QUERY_STRING'];
$this -> resource = array_shift($this -> request);
}
public function processRequest() {
switch($this -> method) {
case 'POST':
$response = $this -> create();
break;
case 'PUT':
$response = $this -> update();
break;
case 'DELETE':
$response = $this -> delete();
break;
case 'GET':
default:
$response = $this -> read();
break;
}
header('HTTP/1.1 ' . $this -> statusCodes[$response['status']]);
header('Content-Type: application/json; charset=utf-8');
return json_encode($response['data']);
}
protected function create() {}
protected function read() {}
protected function update() {}
protected function delete() {}
}
?>这个类的构造函数会解析HTTP请求中的方法、路径和参数，并保存在对象属性中。然后根据HTTP方法调用相应的方法处理请求。
- 实现RESTful API的CRUD操作
接下来需要在RESTful API类中实现CRUD操作。以用户为例，使用以下代码：
class UserAPI extends Rest {
public function create() {
$data = json_decode(file_get_contents("php://input"), true);
$username = $data['username'];
$password = $data['password'];
$email = $data['email'];
if(!empty($username) && !empty($password) && !empty($email)) {
$stmt = $this -> mysqli -> prepare("INSERT INTO users (username, password, email) VALUES (?, ?, ?)");
$stmt -> bind_param("sss", $username, $password, $email);
$stmt -> execute();
$stmt -> close();
$response['status'] = 201;
$response['data'] = "User created successfully.";
} else {
$response['status'] = 400;
$response['data'] = "Invalid parameters.";
}
return $response;
}
public function read() {
$id = array_shift($this -> request);
if(empty($id)) {
$result = $this -> mysqli -> query("SELECT * FROM users");
while($row = $result -> fetch_assoc()) {
$data[] = $row;
}
$response['status'] = 200;
$response['data'] = $data;
} else {
$result = $this -> mysqli -> query("SELECT * FROM users WHERE id = $id");
if($result -> num_rows == 1) {
$response['status'] = 200;
$response['data'] = $result -> fetch_assoc();
} else {
$response['status'] = 404;
$response['data'] = "User not found.";
}
}
return $response;
}
public function update() {
$id = array_shift($this -> request);
$data = json_decode(file_get_contents("php://input"), true);
$username = $data['username'];
$password = $data['password'];
$email = $data['email'];
if(!empty($username) && !empty($password) && !empty($email)) {
$stmt = $this -> mysqli -> prepare("UPDATE users SET username=?, password=?, email=? WHERE id=?");
$stmt -> bind_param("sssi", $username, $password, $email, $id);
$stmt -> execute();
$stmt -> close();
$response['status'] = 200;
$response['data'] = "User updated successfully.";
} else {
$response['status'] = 400;
$response['data'] = "Invalid parameters.";
}
return $response;
}
public function delete() {
$id = array_shift($this -> request);
$result = $this -> mysqli -> query("SELECT * FROM users WHERE id = $id");
if($result -> num_rows == 1) {
$this -> mysqli -> query("DELETE FROM users WHERE id = $id");
$response['status'] = 200;
$response['data'] = "User deleted successfully.";
} else {
$response['status'] = 404;
$response['data'] = "User not found.";
}
return $response;
}
}这里定义了一个UserAPI类，实现了create、read、update和delete方法。对于POST请求，会将Json数据解析成用户名、密码和邮箱地址，并插入到users表中；对于GET请求，如果URL中包含id参数则返回对应用户的信息，否则返回所有用户的信息；对于PUT请求，将Json数据解析成用户名、密码和邮箱地址，并更新对应用户的信息；对于DELETE请求，根据URL中的id参数删除对应用户。
- 使用RESTful API
创建完成RESTful API后，可以使用curl等工具测试API是否正常工作。使用以下curl命令向RESTful API创建用户：
curl -H "Content-Type: application/json" -X POST -d '{
"username":"testuser",
"password":"testpassword",
"email":"testuser@example.com"
}' http://localhost/user使用以下curl命令返回所有用户：
curl http://localhost/user
使用以下curl命令更新用户信息：
curl -H "Content-Type:application/json" -X PUT -d '{
"username":"newusername",
"password":"newpassword",
"email":"newusername@example.com"
}' http://localhost/user/1使用以下curl命令删除用户：
curl -X DELETE http://localhost/user/1
三、注意事项
构建RESTful API时需要注意以下几点：
- 数据库安全。RESTful API通常需要与数据库交互，这时可能存在SQL注入等安全问题。需要使用参数化查询等方式确保数据安全。
- 跨域问题。RESTful API可能会被不同域名下的应用程序调用，会产生跨域问题。需要设置Access-Control-Allow-Origin等相关HTTP header。
- API版本控制。RESTful API设计时需要考虑版本控制，避免对已经存在的API造成影响。
- HTTP状态码。RESTful API的返回值需要正确使用HTTP状态码表示请求的结果。
四、总结
本文介绍了如何使用PHP和MySQL构建RESTful API，并提供了代码实例和注意事项。RESTful API的优点在于灵活、可扩展、易于维护等，是Web开发中不可或缺的一部分。在使用RESTful API时需要注意安全、跨域问题、版本控制和HTTP状态码等问题。
