PHP如何使用RESTful API_PHP RESTful API的设计与实现方法详解-php教程-PHP中文网

PHP如何使用RESTful API_PHP RESTful API的设计与实现方法详解

雪夜

发布： 2025-11-18 08:21:05

原创

969人浏览过

答案：PHP实现RESTful API需理解HTTP方法与资源操作对应关系，通过路由分发请求至控制器，由控制器调用模型处理数据并返回JSON响应。1. 使用$_SERVER获取请求路径与方法，解析URI并映射到对应控制器；2. 控制器根据HTTP方法调用模型的增删改查方法；3. 模型使用PDO安全操作数据库，防止SQL注入；4. 统一返回JSON格式数据，并设置正确HTTP状态码，如200、201、404等；5. 通过json_decode读取POST/PUT数据，确保输入验证与错误处理。该结构清晰，便于维护扩展。

php如何使用restful api_php restful api的设计与实现方法详解

PHP 实现 RESTful API 并不复杂，核心在于理解 HTTP 方法与资源操作的对应关系，并通过路由、控制器和数据处理完成请求响应。下面详细介绍设计与实现方法。

RESTful API 基本概念

REST（Representational State Transfer）是一种基于 HTTP 协议的软件架构风格。RESTful API 使用标准的 HTTP 方法对资源进行操作：

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

每个 URL 表示一个资源，例如：/api/users 表示用户集合，/api/users/1 表示 ID 为 1 的用户。

项目结构设计

合理的目录结构有助于维护和扩展。一个简单的结构如下：

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

/api
  index.php          # 入口文件
  routes.php         # 路由分发
  controllers/
    UserController.php
  models/
    User.php
  config/
    database.php

登录后复制

入口文件 index.php 接收所有请求，通过路由转发到对应控制器。

路由解析与请求分发

使用 PHP 的 $_SERVER['REQUEST_URI'] 和 $_SERVER['REQUEST_METHOD'] 获取路径和方法。

示例路由处理逻辑：

$uri = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
$uri = explode('/', trim($uri, '/'));
$method = $_SERVER['REQUEST_METHOD'];

根据路径判断资源类型，如 users 调用 UserController，再结合 ID 判断是列表还是单条操作。

可使用简单 switch 或数组映射实现路由分发：

设计师AI工具箱

最懂设计师的效率提升平台，实现高效设计出图和智能改图，室内设计，毛坯渲染，旧房改造，软装设计

124

查看详情

if ($uri[0] === 'users') {
  require_once 'controllers/UserController.php';
  $controller = new UserController();
  if (isset($uri[1]) && is_numeric($uri[1])) {
    $id = (int)$uri[1];
    if ($method === 'GET') $controller->getById($id);
    if ($method === 'PUT') $controller->update($id);
    if ($method === 'DELETE') $controller->delete($id);
  } else {
    if ($method === 'GET') $controller->getAll();
    if ($method === 'POST') $controller->create();
  }
}

控制器与数据处理

控制器负责接收请求、调用模型、返回 JSON 响应。

UserController 示例方法：

class UserController {
  public function getAll() {
    $users = User::fetchAll();
    $this->jsonResponse($users);
  }

  public function getById($id) {
    $user = User::findById($id);
    if ($user) {
      $this->jsonResponse($user);
    } else {
      http_response_code(404);
      echo json_encode(['error' => 'User not found']);
    }
  }

  private function jsonResponse($data) {
    header('Content-Type: application/json');
    echo json_encode($data);
  }
}

数据库交互（Model 层）

使用 PDO 进行安全的数据库操作，避免 SQL 注入。

class User {
  private static $pdo;

  public static function fetchAll() {
    $stmt = self::$pdo->query("SELECT * FROM users");
    return $stmt->fetchAll(PDO::FETCH_ASSOC);
  }

  public static function findById($id) {
    $stmt = self::$pdo->prepare("SELECT * FROM users WHERE id = ?");
    $stmt->execute([$id]);
    return $stmt->fetch(PDO::FETCH_ASSOC);
  }

  public static function create($data) {
    $stmt = self::$pdo->prepare("INSERT INTO users (name, email) VALUES (?, ?)");
    return $stmt->execute([$data['name'], $data['email']]);
  } }