PHP内置服务php -S是否支持读取.htaccess配置实现路由重写？

PHP 自带的内置Web服务器（php -S）本身不支持读取.htaccess配置文件。.htaccess是Apache服务独有的配置特性，PHP内置服务没有实现对应的解析逻辑，不存在直接加参数加载.htaccess的用法。

以下两种方案都可以实现和你现有.htaccess完全一致的路由效果：

方案1：使用独立路由脚本（无侵入原有业务代码） #

在项目根目录新建router.php文件，代码如下：

<?php
// 匹配静态资源直接返回不处理
if (preg_match('/\.(?:png|jpg|jpeg|gif|css|js|ico|woff|woff2|ttf|svg)$/', $_SERVER["REQUEST_URI"])) {
    return false;
}
// 匹配存在的目录、文件、软链接直接返回
$requestPath = $_SERVER["DOCUMENT_ROOT"] . parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
if (is_file($requestPath) || is_dir($requestPath) || is_link($requestPath)) {
    return false;
}
// 实现.htaccess等价的重写逻辑
$_GET['url'] = ltrim(parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH), '/');
// 合并原有GET参数，和QSA规则效果一致
parse_str(parse_url($_SERVER['REQUEST_URI'], PHP_URL_QUERY) ?? '', $originQuery);
$_GET = array_merge($originQuery, $_GET);
// 加载原有项目入口
require __DIR__ . '/index.php';

启动服务时执行如下命令即可：

php -S localhost:8000 router.php

原有.htaccess、index.php代码完全不需要修改，适配Apache生产部署和本地内置服务开发两种场景。

方案2：修改index.php实现兼容 #

如果不想新增路由文件，可以直接在index.php最开头加入适配逻辑：

<?php
// 仅在使用PHP内置服务启动时生效
if (php_sapi_name() === 'cli-server') {
    // 匹配静态资源直接返回
    if (preg_match('/\.(?:png|jpg|jpeg|gif|css|js|ico|woff|woff2|ttf|svg)$/', $_SERVER["REQUEST_URI"])) {
        return false;
    }
    $requestPath = $_SERVER["DOCUMENT_ROOT"] . parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
    if (is_file($requestPath) || is_dir($requestPath) || is_link($requestPath)) {
        return false;
    }
    // 赋值url参数
    $_GET['url'] = ltrim(parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH), '/');
    parse_str(parse_url($_SERVER['REQUEST_URI'], PHP_URL_QUERY) ?? '', $originQuery);
    $_GET = array_merge($originQuery, $_GET);
}

// 原有业务代码不变
$url = $_GET['url'];
if ($url == "hello") {
    // go to hello file
} else {
    // go to other file
}

启动时直接执行常规命令即可：

php -S localhost:8000

PHP内置服务器仅用于本地开发测试，不要在生产环境使用，生产环境部署到Apache服务时原有.htaccess规则可正常生效。

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