答案是搭建基于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 文件：
Revid AI AI短视频生成平台
62 查看详情 
```apacheRewriteEngine onRewriteCond %{REQUEST_FILENAME} !-fRewriteCond %{REQUEST_FILENAME} !-dRewriteRule ^(.*)$ 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 中定义数据操作：
```phpnce '../config/database.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.phprequire_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。
以上就是如何搭建RESTfulAPI接口_PHP框架构建RESTfulAPI详细步骤的详细内容，更多请关注php中文网其它相关文章！
