PHPAPI接口怎么开发_PHPRESTfulAPI设计指南

开发PHP RESTful API需理解HTTP协议与REST设计原则，使用GET、POST、PUT、DELETE等方法操作资源。2. 项目结构应包含入口文件index.php、数据库配置、模型和响应工具。3. 通过.htaccess实现URL重写，统一请求入口。4. index.php解析请求路径与方法，调用对应逻辑处理并返回JSON格式数据。

开发PHP RESTful API，核心是理解HTTP协议与后端逻辑的结合。你需要用PHP处理请求、返回标准格式的数据（通常是JSON），并遵循REST设计原则。下面从基础结构到实际编码一步步说明如何开发一个简单但规范的PHP RESTful API。

1. 理解RESTful API基本概念

REST（Representational State Transfer）是一种设计风格，不是强制标准。它利用HTTP动词来操作资源：

• GET：获取资源
• POST：创建资源
• PUT：更新资源（全量）
• PATCH：部分更新资源
• DELETE：删除资源

例如，对用户资源的操作：

• GET /users → 获取用户列表
• GET /users/1 → 获取ID为1的用户
• POST /users → 创建新用户
• PUT /users/1 → 更新整个用户信息
• DELETE /users/1 → 删除用户

2. 搭建基础项目结构

建议使用简洁的目录结构：

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

确保服务器支持重写规则（如Apache的mod_rewrite），使用.htaccess隐藏index.php：

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php?path=$1 [QSA,L]

3. 编写入口文件 index.php

这是所有请求的统一入口，负责解析路径和方法：

创客贴设计

创客贴设计，一款智能在线设计工具，设计不求人，AI助你零基础完成专业设计！

51

查看详情

$path = $_GET['path'] ?? ''; $method = $_SERVER['REQUEST_METHOD'];

require_once 'config/database.php'; require_once 'models/User.php';

$user = new User($pdo);

switch ($path) { case '': if ($method === 'GET') { echo json_encode($user->getAll()); } else { http_response_code(405); echo json_encode(['error' => 'Method not allowed']); } break;

case 'users':
    if ($method === 'GET') {
        echo json_encode($user->getAll());
    } elseif ($method === 'POST') {
        $data = json_decode(file_get_contents('php://input'), true);
        $result = $user->create($data);
        echo json_encode($result);
    } else {
        http_response_code(405);
        echo json_encode(['error' => 'Method not supported']);
    }
    break;

case preg_match('/^users\/(\d+)$/', $path, $matches) ? $path : null:
    $id = $matches[1];
    if ($method === 'GET') {
        $result = $user->getById($id);
        echo $result ? json_encode($result) : json_encode(['error' => 'Not found']);
    } elseif ($method === 'PUT') {
        $data = json_decode(file_get_contents('php://input'), true);
        $result = $user->update($id, $data);
        echo json_encode(['success' => $result]);
    } elseif ($method === 'DELETE') {
        $result = $user->delete($id);
        echo json_encode(['success' => $result]);
    } else {
        http_response_code(405);
        echo json_encode(['error' => 'Method not allowed']);
    }
    break;

default:
    http_response_code(404);
    echo json_encode(['error' => 'Route not found']);

}

<H3>4. 数据库与模型设计</H3>
<p>以MySQL为例，先创建用户表：</p>
```sql
CREATE TABLE users (
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(100) NOT NULL,
    email VARCHAR(100) UNIQUE NOT NULL,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

在User.php中封装CRUD操作：

public function __construct($pdo) {
    $this->pdo = $pdo;
}

public function getAll() {
    $stmt = $this->pdo->query("SELECT id, name, email, created_at FROM users");
    return $stmt->fetchAll(PDO::FETCH_ASSOC);
}

public function getById($id) {
    $stmt = $this->pdo->prepare("SELECT id, name, email, created_at FROM users WHERE id = ?");
    $stmt->execute([$id]);
    return $stmt->fetch(PDO::FETCH_ASSOC);
}

public function create($data) {
    $stmt = $this->pdo->prepare("INSERT INTO users (name, email) VALUES (?, ?)");
    try {
        $stmt->execute([$data['name'], $data['email']]);
        return ['id' => $this->pdo->lastInsertId()];
    } catch (PDOException $e) {
        return ['error' => 'Email already exists'];
    }
}

public function update($id, $data) {
    $stmt = $this->pdo->prepare("UPDATE users SET name = ?, email = ? WHERE id = ?");
    return $stmt->execute([$data['name'], $data['email'], $id]);
}

public function delete($id) {
    $stmt = $this->pdo->prepare("DELETE FROM users WHERE id = ?");
    return $stmt->execute([$id]);
}