写给愿意动手的 PHP 开发者
PHP学习网 PHP学习网
公告PHP学习网为公益性网站,致力于为广大PHP爱好者服务
首页/ phpstudy 专区/ 伪静态配置:Apache 与 Nginx 两套写法
配置 进阶 PHP 全版本

伪静态配置:Apache 与 Nginx 两套写法

伪静态到底改了什么、Apache 的 .htaccess 怎么写、Nginx 的 try_files 怎么配、常见框架规则与调试方法。

伪静态的作用是把 /article/12 这种「看起来是静态」的地址,转给 index.php 处理。它不改文件,只改服务器转发规则。

Apache:.htaccess

Apache 需要开启 mod_rewrite,并允许目录级重写(AllowOverride All)。在站点根目录建 .htaccess:

APACHE
<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteBase /
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule ^(.*)$ index.php [QSA,L]
</IfModule>

两句 RewriteCond 的意思是:文件不存在、目录也不存在时,才转发给 index.php。存在的静态资源直接返回,不走 PHP。

Nginx:try_files

Nginx 不读 .htaccess,规则要写在站点配置里:

NGINX
location / {
    try_files $uri $uri/ /index.php?$query_string;
}

phpstudy 面板的「伪静态」输入框就是往 vhost 里插这段。选框架模板(ThinkPHP、Laravel)时它会自动填好。

常见坑

  • 规则写对了但仍然 404:检查 Nginx 的 location 匹配顺序,^~ 和正则 location 可能先命中。
  • 后台页面正常、前台 404:通常是伪静态只配了部分路径,或者入口文件不在根目录。
  • 带 index.php 能访问、不带就 404:说明重写规则没生效,先确认模块是否开启。

调试方法:看 Nginx 的 error.log,里面会写「rewrite or internal redirection cycle」这类具体原因。

一句话判断:访问一个不存在的路径,如果返回的是你的 404 页面,说明伪静态生效了;如果返回 Nginx 默认的 404,说明规则没生效。

继续看