首页 > 新闻中心 > 技术百科

php怎样实现简单路由_php实现简单路由规则匹配【路由】 返回列表

星夢妙者2026-01-15 00:00:00编辑发布,已经有个小可爱看过这篇文章啦
PHP原生路由核心是解析$_SERVER['REQUEST_URI']获取路径并匹配处理函数:固定路径用switch最安全,动态参数用preg_match加^$锚定和1+限制,需Web服务器配置重写规则(如Nginx的try_files)才能生效。/ ↩

PHP 原生如何做基础路由匹配

不用框架也能实现 URL 到处理函数的映射,核心是读取 $_SERVER['REQUEST_URI'],去掉查询参数和路径前缀后,用字符串或正则比对。关键不在“多强大”,而在“不依赖、可调试、易嵌入”。

用 switch 匹配固定路径最安全

适合后台管理页、API 端点等路径明确、变动少的场景。避免正则开销和歧义,也绕过重写配置问题。

if (isset($_SERVER['REQUEST_URI'])) {
    $path = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
    // 去掉可能的子目录前缀,如 /myapp/
    $base = '/myapp'; // 根据实际部署路径调整
    $route = $path === $base ? '/' : str_replace($base, '', $path);

    switch ($route) {
        case '/':
            echo '首页';
            break;
        case '/about':
            echo '关于页';
            break;
        case '/api/users':
            header('Content-Type: application/json');
            echo json_encode(['users' => []]);
            break;
        default:
            http_response_code(404);
            echo '404 Not Found';
            break;
    }
}
  • $base 必须与实际 Web 服务器(Nginx/Apache)部署路径一致,否则 $route 会错位
  • 注意 parse_url(..., PHP_URL_PATH) 才能剥离 ?a=1&b=2,直接用 $_SERVER['REQUEST_URI'] 会把查询参数混进匹配
  • 不要在 switch 前做 trim($path, '/') —— 会导致 /user/123/user/123/ 被当成同一路径,而它们语义不同

用 preg_match 支持带参数的动态路由

当需要提取 ID、slug 等变量时,正则比 explode('/', ...) 更可控。但必须限制贪婪匹配范围,防止误吞斜杠。

$path = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);

// 匹配 /post/123 或 /post/hello-world,不匹配 /post/123/edit
if (preg_match('#^/post/([^/]+)$#', $path, $matches)) {
    $slug = $matches[1]; // 如 '123' 或 'hello-world'
    echo "展示文章:{$slug}";
} elseif (preg_match('#^/user/(\d+)$#', $path, $matches)) {
    $id = (int)$matches[1];
    echo "用户ID:{$id}";
} else {
    http_response_code(404);
    echo '路由未定义';
}
  • 正则开头必须用 ^,结尾必须用 $,否则 /user/123/edit 也会命中 /user/(\d+)
  • 捕获组用 ([^/]+)(.+) 安全,避免跨路径段匹配
  • 数字 ID 强制转 (int),防止注入或意外类型行为

Apache/Nginx 下必须配置 URL 重写

否则访问 /about 会直接 404,Web 服务器根本不会把请求交给 index.php 处理。

  • Apache:确保 .htaccess 启用且含 RewriteRule ^(.*)$ index.

    php [QSA,L]
  • Nginx:在 server 块中加 try_files $uri $uri/ /index.php?$query_string;
  • PHP 内置服务器(php -S)需手动指定路由器脚本:php -S localhost:8000 router.php,其中 router.php 返回要加载的文件路径

没配重写,所有动态路由都只是纸上谈兵。

  • app
  • js
  • json
  • switch
  • 也能
  • 而在
  • 比对
  • php
  • 也会
  • 首页

热门新闻

来电咨询