PHP源码RESTfulAPI构建_PHP源码RESTfulAPI构建指南

构建PHP源码RESTful API需从入口文件解析请求，通过自定义路由匹配HTTP方法与URI，调用对应处理函数，结合PDO操作数据库并返回标准JSON响应，全程手动控制流程以实现高效安全的接口通信。

构建PHP源码RESTful API，核心在于从底层理解HTTP请求处理、路由解析、数据模型交互及标准JSON响应输出。这并非简单的框架堆砌，而是对请求生命周期的精细掌控，从URL到数据库，再到客户端，每一步都需要我们亲自搭建和优化。它要求我们对HTTP协议、PHP运行机制以及数据安全有更深入的认识。

当我们谈及用PHP源码构建RESTful API，我脑海中浮现的，首先是一张空白画布。这不像使用Laravel或Symfony那样，一切都已预设妥当。我们需要亲手绘制请求进入、数据处理、响应送出的整个流程。

一个基础的API构建，从入口文件

index.php

开始。所有的HTTP请求都会汇聚于此。这里需要做的，是对

$_SERVER['REQUEST_URI']

和

$_SERVER['REQUEST_METHOD']

进行解析。

我通常会先搭一个简单的路由系统。这可以是一个数组，将URI模式与对应的处理函数或类方法关联起来。比如：

立即学习“PHP免费学习笔记（深入）”；

SCNet智能助手

SCNet超算互联网平台AI智能助手

47

查看详情

// index.php
header('Content-Type: application/json; charset=utf-8');
// 简单的路由配置
$routes = [
'GET /users' => 'getUsers',
'GET /users/(\d+)' => 'getUserById', // 正则匹配ID
'POST /users' => 'createUser',
'PUT /users/(\d+)' => 'updateUser',
'DELETE /users/(\d+)' => 'deleteUser',
];
$requestUri = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
$requestMethod = $_SERVER['REQUEST_METHOD'];
// 匹配路由
$matched = false;
foreach ($routes as $routePattern => $handler) {
list($method, $pattern) = explode(' ', $routePattern, 2);
if ($method !== $requestMethod) {
continue;
}
// 处理带参数的路由
if (preg_match('#^' . $pattern . '$#', $requestUri, $matches)) {
array_shift($matches); // 移除完整匹配项
call_user_func_array($handler, $matches);
$matched = true;
break;
}
}
if (!$matched) {
http_response_code(404);
echo json_encode(['message' => 'Endpoint Not Found']);
exit();
}
// 示例处理函数 (这些函数在实际项目中会放在单独的文件中，这里为简化展示)
function getUsers() {
// 假设从数据库获取用户列表
$pdo = getDbConnection();
$stmt = $pdo->query('SELECT id, name FROM users');
$users = $stmt->fetchAll();
echo json_encode(['data' => $users]);
}
function getUserById($id) {
// 从数据库获取指定ID的用户
$pdo = getDbConnection();
$stmt = $pdo->prepare('SELECT id, name FROM users WHERE id = :id');
$stmt->execute([':id' => $id]);
$user = $stmt->fetch();
if ($user) {
echo json_encode(['data' => $user]);
} else {
http_response_code(404);
echo json_encode(['message' => 'User Not Found']);
}
}
function createUser() {
$input = json_decode(file_get_contents('php://input'), true);
// 验证输入，插入数据库
if (isset($input['name'])) {
$pdo = getDbConnection();
$stmt = $pdo->prepare('INSERT INTO users (name) VALUES (:name)');
$stmt->execute([':name' => $input['name']]);
http_response_code(201); // Created
echo json_encode(['message' => 'User created', 'id' => $pdo->lastInsertId(), 'name' => $input['name']]);
} else {
http_response_code(400); // Bad Request
echo json_encode(['message' => 'Name is required']);
}
}
// ... 其他处理函数类似，例如 updateUser, deleteUser
// 数据库连接示例
function getDbConnection() {
static $pdo = null;
if ($pdo === null) {
try {
// 请根据实际环境修改数据库连接信息
$pdo = new PDO('mysql:host=localhost;dbname=mydb;charset=utf8', 'user', 'password');
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
$pdo->setAttribute(PDO::ATTR_DEFAULT_FETCH_MODE, PDO::FETCH_ASSOC);
} catch (PDOException $e) {
http_response_code(500);
echo json_encode(['message' => 'Database connection failed: ' . $e->getMessage()]);
exit();
}
}
return $pdo;
}

这只是一个骨架，但它展现了核心思想：接收请求，解析URI和方法，匹配到对应的业务逻辑，然后返回JSON。数据库交互方面，我会推荐使用PDO，它提供了统一的接口，能有效防止SQL注入。

错误处理是