伪静态需严格匹配服务器逻辑:Apache须启用mod_rewrite、AllowOverride All并正确放置.htaccess;Nginx需将rewrite置于location /内,配合try_files及正确fastcgi_param传递参数。

伪静态不是加个规则就完事——Apache 和 Nginx 的处理逻辑完全不同,直接套用对方的规则,90% 会 404 或跳首页。
Apache 为什么 .htaccess 不生效
常见现象是:明明写了 RewriteRule,刷新页面还是带 index.php,或直接 500。根本原因不是规则写错,而是 Apache 拒绝读取它。
-
mod_rewrite.so必须启用:检查httpd.conf中LoadModule rewrite_module modules/mod_rewrite.so是否取消注释 -
AllowOverride None必须改成AllowOverride All:这个设置在httpd.conf多处出现(尤其是<Directory "”/path/to/your/site"”>块内),漏改一处就无效 -
.htaccess必须放在项目根目录(不是public/,除非你把DocumentRoot指向了那里);Windows 下用记事本保存时要选“所有文件”并手动输入文件名,避免变成.htaccess.txt - ThinkPHP/Laravel 等框架自带的
.htaccess通常只适配根目录部署;若部署在子目录(如/blog/),需补上RewriteBase /blog/
Nginx 的 if(!-e $request_filename) 为什么有时失效
这个“万能兜底”规则看似简单,但实际运行中常因位置、上下文或 PHP 配置不匹配而失败——比如路由进来了,$_SERVER['PATH_INFO'] 却为空,导致框架收不到路径参数。
- 规则必须放在
location / { }块内,不能只丢在server块末尾(宝塔「伪静态」框里粘贴的内容就是这么加载的,但仅限简单场景) - PHP 处理块(
location ~ \.php$)必须包含try_files $uri =404;或显式 fallback,否则 Nginx 会尝试直接找物理.php文件,找不到就 404,根本不会触发 rewrite - ThinkPHP 6+ 依赖
s=参数传路由,所以推荐用:try_files $uri $uri/ /index.php?s=$uri&$args;,而不是老式的if (!-e ...) - 如果用了
alias而非root,$document_root可能为空,导致SCRIPT_FILENAME拼接错误——此时应改用alias对应的绝对路径
rewrite flag 用 last 还是 break?
选错 flag 会导致重定向循环、参数丢失或 URL 暴露,不是语法问题,而是语义理解偏差。
立即学习“PHP免费学习笔记(深入)”;
-
last:内部重写后,Nginx 会用新 URI 重新匹配location块——这是伪静态必需的行为,确保请求最终落到location ~ \.php$去执行 -
break:停止 rewrite,也不重新匹配,适合纯路径替换(如rewrite ^/old /new break;),但绝不适用于兜底到index.php -
redirect/permanent:返回 HTTP 跳转,浏览器地址栏会变,容易引发循环(比如 WordPress 后台设置里「站点地址」和「WordPress 地址」不一致时) - 别在
location ~ \.php$里写rewrite+last:这会造成无限重入,Nginx 日志里会出现rewrite or internal redirection cycle
最易被忽略的一点:伪静态生效 ≠ 路由可用。即使 URL 看起来干净了,如果 PHP 没收到正确参数($_GET、$_SERVER['PATH_INFO'] 或 $_SERVER['QUERY_STRING'] 缺失),程序照样 404。务必检查 Nginx 的 fastcgi_param 传递是否完整,尤其是 QUERY_STRING 和 SCRIPT_NAME,少一个就断链。



















