答案是搭建基于PHP的RESTful API需理解HTTP动词与资源映射,规划目录结构,配置路由解析。具体包括:定义用户资源的增删改查操作,建立models、controllers等分层目录,通过.htaccess实现URL重写,index.php解析请求路径并分发至对应控制器处理。

搭建一个基于PHP的RESTful API接口并不复杂,只要理解HTTP动词与资源操作之间的映射关系,并合理组织代码结构。以下是使用原生PHP(不依赖框架)构建RESTful API的详细步骤,适合初学者快速上手。
RESTful 是一种设计风格,不是标准。它基于HTTP协议,利用请求方法(GET、POST、PUT、DELETE等)对资源进行操作。例如:
每个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);
}
}
?>使用 curl 或 Postman 测试接口是否正常工作:
基本上就这些。这套结构清晰、可扩展性强。后续可以加入身份验证(如JWT)、输入验证、日志记录等功能来增强安全性与稳定性。不需要框架也能写出规范的RESTful API。
以上就是如何搭建RESTfulAPI接口_PHP框架构建RESTfulAPI详细步骤的详细内容,更多请关注php中文网其它相关文章!
PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号