PHP本地环境开启伪静态设置步骤

本文详解了在本地PHP开发环境中（如XAMPP、WampServer）启用Apache伪静态功能的关键步骤，重点强调必须先确认并启用mod_rewrite模块——通过取消httpd.conf中LoadModule rewrite_module行的注释，否则.htaccess规则将完全失效；内容直击开发者常见痛点，操作清晰、定位精准，助你快速打通URL美化与SEO优化的第一道技术关卡。

Apache + mod_rewrite 能否启用

本地 PHP 环境是否支持伪静态，第一关是看 mod_rewrite 模块有没有加载。很多一键环境（如 XAMPP、WampServer）默认不启用它，导致 .htaccess 文件完全被忽略。

• 打开 Apache 配置文件 httpd.conf（路径通常在 XAMPP\apache\conf\httpd.conf 或 Wamp\bin\apache\apache{version}\conf\httpd.conf）
• 搜索 LoadModule rewrite_module，确保该行未被注释（即前面没有 #）
• 再搜索 ，找到你项目所在的目录段（比如 ），确认其中包含这两行：

  AllowOverride All
  Require all granted

  （旧版 Apache 2.2 是 Order Allow,Deny + Allow from all）
• 重启 Apache，用 phpinfo() 页面检查 Loaded Modules 是否含 mod_rewrite

.htaccess 文件写法与常见失效原因

即使模块开了，.htaccess 仍可能不生效——最常踩的坑是规则语法错误或匹配逻辑没对上。

• 规则必须放在网站根目录（或子目录）下，且文件名严格为 .htaccess（注意开头的点，Windows 资源管理器可能隐藏扩展名，建议用编辑器另存为）
• 基础重写示例（将 /article/123 映射到 /index.php?id=123）：

  RewriteEngine On
  RewriteBase /
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteRule ^article/(\d+)$ index.php?id=$1 [L]

• RewriteBase 很关键：如果项目不在 Apache 根目录（比如放在 localhost/myapp/），这里要改成 RewriteBase /myapp/，否则重写路径会错位
• 测试时清空浏览器缓存，或用隐身窗口访问，避免 304 缓存干扰判断

PHP 内置服务器不支持 .htaccess

如果你用的是 php -S localhost:8000 启动的内置服务器，那直接放弃 .htaccess ——它压根不读这个文件，也不支持 mod_rewrite。

• 替代方案只有两种：
  – 改用 Apache 或 Nginx 本地环境
  – 在 PHP 路由层手动解析 URL（例如读取 $_SERVER['REQUEST_URI']，自行分发请求）
• 简单模拟伪静态路由示例：

  <?php $uri = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
  if (preg_match('#^/article/(\d+)$#', $uri, $matches)) {
      $_GET['id'] = $matches[1];
      include 'article.php';
      exit;
  }
  // 其他规则...
  ?>

• 这种写法无法替代完整重写功能（比如重定向、条件跳转、隐藏真实路径等），仅适合开发阶段快速验证逻辑

Windows 下 Apache 的额外陷阱

在 Windows 上配伪静态，有两个隐蔽但高频的问题：

• .htaccess 文件权限：Apache 进程需有读取权限。若用管理员权限启动 Apache 但文件属主是普通用户，有时会静默失败。建议右键文件 → 属性 → 安全 → 给 Everyone 或 Users 组添加“读取”权限
• URL 中含中文或特殊字符时，Apache 默认拒绝处理（报 404 或 400）。可在 httpd.conf 中添加：

  AllowEncodedSlashes On
  

  并重启服务
• 某些杀毒软件（如 360、火绒）会拦截 Apache 对 .htaccess 的读取，临时关闭试试

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHP本地环境开启伪静态设置步骤》文章吧，也可关注golang学习网公众号了解相关技术文章。