phpEnv中Apache的rewrite模块默认未真实加载，需手动验证并启用：执行httpd -M | grep rewrite，若无输出则需取消httpd.conf中LoadModule rewrite_module modules/mod_rewrite.so的注释，重启Apache；同时确保站点vhost配置中<Directory>块内AllowOverride All且权限正确，.htaccess文件置于根目录并用命令行创建。
phpEnv 中 Apache 的 rewrite 模块是否真正加载？
phpEnv 默认安装的 Apache 通常不启用 mod_rewrite，仅靠面板界面勾选“rewrite 模块”不会写入运行配置——它只是个 UI 标记。必须验证模块是否在进程里真实加载。
打开终端，执行：
httpd -M | grep rewrite若输出为
rewrite_module (shared)，说明已加载；若无任何输出，说明模块未生效。
此时需手动编辑 Apache 主配置文件：
路径通常是 C:\phpenv\apache\conf\httpd.conf（Windows）或 /usr/local/phpenv/apache/conf/httpd.conf（macOS/Linux）
找到并取消注释这一行：
LoadModule rewrite_module modules/mod_rewrite.so注意：不能有多个重复的
LoadModule rewrite_module 行，否则启动失败。
改完后必须重启 Apache：httpd -k restart（Windows）或 sudo /usr/local/phpenv/apache/bin/apachectl restart（macOS/Linux）
仅重载（-k graceful 或 reload）不触发模块重载，无效。
立即学习“PHP免费学习笔记（深入）”；
phpEnv 站点配置里 AllowOverride 是不是 All？
phpEnv 的每个站点默认使用独立虚拟主机配置，但它的 Apache 配置模板往往把 AllowOverride 设为 None，这是 .htaccess 失效最常见原因——Apache 直接跳过读取该文件，连语法错误都不会报。
找到对应站点的配置文件，路径类似：C:\phpenv\apache\conf\vhost\your-site.conf（Windows）/usr/local/phpenv/apache/conf/vhost/your-site.conf（macOS/Linux）
在 <Directory "C:/phpenv/www/your-site"> 块内确认存在且仅有一处：AllowOverride All
不是 FileInfo、AuthConfig，也不是 None；大小写敏感，不能写成 allowoverride all（Apache 2.4+ 要求首字母大写）。
如果整个 <Directory> 块缺失，不能只加一行 AllowOverride All，必须补全完整结构，例如：
<Directory "C:/phpenv/www/your-site"><br> AllowOverride All<br> Require all granted<br></Directory>否则
httpd -t 会提示语法错误，Apache 启动失败。
对设计或页面进行 WCAG 2.1 AA 无障碍审计。触发关键词：“audit accessibility”、 “check a11y”、 “is this accessible?” 或在审查设计时使用。
.htaccess 文件本身有没有被 phpEnv 的路径或权限拦住？
phpEnv 在 Windows 下常因文件系统限制导致 .htaccess 创建失败；在 macOS/Linux 下则可能因用户权限或 SELinux 导致 Apache（运行用户通常是 daemon 或 _www）无法读取该文件。
创建方式要严格：
• 不要用记事本直接“新建文本文档.txt”再改名——容易残留空格或编码问题
• 推荐用命令行：echo "RewriteEngine On" > .htaccess（Linux/macOS）echo RewriteEngine On > .htaccess（Windows CMD）
• 文件必须放在网站根目录（即 DocumentRoot 指向的路径），不能放在子目录下期望它向上生效
检查权限：
• Windows：右键 → 属性 → 安全 → 确保 IUSR 或 Everyone 有“读取”权限
• macOS/Linux：ls -l .htaccess 应显示权限类似 -rw-r--r--，且所属用户与 Apache 进程用户一致（如 daemon:daemon）
• 若 phpEnv 启用了“防跨站”，需确认站点根目录用户与 Apache 运行用户完全匹配，否则直接拒绝加载 .htaccess
验证是否被识别的最快方法：
在 .htaccess 中写：
RewriteEngine On<br>RewriteRule ^test$ /index.php [R=302,L]访问
http://localhost/test，看是否 302 跳转；不跳转就说明文件根本没被读到。
rewrite 规则在 phpEnv 下为什么“没报错却没反应”？
Apache 对 .htaccess 中的规则错误极其宽容：正则漏转义、RewriteCond 和 RewriteRule 顺序错位、%{REQUEST_URI} 误用，多数时候只是静默跳过，浏览器返回 404 或原页面，日志里也无痕迹。
调试建议：
• 先禁用所有条件，只留一条最简规则测试引擎是否工作
• RewriteCond 必须紧贴其后的 RewriteRule，中间不能插其他指令（包括注释）
• %{REQUEST_URI} 值始终以 / 开头（如 /article/123），而 ^ 匹配的是路径开头，不要写成 ^/article/(\d+) —— 正确是 ^article/(\d+)
• ThinkPHP/Laravel 类框架常用 [L,E=PATH_INFO:$1]，但 phpEnv 的 Apache 版本若低于 2.4.10，E= 可能不支持，可先试 [L,QSA]
Apache 2.4+ 已废弃 RewriteLog，改用错误日志追踪：
在站点配置中添加：
LogLevel alert rewrite:trace3然后查
logs/error_log，搜索 rewrite. 关键字，能看到每条规则是否匹配、是否被跳过、哪一步终止。
最易被忽略的一点：phpEnv 的 Apache 默认不监听 80 端口，而是用 8080 或自定义端口；你写的规则里若硬编码了 http://localhost/，而实际访问的是 http://localhost:8080/，重定向头可能被浏览器拦截或失效——所有规则应基于相对路径设计，避免协议+域名+端口拼接。
