答案是搭建基于php的restful api需理解http动词与资源映射，规划目录结构，配置路由解析。具体包括：定义用户资源的增删改查操作，建立models、controllers等分层目录，通过.htaccess实现url重写，index.php解析请求路径并分发至对应控制器处理。
搭建一个基于PHP的RESTful API接口并不复杂，只要理解HTTP动词与资源操作之间的映射关系，并合理组织代码结构。以下是使用原生PHP（不依赖框架）构建RESTful API的详细步骤，适合初学者快速上手。
理解RESTful API基本概念
RESTful 是一种设计风格，不是标准。它基于HTTP协议，利用请求方法（GET、POST、PUT、DELETE等）对资源进行操作。例如：
- GET /users：获取用户列表
- GET /users/1：获取ID为1的用户
- POST /users：创建新用户
- PUT /users/1：更新ID为1的用户
- DELETE /users/1：删除ID为1的用户
每个URL代表一种资源，通过HTTP方法决定操作类型。
项目目录结构规划
良好的目录结构有助于后期维护。建议如下布局：
立即学习“PHP免费学习笔记（深入）”；
/api ├── index.php # 入口文件 ├── config/database.php # 数据库连接 ├── models/User.php # 用户模型 ├── controllers/UserController.php # 控制器 └── utils/Response.php # 响应工具类
配置入口文件和路由解析
所有请求都应指向 index.php，通过重写URL实现路由解析。在根目录添加 .htaccess 文件：
```apache RewriteEngine On RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^(.*)$ index.php?url=$1 [QSA,L] ```
在 index.php 中解析路径和参数：
```php $method = $_SERVER['REQUEST_METHOD']; $url = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH); $parts = explode('/', trim($url, '/'));// 路由分发：假设格式为 /api/users[/id] if ($parts[0] === 'api' && $parts[1] === 'users') { require_once 'controllers/UserController.php'; $controller = new UserController();
if (isset($parts[2])) {
$id = $parts[2];
switch ($method) {
case 'GET':
echo json_encode($controller->getById($id));
break;
case 'PUT':
parse_str(file_get_contents('php://input'), $putData);
echo json_encode($controller->update($id, $putData));
break;
case 'DELETE':
echo json_encode($controller->delete($id));
break;
}
} else {
switch ($method) {
case 'GET':
echo json_encode($controller->getAll());
break;
case 'POST':
$data = json_decode(file_get_contents('php://input'), true);
echo json_encode($controller->create($data));
break;
}
}} else { http_response_code(404); echo json_encode(['error' => 'Not Found']); } ?>
<H3>连接数据库并创建模型</H3>
<p>在 config/database.php 中建立PDO连接：</p>
```php
<?php
// config/database.php
$host = 'localhost';
$db = 'api_db';
$user = 'root';
$pass = '';
$charset = 'utf8mb4';
$dsn = "mysql:host=$host;dbname=$db;charset=$charset";
$options = [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC
];
try {
$pdo = new PDO($dsn, $user, $pass, $options);
} catch (\PDOException $e) {
throw new \PDOException($e->getMessage(), (int)$e->getCode());
}
?>在 models/User.php 中定义数据操作：
```php class User { private $pdo;public function __construct() {
global $pdo;
$this->pdo = $pdo;
}
public function getAll() {
$stmt = $this->pdo->query("SELECT id, name, email FROM users");
return $stmt->fetchAll();
}
public function getById($id) {
$stmt = $this->pdo->prepare("SELECT id, name, email FROM users WHERE id = ?");
$stmt->execute([$id]);
return $stmt->fetch() ?: ['error' => 'User not found'];
}
public function create($data) {
$stmt = $this->pdo->prepare("INSERT INTO users (name, email) VALUES (?, ?)");
$stmt->execute([$data['name'], $data['email']]);
return ['id' => $this->pdo->lastInsertId(), 'message' => 'User created'];
}
public function update($id, $data) {
$stmt = $this->pdo->prepare("UPDATE users SET name = ?, email = ? WHERE id = ?");
$stmt->execute([$data['name'], $data['email'], $id]);
return $stmt->rowCount() ? ['message' => 'User updated'] : ['error' => 'Update failed'];
}
public function delete($id) {
$stmt = $this->pdo->prepare("DELETE FROM users WHERE id = ?");
$stmt->execute([$id]);
return $stmt->rowCount() ? ['message' => 'User deleted'] : ['error' => 'Delete failed'];
}} ?>
<H3>编写控制器处理逻辑</H3>
<p>UserController.php 负责调用模型并返回结果：</p>
```php
<?php
// controllers/UserController.php
require_once '../models/User.php';
class UserController {
private $user;
public function __construct() {
$this->user = new User();
}
public function getAll() {
return ['users' => $this->user->getAll()];
}
public function getById($id) {
return $this->user->getById($id);
}
public function create($data) {
if (empty($data['name']) || empty($data['email'])) {
http_response_code(400);
return ['error' => 'Name and email required'];
}
return $this->user->create($data);
}
public function update($id, $data) {
if (empty($data['name']) || empty($data['email'])) {
http_response_code(400);
return ['error' => 'Name and email required'];
}
return $this->user->update($id, $data);
}
public function delete($id) {
return $this->user->delete($id);
}
}
?>测试API接口
使用 curl 或 Postman 测试接口是否正常工作：
- 获取所有用户：GET http://localhost/api/users
- 获取单个用户：GET http://localhost/api/users/1
- 创建用户：POST http://localhost/api/users → body: {"name": "John", "email": "john@example.com"}
- 更新用户：PUT http://localhost/api/users/1 → body: {"name": "Jane", "email": "jane@example.com"}
- 删除用户：DELETE http://localhost/api/users/1
基本上就这些。这套结构清晰、可扩展性强。后续可以加入身份验证（如JWT）、输入验证、日志记录等功能来增强安全性与稳定性。不需要框架也能写出规范的RESTful API。
