PHP链接嵌入失败？伪静态配置解决方法

一、检查并修正 Apache 的 .htaccess 重写规则

Apache 环境下伪静态依赖 .htaccess 文件与 mod_rewrite 模块协同工作。若嵌入的 PHP 链接仍含 ?id= 参数但期望访问的是 /article/123 这类路径，则需确保重写规则能正确捕获并转发请求至实际处理脚本。

1、确认 Apache 已启用 rewrite_module：通过命令 a2enmod rewrite 启用，并重启服务。

2、在网站根目录创建或编辑 .htaccess 文件，写入以下兼容性更强的规则：

3、

4、RewriteEngine On

5、RewriteBase /

6、RewriteCond %{REQUEST_FILENAME} !-f

7、RewriteCond %{REQUEST_FILENAME} !-d

8、RewriteRule ^article/([0-9]+)$ index.php?article_id=$1 [L,QSA]

9、

10、保存文件后，确保文件权限为 644 且位于网站根目录下。

二、调整 Nginx server 块中的 try_files + rewrite 组合

Nginx 不支持 .htaccess，所有规则必须写入站点配置文件。若网页嵌入链接为 /article/123 却返回 404，说明请求未被正确代理至 PHP 入口文件。

1、打开对应站点的 Nginx 配置文件（如 /etc/nginx/sites-enabled/your-site）。

2、定位到 location / { ... } 块，替换为以下结构：

3、location / {

4、  try_files $uri $uri/ /index.php?$args;

5、}

6、另添加专用路径匹配规则（可选，用于显式路由）：

7、location ^~ /article/ {

8、  rewrite ^/article/([0-9]+)$ /index.php?article_id=$1 last;

9、}

10、执行 sudo nginx -t && sudo systemctl reload nginx 验证并重载配置。注意：Nginx 中的 last 表示内部重写，浏览器地址栏不会改变。

三、同步修改前端 HTML 中的链接生成逻辑

伪静态生效的前提是前端输出的链接格式与重写规则完全一致。若 PHP 页面内仍使用 article.php?id=123 形式嵌入链接，即使服务器配置正确，用户点击后也会绕过伪静态规则直接请求物理文件，导致失败或暴露真实路径。

2、若使用 PHP 动态拼接，统一改用函数封装：

3、function buildArticleUrl($id) { return '/article/' . (int)$id; }

5、禁止在 a 标签 href 中保留 .php 扩展名或 query string 参数（如 ?id=）。

四、验证 PHP 入口文件对伪静态路径的参数解析能力

服务器将 /article/123 重写为 index.php?article_id=123 后，PHP 脚本必须能从 $_GET 或原始路径中正确提取参数。若未做适配，将无法获取 ID 并查询数据。

1、在 index.php 开头添加路径解析逻辑：

2、$path = $_SERVER['REQUEST_URI'] ?? '';

3、$path = parse_url($path, PHP_URL_PATH);

4、$segments = array_filter(explode('/', trim($path, '/')));

5、if (isset($segments[0]) && $segments[0] === 'article' && isset($segments[1])) {

6、  $article_id = (int)$segments[1];

7、  $_GET['article_id'] = $article_id;

8、}

9、后续业务代码即可继续使用 $_GET['article_id'] 获取值。此方式不依赖 query string，可应对无 ? 的纯路径重写场景。

五、启用 IIS URL 重写模块并导入规则

Windows 主机运行 IIS 时，需通过图形化管理器或 web.config 文件配置重写规则。若嵌入链接为 /article/123 但返回 HTTP 404.0 错误，表明 IIS 未识别该路径为合法请求。

1、打开 IIS 管理器，选择目标站点，双击“URL 重写”。

2、点击右侧“导入规则”，粘贴以下 XML 规则：

3、

4、  

5、  

6、

7、点击“应用”保存，确保 IIS 中已安装并启用“URL 重写”模块（非默认安装）。

本篇关于《PHP链接嵌入失败？伪静态配置解决方法》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！