PHP路由怎么实现_单一入口文件分发请求【详解】-php教程-PHP中文网

单一入口文件是php路由的必需前提，必须通过index.php统一处理所有请求，以确保$_server['request_uri']稳定获取完整路径，并用parse_url(..., php_url_path)安全提取路径，避免环境差异导致匹配失败。

php路由怎么实现_单一入口文件分发请求【详解】

单一入口文件是 PHP 路由的基石，不是“可选方案”，而是必须前提。没有它，$_SERVER['REQUEST_URI'] 就无法稳定获取完整路径，所有后续匹配都会在本地和线上环境不一致——这是 90% 的原生路由调试失败的根源。

为什么必须用 `index.php` 作唯一入口

直接访问 /user/123 时，Web 服务器默认会尝试找对应物理路径下的 PHP 文件。如果没配置重写规则，404 是必然结果；即使有，$_SERVER['PATH_INFO'] 在 Nginx 和 Apache 下行为不同，$_SERVER['ORIG_PATH_INFO'] 更不可靠。只有强制所有请求落到 index.php，才能统一控制解析逻辑。

Apache：确保 .htaccess 启用 RewriteEngine On，并包含标准三行（RewriteCond %{REQUEST_FILENAME} !-f 等）
Nginx：在 location / 块里加 try_files $uri $uri/ /index.php?$query_string;，别用 fastcgi_split_path_info —— 它会让 /api/v1/users/ 这类路径被错误截断
开发时用 PHP 内置服务器要加路由脚本：php -S localhost:8000 router.php，其中 router.php 必须显式返回 index.php 内容

`parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH)` 是唯一安全提取方式

别碰 $_SERVER['PATH_INFO'] 或 $_SERVER['REDIRECT_URL']。前者依赖 AcceptPathInfo 配置，后者在某些 CGI 模式下为空。真实项目里，/user/123?tab=profile#section 必须只取 /user/123 这一段做匹配。

Skill Weave Chains — 技能链路由引擎

开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。

下载

必须用 parse_url(..., PHP_URL_PATH)，不能只用 str_replace() 或 substr() 手动切
部署在子目录（如 /myapp/）时，得从 $_SERVER['SCRIPT_NAME'] 推导前缀：$base = dirname($_SERVER['SCRIPT_NAME']);，再 str_replace($base, '', $path)
结尾斜杠语义敏感：/user/123 和 /user/123/ 是两个不同路由，rtrim($path, '/') 会掩盖这个差异，直接删

静态路由用 `switch`，别写 `if-else` 链

当路由数量少于 10 条、且全是固定路径（如 /、/about、/api/status），switch 比 if-else 快 30% 以上，且避免条件顺序错位导致的漏匹配。

case 值必须是字符串字面量，不能是变量或拼接表达式
default 分支必须存在，并显式调用 http_response_code(404)，否则默认返回 200
不要在 switch 外提前 exit 或 die —— 中间件或日志逻辑可能需要继续执行

正则路由必须带 `^` 和 `$` 锚点

写 /user/(\d+) 匹配 /user/123/edit 是常见翻车点。没锚定的正则会“子串匹配”，导致宽泛规则吞噬具体路径。

每条正则必须以 ^ 开头、$ 结尾，例如 ^/user/(\d+)$
命名捕获组更易维护：^/post/(?P<id>\d+)/(?P<action>\w+)$</action></id>，匹配后 $matches['id'] 直接可用
动态路由顺序很重要：把 ^/user/(\d+)/delete$ 放在 ^/user/(\d+)$ 前面，否则 delete 永远进不去
参数类型不自动转换：$id 是字符串，控制器方法若声明 function show(int $id) 会报 TypeError，需手动 (int)$matches[1]