phpEnv是一款集成了PHP、MySQL、Nginx、Apache等组件的Windows本地开发环境工具，很多人在搭建ThinkPHP、Laravel或者WordPress站点时，都会遇到页面打不开、只有首页能访问的问题，这往往是因为没有正确配置伪静态规则。伪静态的本质是通过Web服务器的重写功能，把用户请求的URL在内部转发给入口文件处理，而浏览器地址栏依然显示简洁的路径。
一、认识phpEnv中的Web服务器切换
phpEnv默认允许你在Nginx和Apache之间一键切换，不同服务器处理伪静态的方式完全不同。Nginx使用自身的配置文件中的location和rewrite指令，而Apache则通常读取站点根目录下的.htaccess文件，并依赖mod_rewrite模块。在phpEnv面板中，你需要先确认当前站点用的是哪种服务，否则把Nginx规则写进.htaccess是没有任何作用的。
打开phpEnv主界面，进入“网站”管理，点击对应站点的“设置”或“配置文件”，就能看到当前服务类型。如果是Nginx，配置文件一般位于phpEnv安装目录下的nginx/conf/vhost中；如果是Apache，除了主配置外，最常见的是在项目根目录放一个.htaccess。理解这一点，是配置伪静态不走弯路的前提。
二、Nginx下的伪静态配置
在phpEnv里使用Nginx时，伪静态规则要写在站点的conf配置中。以ThinkPHP为例，所有请求都应重写到index.php入口。下面是一段典型的Nginx重写配置，你可以把它放在server块内部：
server {
listen 80;
server_name test.local;
root "D:/phpEnv/www/test";
index index.php index.html;
location / {
if (!-e $request_filename) {
rewrite ^(.*)$ /index.php?s=/$1 last;
}
}
location ~ .php$ {
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}
上面的规则中，if (!-e $request_filename)表示当请求的文件或目录不存在时，才进行重写，避免静态资源被错误转发。ThinkPHP支持通过s参数兼容模式接收路由，这样即使PATHINFO未开启也能运行。修改完配置后，在phpEnv中重启Nginx服务即可生效。
如果是WordPress，Nginx规则会更简单，主要把非文件和非目录的请求交给index.php：
location / {
try_files $uri $uri/ /index.php?$args;
}
使用try_files比rewrite效率更高，也不会产生循环重定向。需要注意的是，phpEnv的Nginx默认可能已带基础配置，你只需补充location /部分，不要重复定义server导致启动失败。
三、Apache下的伪静态配置
当phpEnv切换为Apache服务时，最方便的做法是在站点根目录创建.htaccess文件。Apache需要开启mod_rewrite模块，phpEnv集成的Apache通常已经编译该模块，但要在站点配置中允许.htaccess覆盖，即AllowOverride All。下面是ThinkPHP的.htaccess示例：
<IfModule mod_rewrite.c>
Options +FollowSymlinks -Multiviews
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]
</IfModule>
这段代码先判断模块存在，然后开启重写引擎。RewriteCond用于排除真实存在的目录和文件，RewriteRule把其余请求送到index.php后。和Nginx不同，Apache的规则对斜杠处理更敏感，如果ThinkPHP配置中关闭了PATHINFO，可以改成index.php?s=/$1的形式。
WordPress在Apache下的.htaccess则更为常见：
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^index.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
这里RewriteBase设定了相对根路径，若你的站点在子目录，需要改成/子目录名/。在phpEnv中，如果刷新后仍然显示404，请检查Apache的vhost配置里对应目录是否设置了AllowOverride All，否则.htaccess不会被执行。
四、常见错误与排查思路
很多人在phpEnv里配伪静态，最容易遇到403禁止访问或者首页正常内页404的情况。403往往是因为AllowOverride没开或文件权限问题；内页404大多是规则没匹配到入口文件。你可以先在地址栏直接访问index.php/模块/控制器，如果这样能打开，说明是重写规则没生效，而不是程序错误。
另一个隐形坑是循环重定向。比如Nginx中写了rewrite ^/(.*)$ /index.php/$1 permanent;却没判断文件是否存在，会导致浏览器报“重定向次数过多”。务必加上if (!-e $request_filename)或改用try_files。Apache里同理，忘记RewriteCond %{REQUEST_FILENAME} !-f也会陷入死循环。phpEnv面板的“日志”按钮能直接看Nginx或Apache的error日志，是定位重写故障的好帮手。
五、总结建议
在phpEnv中配置伪静态，核心是先定服务器类型，再放对位置：Nginx改vhost配置，Apache写.htaccess并开AllowOverride。不同框架规则略有差异，但逻辑都是“真实资源直接返回，其余请求交入口文件”。本地开发时建议先用简单规则验证，再逐步复杂化，配合phpEnv的日志功能，基本可以覆盖绝大多数伪静态配置场景。
phpEnv伪静态Nginx_Apache修改时间：2026-08-04 16:12:34