独立服务器安装PHP环境及伪静态配置教程-php教程-PHP中文网

伪静态失败的根本原因是服务器未读取重写规则：apache需启用mod_rewrite、allowoverride all且.htaccess在根目录；nginx应弃用if改用try_files；iis须安装url rewrite模块并配置web.config。

独立服务器安装php环境及伪静态配置教程

mod_rewrite 模块必须启用，.htaccess 文件必须放在网站根目录且被 Apache 读取，Nginx 则必须用 try_files 替代 if 判断路径存在性——这三者任一缺失，伪静态就必然失败。

Apache 下 .htaccess 不生效的硬性条件

不是规则写错了，而是 Apache 根本没加载它。常见现象：访问 /user/123 直接 404，但 /index.php?u=123 能正常响应。

LoadModule rewrite_module modules/mod_rewrite.so 这一行在 httpd.conf 中不能带 # 注释
对应网站根目录的 <directory></directory> 区块里，必须同时包含：AllowOverride All 和 Require all granted（Apache 2.4+）
.htaccess 文件名必须严格为 .htaccess（Windows 资源管理器默认隐藏扩展名，建议用 VS Code 新建并另存为，编码选 UTF-8 无 BOM）
规则中若含 PATH_INFO（如 ThinkPHP），需改用 RewriteRule ^(.*)$ index.php [L,E=PATH_INFO:$1]，而非 index.php/$1

Nginx 中 if (!-e $request_filename) 是 Windows 下的雷区

该写法在 Windows 上极易因路径大小写、反斜杠处理或 $_SERVER['PATH_INFO'] 为空导致路由解析失败，表现为白屏或 404。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

root 必须指向框架的 public/ 目录，例如：root D:/www/myapp/public;，绝不能是项目根目录
禁用 if (!-e $request_filename) 块，改用标准 try_files：

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

确保 fastcgi_param SCRIPT_FILENAME 正确拼接：fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;

如果使用 ThinkPHP 或 Laravel，index.php 后面的参数应统一用 $query_string，避免手动拆解 s= 或 _url=

独立服务器上 Nginx 配置文件位置容易误改

phpEnv、宝塔、或手动编译的 Nginx，配置层级不同，改错文件等于白做。

phpEnv 用户：主配置在 C:\phpEnv\nginx\conf\nginx.conf，conf\vhost\ 下的文件默认不加载
宝塔用户：站点配置在 /www/server/panel/vhost/nginx/xxx.com.conf，不要去动 /www/server/nginx/conf/nginx.conf
源码编译用户：检查 nginx -t 输出的 `using configuration file` 路径，以该路径为准
所有修改后必须执行 nginx -t && nginx -s reload（或面板点「重载配置」），仅改文件不重启服务无效

IIS 必须装 URL Rewrite Module 才能识别 web.config

Windows Server 自带 IIS 默认不支持重写，.htaccess 放进去完全被忽略，连日志都不会报错。

从 IIS 官网下载并安装对应系统位数（x64/x86）的 URL Rewrite Module
安装后打开 IIS 管理器 → 选择站点 → 右侧打开「URL Rewrite」模块 → 点击「添加规则」
web.config 必须放在网站物理根目录，内容结构如下：

<configuration><system.webserver><rewrite><rules><rule name="Index" stopprocessing="true"><match url="^(.*)$"></match><conditions logicalgrouping="MatchAll"><add input="{REQUEST_FILENAME}" matchtype="IsFile" negate="true"></add><add input="{REQUEST_FILENAME}" matchtype="IsDirectory" negate="true"></add></conditions><action type="Rewrite" url="/index.php"></action></rule></rules></rewrite></system.webserver></configuration>

注意：IIS 的 web.config 不支持 Apache 风格的正则捕获变量（如 $1），需用 {R:1} 引用

真正卡住人的从来不是规则本身，而是服务器是否真的在读这条规则——nginx -t 看语法、httpd -t 验配置、IIS 管理器里确认模块已加载，这些动作比抄十遍规则都管用。