Apache URL重写不直接实现RESTful API，而是将语义化路径（如/api/users/123）映射到单一入口index.php，由PHP解析path参数、HTTP方法并分发至对应控制器，配合FastRoute等路由器库实现标准REST行为。
Apache URL 重写本身不直接“实现”RESTful API，而是为 RESTful 路由提供底层支持——它把语义化路径（如 /api/users/123）映射到实际可执行的脚本（如 index.php），再由 PHP 层完成真正的资源解析与方法分发。关键在于：Apache 负责“收口”，PHP 负责“路由”。
用 Apache 把所有动态请求转给单一入口
这是最通用、最推荐的做法，避免在 .htaccess 里硬编码每条资源规则。
- 确保
mod_rewrite已启用，且对应目录允许AllowOverride All - 在网站根目录或 API 子目录下创建
.htaccess，内容如下：
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^api/(.*)$ /api/index.php?path=$1 [QSA,L]
说明：
• 前两个 RewriteCond 排除非文件、非目录的真实路径（比如 /api/logo.png 不走重写）
• ^api/(.*)$ 捕获全部 /api/xxx 路径，传给 index.php 的 path 参数
• [QSA,L] 保证查询参数（如 ?limit=10）不丢失，且终止后续规则
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
让 PHP 入口文件解析 REST 路径
index.php 需做三件事：解析 $_GET['path']、获取 HTTP 方法（$_SERVER['REQUEST_METHOD']）、分发到对应控制器。
- 例如请求
GET /api/users/5→path = "users/5"→ 解析出资源users、ID5、方法GET - 可用简单数组映射：
['GET:/users' => 'UsersController::list', 'POST:/users' => 'UsersController::create'] - 建议使用轻量路由器库（如 FastRoute），它支持正则路由和 HTTP 方法绑定，避免手动字符串拆分
避免常见陷阱
纯 Apache 规则难以胜任复杂 REST 场景，以下做法应避开：
- 为每个资源单独写一条
RewriteRule（如^/api/users/(\d+)$ /api/users.php?id=$1）——维护成本高、无法统一处理认证/日志/跨域 - 用
[R]重定向代替内部重写——会丢失 POST 数据、暴露真实路径、增加一次 HTTP 往返 - 试图在 .htaccess 中区分
GET /users和PUT /users/7—— mod_rewrite 不感知 HTTP 方法，必须交由 PHP 处理
配合 RESTful 设计原则
URL 重写只是基础设施，真正 RESTful 还需后端配合：
- 路径用名词复数：
/api/posts而非/api/getPosts - 用标准 HTTP 方法表达意图：GET 查、POST 增、PUT/PATCH 改、DELETE 删
- 返回合适状态码：201 创建成功、404 资源不存在、405 方法不被允许
- 响应体保持一致格式（如 JSON），包含必要元数据（如分页信息）
