导读:本期聚焦于小伙伴创作的《phpEnv环境下如何配置二级目录伪静态和子目录URL重写》,敬请观看详情,探索知识的价值。以下视频、文章将为您系统阐述其核心内容与价值。如果您觉得《phpEnv环境下如何配置二级目录伪静态和子目录URL重写》有用,将其分享出去将是对创作者最好的鼓励。

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

phpEnv环境下如何配置二级目录伪静态和子目录URL重写

一、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目录下同时存在blogshop两个子目录项目,需要分别配置对应的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 {
    // 其他路由逻辑
}

phpEnv伪静态URL重写二级目录子目录修改时间:2026-06-11 22:09:16

免责声明:​ 已尽一切努力确保本网站所含信息的准确性。网站内容多为原创整理与精心编撰,观点力求客观中立。本站旨在免费分享,内容仅供个人学习、研究或参考使用。若引用了第三方作品,版权归原作者所有。如内容涉及您的权益,请联系我们处理。
内容垂直聚焦
专注技术核心技术栏目,确保每篇文章深度聚焦于实用技能。从代码技巧到架构设计,为用户提供无干扰的纯技术知识沉淀,精准满足专业提升需求。
知识结构清晰
覆盖从开发到部署的全链路。AI、前端、编程、数据库、服务器、建站、系统层层递进,构建清晰学习路径,帮助用户系统化掌握开发与运维所需的核心技术。
深度技术解析
拒绝泛泛而谈,深入技术细节与实践难点。无论是数据库优化还是服务器配置,均结合真实场景与代码示例进行剖析,致力于提供可直接应用于工作的解决方案。
专业领域覆盖
精准对应开发生命周期。从前端界面到后端编程,从数据库操作到服务器运维,形成完整闭环,一站式满足全栈工程师和运维人员的技术需求。
即学即用高效
内容强调实操性,步骤清晰、代码完整。用户可根据教程直接复现和应用于自身项目,显著缩短从学习到实践的距离,快速解决开发中的具体问题。
持续更新保障
专注既定技术方向进行长期、稳定的内容输出。确保各栏目技术文章持续更新迭代,紧跟主流技术发展趋势,为用户提供经久不衰的学习价值。