首先设计PHP API的统一入口与路由机制，再通过PDO安全连接数据库；接着封装增删改查操作，结合HTTP方法处理请求，校验参数并返回标准JSON格式数据，最后通过分页、日志、环境变量等优化提升稳定性与安全性。
在使用PHP实现API接口为前端或其他系统提供数据库数据时，核心目标是构建一个安全、稳定、结构清晰的后端服务。下面从设计思路到具体实现，逐步说明如何通过PHP连接数据库并对外提供标准API接口。
1. API接口基本结构设计
一个典型的PHP API接口应包含以下要素：
- 统一入口：建议使用单一入口文件（如 index.php）配合路由机制处理不同请求。
- HTTP方法区分：GET用于获取数据，POST用于创建，PUT/PATCH用于更新，DELETE用于删除。
- 返回JSON格式：前后端分离常用JSON通信，设置正确Header。
- 状态码规范：成功返回200，创建返回201，错误返回4xx或5xx。
示例基础结构：
立即学习“PHP免费学习笔记（深入）”；
<?php
header('Content-Type: application/json; charset=utf-8');
header('Access-Control-Allow-Origin: *'); // 开发阶段允许跨域
header('Access-Control-Allow-Methods: GET, POST, PUT, DELETE');
<p>$method = $_SERVER['REQUEST_METHOD'];
$path = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);</p><p>// 路由分发
if ($path === '/api/users' && $method === 'GET') {
getUsers();
} elseif ($path === '/api/users' && $method === 'POST') {
createUser();
} else {
http_response_code(404);
echo json_encode(['error' => '接口未找到']);
}
?></p>2. 数据库连接与操作封装
使用PDO连接数据库，支持预处理防止SQL注入，提高安全性。
<?php
function getDB() {
$host = 'localhost';
$dbname = 'your_db_name';
$username = 'your_user';
$password = 'your_pass';
<pre class='brush:php;toolbar:false;'>try {
$pdo = new PDO("mysql:host=$host;dbname=$dbname;charset=utf8", $username, $password);
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
return $pdo;
} catch (PDOException $e) {
http_response_code(500);
echo json_encode(['error' => '数据库连接失败']);
exit;
}} ?>
查询用户示例：
function getUsers() {
$db = getDB();
$stmt = $db->query("SELECT id, name, email, created_at FROM users");
$users = $stmt->fetchAll(PDO::FETCH_ASSOC);
<pre class='brush:php;toolbar:false;'>echo json_encode([
'success' => true,
'data' => $users
]);}
3. 参数处理与安全校验
GET参数通过$_GET获取，POST/PUT数据用file_get_contents('php://input')解析JSON。
function createUser() {
$input = json_decode(file_get_contents('php://input'), true);
<pre class='brush:php;toolbar:false;'>if (!isset($input['name']) || !isset($input['email'])) {
http_response_code(400);
echo json_encode(['error' => '缺少必要字段']);
return;
}
$name = trim($input['name']);
$email = filter_var($input['email'], FILTER_VALIDATE_EMAIL);
if (!$email) {
http_response_code(400);
echo json_encode(['error' => '邮箱格式不正确']);
return;
}
$db = getDB();
$stmt = $db->prepare("INSERT INTO users (name, email) VALUES (?, ?)");
if ($stmt->execute([$name, $email])) {
http_response_code(201);
echo json_encode([
'success' => true,
'message' => '用户创建成功',
'id' => $db->lastInsertId()
]);
} else {
http_response_code(500);
echo json_encode(['error' => '保存失败']);
}}
4. 接口优化与最佳实践
- 使用环境变量：数据库账号密码不要硬编码，可用.env文件管理。
- 加入身份验证：简单可用API Key，复杂场景使用JWT。
- 日志记录：记录关键操作和错误信息便于排查。
- 分页支持：大数据量时加limit和offset参数。
- 统一响应格式：保持 success/data/error 结构一致。
例如分页获取用户：
$page = isset($_GET['page']) ? (int)$_GET['page'] : 1;
$limit = isset($_GET['limit']) ? min((int)$_GET['limit'], 100) : 10;
$offset = ($page - 1) * $limit;
<p>$stmt = $db->prepare("SELECT id, name, email FROM users LIMIT ? OFFSET ?");
$stmt->bindValue(1, $limit, PDO::PARAM_INT);
$stmt->bindValue(2, $offset, PDO::PARAM_INT);
$stmt->execute();</p>基本上就这些。只要结构清晰、做好输入校验和输出规范，PHP完全可以胜任轻量级API后端服务。
