生成RESTful API URL：从Apache重写到PHP路由的通用实践

RewriteEngine On
# 如果请求的不是一个实际存在的文件
RewriteCond %{REQUEST_FILENAME} !-f
# 并且请求路径不包含扩展名，则尝试添加.php
RewriteRule ^([^\.]+)$ $1.php [NC,L]

<IfModule mod_rewrite.c>
    RewriteEngine On
    # 确保 RewriteBase 设置正确，如果你的API不在根目录
    # RewriteBase /api/ # 例如，如果你的API路径是 example.com/api/

    # 如果请求的是一个实际存在的文件，则直接访问
    RewriteCond %{REQUEST_FILENAME} !-f
    # 如果请求的是一个实际存在的目录，则直接访问
    RewriteCond %{REQUEST_FILENAME} !-d

    # 将所有其他请求重写到 index.php
    # [L] 表示这是最后一条规则，停止后续处理
    RewriteRule ^ index.php [L]
</IfModule>

<?php
// index.php

// 获取请求URI，并移除查询字符串部分，确保路由匹配的准确性
$requestUri = strtok($_SERVER['REQUEST_URI'], '?');

// 如果API部署在子目录，需要移除基路径
// 例如，如果访问路径是 example.com/api/entity/5
// 而服务器根目录是 example.com/，那么 $requestUri 可能是 /api/entity/5
// 如果你的 index.php 在 /api/ 目录下，你需要移除 /api
$basePath = '/api'; // 根据你的实际部署路径调整
if (strpos($requestUri, $basePath) === 0) {
    $requestUri = substr($requestUri, strlen($basePath));
}

// 路由定义：键是正则表达式模式，值是对应的处理函数名
$routes = [
    // 匹配 /entity/123 这样的路径，捕获ID
    '#^/entity/(\d+)$#' => 'handleEntityDetail',
    // 匹配 /entity 这样的路径
    '#^/entity$#'      => 'handleEntityList',
    // 匹配 /user/profile 这样的路径
    '#^/user/profile$#' => 'handleUserProfile',
    // ... 可以添加更多路由规则
];

$matched = false;
foreach ($routes as $pattern => $handler) {
    // 使用正则表达式匹配请求URI
    if (preg_match($pattern, $requestUri, $matches)) {
        $matched = true;
        array_shift($matches); // 移除完整匹配的字符串，只保留捕获的子组

        // 调用对应的处理函数，并将捕获的参数作为参数传递
        if (function_exists($handler)) {
            call_user_func_array($handler, $matches);
        } else {
            // 处理器不存在的错误处理
            header("HTTP/1.1 500 Internal Server Error");
            echo "Error: Handler '{$handler}' not found.";
        }
        break; // 找到匹配项后停止循环
    }
}

if (!$matched) {
    // 如果没有路由匹配，则返回404 Not Found
    header("HTTP/1.1 404 Not Found");
    echo "404 Not Found: Resource for '{$requestUri}' could not be found.";
}

// --- 示例处理函数 ---

/**
 * 处理获取单个实体详情的请求。
 * @param int $id 实体ID
 */
function handleEntityDetail($id) {
    header('Content-Type: application/json');
    // 这里可以根据 $id 从数据库获取数据
    $entityData = ['id' => $id, 'name' => 'Example Entity ' . $id, 'status' => 'active'];
    echo json_encode($entityData);
}

/**
 * 处理获取实体列表的请求。
 */
function handleEntityList() {
    header('Content-Type: application/json');
    // 这里可以从数据库获取所有实体列表
    $entityList = [
        ['id' => 1, 'name' => 'Entity A'],
        ['id' => 2, 'name' => 'Entity B']
    ];
    echo json_encode($entityList);
}

/**
 * 处理用户个人资料请求。
 */
function handleUserProfile() {
    header('Content-Type: application/json');
    $userData = ['username' => 'testuser', 'email' => 'test@example.com'];
    echo json_encode($userData);
}

?>