适配PHP开发服务器的.htaccess重定向路由脚本需求及问题排查

1. 确保路由脚本被正确指定启动 #

PHP内置开发服务器不会自动将目录下的PHP文件作为路由脚本，必须在启动时显式指定：

php -S localhost:8000 router.php

这里router.php是你的路由脚本文件名，启动后所有请求才会先经过该脚本处理。若未指定，服务器只会直接响应静态文件，你的脚本根本不会运行，日志自然只会显示连接建立和关闭的信息。

2. 修正.htaccess文件路径与错误处理 #

原脚本硬编码的/www/.htaccess路径大概率不符合本地开发环境，且缺少错误处理，导致文件读取失败时脚本静默异常：

• 改用相对路径（假设.htaccess与路由脚本同目录），并增加存在性检查：

$htaccessPath = __DIR__ . '/.htaccess';
if (!file_exists($htaccessPath)) {
    http_response_code(500);
    die('Error: .htaccess file not found at ' . $htaccessPath);
}
$htaccessContent = file_get_contents($htaccessPath);

3. 优化正则匹配规则 #

原正则仅能匹配目标URL不含空格的情况，若.htaccess中的重定向目标包含空格或被引号包裹，会匹配失败。优化正则规则如下：

$pattern = '/Redirect 302\s+(?P<old>[^\s"]+|"[^"]+")\s+(?P<new>[^\s"]+|"[^"]+")/';
preg_match_all($pattern, $htaccessContent, $matches, PREG_SET_ORDER);

同时修正引号处理逻辑：

$oldPage = trim($match['old'], '"');
$newPage = trim($match['new'], '"');

4. 处理请求URI中的查询字符串与静态文件响应 #

$_SERVER['REQUEST_URI']可能包含查询字符串（如/some.ts?foo=bar），直接拼接路径会导致file_exists判断错误；且原脚本的return false行为在路由脚本中不稳定，替换为直接输出静态文件：

// 去除请求URI中的查询字符串
$requestURI = strtok($_SERVER['REQUEST_URI'], '?');
$filePath = __DIR__ . $requestURI;

// 处理静态文件请求
if (file_exists($filePath) && !is_dir($filePath)) {
    // 设置正确的MIME类型
    $mime = mime_content_type($filePath);
    header("Content-Type: $mime");
    // 输出文件内容并终止脚本
    readfile($filePath);
    exit;
}

5. 开启错误调试 #

在脚本开头添加错误显示配置，快速排查隐藏的语法或运行时错误：

ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);

修正后的完整脚本 #

<?php
// 开启错误调试
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);

// 获取请求URI并去除查询字符串
$requestURI = strtok($_SERVER['REQUEST_URI'], '?');
$filePath = __DIR__ . $requestURI;

/**
 * 从.htaccess读取302重定向规则
 * @return array
 */
function getHtaccessRedirectRules()
{
    $htaccessPath = __DIR__ . '/.htaccess';
    if (!file_exists($htaccessPath)) {
        http_response_code(500);
        die('Error: .htaccess file not found at ' . $htaccessPath);
    }
    
    $htaccessContent = file_get_contents($htaccessPath);
    // 匹配带引号或不带引号的重定向规则
    $pattern = '/Redirect 302\s+(?P<old>[^\s"]+|"[^"]+")\s+(?P<new>[^\s"]+|"[^"]+")/';
    preg_match_all($pattern, $htaccessContent, $matches, PREG_SET_ORDER);

    $redirectRules = [];
    foreach ($matches as $match) {
        $oldPage = trim($match['old'], '"');
        $newPage = trim($match['new'], '"');
        $redirectRules[$oldPage] = $newPage;
    }
    
    return $redirectRules;
}

// 处理静态文件请求
if (file_exists($filePath) && !is_dir($filePath)) {
    $mime = mime_content_type($filePath);
    header("Content-Type: $mime");
    readfile($filePath);
    exit;
}

// 获取重定向规则并匹配
$redirectRules = getHtaccessRedirectRules();
foreach ($redirectRules as $oldPage => $newPage) {
    if ($requestURI === $oldPage) {
        header("Location: $newPage", true, 302);
        exit;
    }
}

// 无匹配规则返回404
http_response_code(404);
echo '404 Page Not Found';
?>

内容的提问来源于stack exchange，提问作者Michael Kiesel