在phpEnv集成环境中部署多项目或者子目录项目时,二级目录的伪静态配置是很多开发者会遇到的痛点,默认的根目录伪静态规则无法直接套用在子目录场景,需要根据服务器类型和目录结构做针对性调整。

一、phpEnv中Nginx环境配置二级目录伪静态
1. 单个二级目录伪静态配置
假设我们的项目放在phpEnv的www目录下的blog子目录,需要为这个子目录配置伪静态规则,首先找到Nginx的站点配置文件,默认路径为phpEnv安装目录nginxconfvhostslocalhost_80.conf,在对应的server块中添加如下配置:
location /blog/ {
# 如果子目录是实际存在的目录,先尝试匹配实际文件
if (!-e $request_filename) {
# 重写规则,将请求转发到blog目录下的index.php处理
rewrite ^/blog/(.*)$ /blog/index.php/$1 last;
}
}
修改完成后重启phpEnv中的Nginx服务,规则即可生效。如果blog目录下有自己的.htaccess或者自定义伪静态规则,也可以把rewrite部分替换成对应的规则内容。
2. 多个二级目录共存配置
如果www目录下同时存在blog和shop两个子目录项目,需要分别配置对应的location块:
location /blog/ {
if (!-e $request_filename) {
rewrite ^/blog/(.*)$ /blog/index.php/$1 last;
}
}
location /shop/ {
if (!-e $request_filename) {
rewrite ^/shop/(.*)$ /shop/index.php/$1 last;
}
}
二、phpEnv中Apache环境配置二级目录伪静态
1. 启用Apache重写模块
首先确保phpEnv中的Apache已经启用了mod_rewrite模块,在phpEnv面板中点击Apache设置,勾选rewrite_module后重启Apache服务。
2. 子目录伪静态规则配置
在子目录项目下创建.htaccess文件,假设还是blog子目录,文件内容如下:
<IfModule mod_rewrite.c>
# 开启重写引擎
RewriteEngine On
# 设置重写基准目录
RewriteBase /blog/
# 如果请求的不是真实存在的文件或目录
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
# 重写规则,将请求转发给index.php处理
RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]
</IfModule>
如果需要全局配置,也可以修改Apache的虚拟主机配置文件,默认路径为phpEnv安装目录apacheconfextrahttpd-vhosts.conf,在对应的Directory块中添加AllowOverride All允许.htaccess规则生效:
<Directory "D:/phpEnv/www">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
三、常见配置问题排查
- 规则不生效:检查Nginx/Apache是否重启,规则路径是否和子目录实际路径匹配,注意Nginx中
location后面的路径需要带末尾斜杠。 - 404错误:确认子目录下的入口文件
index.php存在,伪静态规则中的转发路径是否正确。 - 参数丢失:重写规则中需要保留原始请求参数,Nginx的
last标记和Apache的QSA标记都可以自动携带查询参数,不需要额外拼接。
四、PHP项目端适配
伪静态配置完成后,还需要在PHP项目中调整入口文件的路径处理,避免资源路径和路由解析错误,以ThinkPHP框架为例,在config/app.php中设置子目录路径:
<?php
return [
// 应用根目录下的子目录名称
'app_dir' => 'blog',
// URL重写规则适配
'url' => [
'rewrite' => true,
'suffix' => 'html',
],
];
如果是原生PHP项目,可以在入口文件中获取请求路径后做对应的路由解析:
<?php
// 获取请求路径,去除子目录前缀
$request_uri = $_SERVER['REQUEST_URI'];
$sub_dir = '/blog';
$path = str_replace($sub_dir, '', $request_uri);
$path = trim($path, '/');
// 根据$path做路由分发
if (empty($path)) {
require 'home.php';
} else {
// 其他路由逻辑
}