1. 理解RESTful URL重写需求
在构建现代web api时，采用restful风格的url是提升api可读性和易用性的重要实践。例如，将传统的api/entity.php?id=5形式的url优化为更简洁、语义化的api/entity/5。最初的重写尝试通常包括移除.php扩展名，如将api/entity?id=5内部重写为api/entity.php?id=5。然而，进一步实现如api/entity/5到api/entity.php/5（或api/entity.php?id=5）的通用重写，尤其是希望避免为每个实体硬编码规则时，会遇到apache .htaccess规则的复杂性和局限性。
2. Apache .htaccess重写的局限性
虽然Apache的mod_rewrite模块功能强大，可以实现多种URL重写，但对于实现通用且复杂的RESTful路由模式（如/entity/{id}到/entity.php/{id}并解析{id}），纯粹依靠.htaccess会变得非常复杂且难以维护。
例如，以下规则尝试将entity/5重写为entity.php/5：
RewriteEngine On
# 确保请求的文件或目录不存在
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
# 尝试将 /entity/5 这样的路径重写为 /entity.php/5
RewriteRule ^([^/]+)/(\d+)$ $1.php/$2 [NC,L]
# 如果需要移除 .php 扩展名，可能需要另一条规则，但会与上述规则冲突或导致循环
# RewriteRule ^([^\.]+)$ $1.php [NC,L]这条规则的问题在于，当存在多条重写规则时，它们的执行顺序和条件判断会变得非常微妙。例如，如果先有移除.php扩展名的规则，再尝试匹配/entity/5，可能会导致意外的行为。更重要的是，.htaccess层面的重写缺乏应用层面的上下文感知能力，难以优雅地处理不同的HTTP方法（GET, POST, PUT, DELETE）或更复杂的路由逻辑。
3. 推荐方案：结合.htaccess与PHP路由器
鉴于.htaccess在通用路由方面的局限性，更推荐的做法是采用“前端控制器”模式，即将所有非静态文件或目录的请求都转发到一个单一的PHP入口文件（如index.php），然后由该PHP文件内部的路由器来解析URL并分发请求。这种方式将URL解析的复杂性从Web服务器层转移到应用层，提供了更大的灵活性和可维护性。
立即学习“PHP免费学习笔记（深入）”；
3.1 .htaccess配置：前端控制器模式
首先，配置.htaccess文件，将所有不直接对应文件或目录的请求重写到index.php。
RewriteEngine On
RewriteBase / # 如果你的API不在根目录，请根据实际路径修改，例如 /api/
# 阻止直接访问 .php 文件，除非是通过重写
# RewriteCond %{THE_REQUEST} ^[A-Z]{3,9}\s([^.]+)\.php [NC]
# RewriteRule ^ %1 [R=301,L]
# 确保请求的文件或目录不存在
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
# 将所有请求重写到 index.php
RewriteRule ^(.*)$ index.php [QSA,L]解释：
- RewriteEngine On：启用重写引擎。
- RewriteBase /：设置重写基路径。如果你的API位于子目录，例如http://example.com/api/，则应设置为RewriteBase /api/。
- RewriteCond %{REQUEST_FILENAME} !-f：如果请求的文件不存在，则继续。
- RewriteCond %{REQUEST_FILENAME} !-d：如果请求的目录不存在，则继续。
- RewriteRule ^(.*)$ index.php [QSA,L]：将所有符合条件的请求重写到index.php。QSA（Query String Append）表示追加原始查询字符串，L（Last）表示这是最后一条规则。
3.2 PHP路由器实现：解析URL并分发请求
在index.php文件中，你可以编写一个简单的PHP路由器来解析REQUEST_URI并根据定义的路由规则分发请求。
示例 index.php 内容：
[
'entity/(\d+)' => 'getEntity', // 匹配 /entity/ID
'entity' => 'getAllEntities', // 匹配 /entity
],
'POST' => [
'entity' => 'createEntity',
],
// ... 其他HTTP方法和路由
];
$method = $_SERVER['REQUEST_METHOD'];
function getEntity($id) {
echo "获取实体 ID: " . htmlspecialchars($id);
// 这里可以调用你的实体服务或控制器
}
function getAllEntities() {
echo "获取所有实体";
// 这里可以调用你的实体服务或控制器
}
function createEntity() {
echo "创建新实体";
// 处理 POST 请求数据
}
$matched = false;
if (isset($routes[$method])) {
foreach ($routes[$method] as $pattern => $handler) {
// 使用正则表达式匹配路径
if (preg_match('#^' . $pattern . '$#', $path, $matches)) {
array_shift($matches); // 移除完整的匹配字符串
call_user_func_array($handler, $matches);
$matched = true;
break;
}
}
}
if (!$matched) {
header("HTTP/1.0 404 Not Found");
echo "404 Not Found - Route not found for: " . htmlspecialchars($path);
}
?>解释：
- 获取请求URI：$_SERVER['REQUEST_URI']包含完整的请求路径和查询字符串。strtok用于移除查询字符串，trim用于移除路径两端的斜杠，便于匹配。
- 路由定义：$routes数组定义了不同HTTP方法下对应的URL模式（正则表达式）和处理函数。
- 匹配与分发：代码遍历当前HTTP方法下的所有路由规则，使用preg_match进行正则表达式匹配。如果匹配成功，则调用相应的处理函数，并将捕获到的参数（如ID）作为参数传递。
- 错误处理：如果没有任何路由匹配成功，则返回404 Not Found错误。
4. 优势与注意事项
4.1 PHP路由器的优势
- 灵活性高：可以轻松定义复杂的路由模式，包括动态参数、可选参数等。
- 逻辑集中：所有路由逻辑都在PHP代码中管理，易于调试和维护。
- 上下文感知：PHP路由器可以访问请求的所有信息（HTTP方法、请求头、请求体等），从而实现更智能的路由分发。
- 可扩展性强：随着API的增长，添加新的路由或修改现有路由变得非常简单。
- 框架集成：许多PHP框架（如Laravel、Symfony、Yii）都内置了功能强大的路由器，无需从头开始编写。对于小型项目，也可以使用轻量级的开源路由器库。
4.2 注意事项
- 安全性：从URL中提取的参数（如$id）在用于数据库查询或显示之前，必须进行严格的验证和过滤，以防止SQL注入、XSS等安全漏洞。
- 性能：对于非常高流量的应用，自定义的正则表达式匹配可能会有轻微的性能开销，但对于大多数API来说，这通常不是瓶颈。
- 错误处理：除了404，还应考虑其他HTTP状态码（如400 Bad Request, 401 Unauthorized, 403 Forbidden, 500 Internal Server Error）的恰当处理。
- 代码组织：随着API的复杂化，建议将路由定义、控制器（处理函数）和模型（数据逻辑）分离到不同的文件中，遵循MVC（Model-View-Controller）或其他设计模式，以保持代码的清晰和可维护性。
总结
尽管Apache .htaccess可以实现基本的URL重写，但对于构建具有通用、灵活且易于维护的RESTful API，将URL路由的职责交给PHP应用层是更明智的选择。通过配置.htaccess将所有请求导向一个前端控制器，并利用PHP编写一个路由器来解析URI和分发请求，可以实现优雅的URL结构，同时为API的未来扩展和维护打下坚实的基础。对于不希望“重复造轮子”的开发者，使用现有的PHP框架或路由器库将大大简化开发流程。
