如何搭建RESTfulAPI接口_PHP框架构建RESTfulAPI详细步骤

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

搭建一个基于PHP的RESTful API接口并不复杂，只要理解HTTP动词与资源操作之间的映射关系，并合理组织代码结构。以下是使用原生PHP（不依赖框架）构建RESTful API的详细步骤，适合初学者快速上手。

理解RESTful API基本概念

RESTful 是一种设计风格，不是标准。它基于HTTP协议，利用请求方法（GET、POST、PUT、DELETE等）对资源进行操作。例如：

• GET /users：获取用户列表
• GET /users/1：获取ID为1的用户
• POST /users：创建新用户
• PUT /users/1：更新ID为1的用户
• DELETE /users/1：删除ID为1的用户

每个URL代表一种资源，通过HTTP方法决定操作类型。

项目目录结构规划

良好的目录结构有助于后期维护。建议如下布局：

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

/api
  ├── index.php           # 入口文件
  ├── config/database.php # 数据库连接
  ├── models/User.php     # 用户模型
  ├── controllers/UserController.php # 控制器
  └── utils/Response.php  # 响应工具类

配置入口文件和路由解析

所有请求都应指向 index.php，通过重写URL实现路由解析。在根目录添加 .htaccess 文件：

在 index.php 中解析路径和参数：

Magician

Figma插件，AI生成图标、图片和UX文案

下载

// 路由分发：假设格式为 /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']); } ?>

连接数据库并创建模型
在 config/database.php 中建立PDO连接：
```php
 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 中定义数据操作：

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'];
}

} ?>

编写控制器处理逻辑
UserController.php 负责调用模型并返回结果：
```php
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);
    }
}
?>

测试API接口

使用 curl 或 Postman 测试接口是否正常工作：

• 获取所有用户：GET http://localhost/api/users
• 获取单个用户：GET http://localhost/api/users/1
• 创建用户：POST http://localhost/api/users → body: {"name": "John", "email": "john@example.com"}
• 更新用户：PUT http://localhost/api/users/1 → body: {"name": "Jane", "email": "jane@example.com"}
• 删除用户：DELETE http://localhost/api/users/1

基本上就这些。这套结构清晰、可扩展性强。后续可以加入身份验证（如JWT）、输入验证、日志记录等功能来增强安全性与稳定性。不需要框架也能写出规范的RESTful API。