phpEnv中RewriteMap不可用，因其Apache精简版缺失mod_so及完整mod_rewrite功能；替代方案为硬编码RewriteRule或PHP层映射逻辑。
phpEnv里RewriteMap根本不能用
phpEnv 默认打包的 Apache 是精简版，mod_rewrite 虽然启用，但 RewriteMap 所依赖的 mod_so 和模块动态加载能力被阉割了——你哪怕在 httpd.conf 里写上 RewriteMap foo txt:/path/to/map.txt，Apache 启动时会直接报错：Invalid command 'RewriteMap', perhaps misspelled or defined by a module not included in the server configuration。
这不是配置顺序或路径问题，是 phpEnv 编译时压根没把 RewriteMap 支持编进去。查 phpinfo() 的 “Loaded Modules” 列表，你会发现没有 mod_so，也没有 mod_rewrite 的完整功能集（比如缺少 int:、txt: 等 map 类型）。
替代方案：用 RewriteRule + 多条件硬编码映射
如果真要支持几十个固定 URL 映射（比如旧站迁移、SEO 保链），又不想改 PHP 逻辑，只能退回到 RewriteRule 的穷举写法。它不优雅，但能在 phpEnv 里跑通：
-
RewriteEngine On必须放在最开头 - 每条映射单独一行
RewriteRule，按从长到短排序（避免/user匹配到/user/profile） - 加
[R=301,L]做跳转，或[L]做内部重写；别漏掉L，否则后续规则会干扰 - 路径开头不要写
/（.htaccess场景下，匹配的是相对 URI 路径）
示例（放在项目根目录 .htaccess 中）：
立即学习“PHP免费学习笔记（深入）”；
RewriteEngine On RewriteRule ^old-product/iphone-12\.html$ /product.php?id=1024 [L] RewriteRule ^old-product/samsung-s22\.html$ /product.php?id=1025 [L] RewriteRule ^blog/archive/2021/03/15\.html$ /article.php?slug=mar-2021-update [L]
更现实的解法：PHP 层接管映射逻辑
与其在 Apache 层硬塞几十条 RewriteRule，不如让 PHP 自己查表。这样既绕过 phpEnv 的限制，又便于维护和热更新：
- 准备一个 PHP 数组或 JSON 文件，存映射关系：
["/old-page" => "/new-page", ...] - 所有请求先落到
index.php（靠基础重写规则兜底） -
index.php开头就做$map = require 'rewrite-map.php'; $uri = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH); if (isset($map[$uri])) { header("Location: {$map[$uri]}", true, 301); exit; } - 注意：必须在输出任何内容前执行
header()，且$_SERVER['REQUEST_URI']在 phpEnv 下通常可靠
这个方式不依赖 Apache 模块，调试方便，还能加日志、缓存、正则匹配等扩展能力。
为什么别折腾编译新版 Apache
phpEnv 是为快速搭建本地 PHP 环境设计的，不是生产服务器。你手动编译带 RewriteMap 的 Apache：
- 得重新下载源码、装 dev 工具链、解决依赖冲突
- phpEnv 的 Apache 配置路径、模块路径、用户权限都和标准发行版不同，极易出错
- 升级 phpEnv 时你的自定义 Apache 会被覆盖，维护成本远高于收益
- 真实线上环境（如 Ubuntu +
a2enmod）天然支持RewriteMap，本地开发用 PHP 层模拟完全够用
真正需要 RewriteMap 的场景，比如百万级域名泛解析或实时外部 DB 查表，本就不该跑在 phpEnv 上——那已经是运维或部署阶段的事了。
