本地Apache下WordPress .htaccess失效，URL带index.php问题排查

1. 确认mod_rewrite模块已启用 #

由于你通过MacPorts安装了PHP，需先验证Apache的mod_rewrite是否正常加载：

• 打开终端，执行命令：

  sudo apachectl -M | grep rewrite
  

• 若输出 rewrite_module (shared)，说明模块已启用；若无输出，需手动启用：
  1. 打开MacPorts Apache的配置文件（路径通常为 /opt/local/apache2/conf/httpd.conf）
  2. 找到行 #LoadModule rewrite_module libexec/apache2/mod_rewrite.so，删除开头的#注释
  3. 重启Apache：

     sudo apachectl restart
     

2. 配置Apache允许.htaccess生效 #

Apache默认可能限制了.htaccess的权限，需修改目录配置：

• 编辑httpd.conf或对应虚拟主机配置文件，找到你的WordPress根目录对应的<Directory>块，将AllowOverride None改为AllowOverride All，示例：

  <Directory "/Users/yourname/Sites/wordpress">
      AllowOverride All
      Require all granted
  </Directory>
  

• 重启Apache使配置生效：

  sudo apachectl restart
  

3. 适配.htaccess与WordPress固定链接设置 #

• 先备份当前的.htaccess文件，然后进入WordPress后台：设置 → 固定链接，选择「文章名称」或自定义结构（如/%postname%/），点击「保存更改」。WordPress会自动生成适配的.htaccess规则，若生成失败，可手动替换为以下内容（注意适配你的站点根目录）：

  <IfModule mod_rewrite.c>
  RewriteEngine On
  RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
  RewriteBase /
  RewriteRule ^index\.php$ - [L]
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteRule . /index.php [L]
  </IfModule>
  

• 确保.htaccess文件的权限正确，Apache用户拥有读写权限（可执行命令 sudo chmod 644 /path/to/wordpress/.htaccess）

4. 检查WordPress站点URL配置 #

进入WordPress后台设置 → 常规，确认：

• 「WordPress地址（URL）」和「站点地址（URL）」均为 http://localhost:5000，无index.php后缀
• 若之前有后缀，修改后点击「保存更改」

5. 验证重写规则是否生效 #

可添加测试规则验证：

• 在.htaccess中添加一行：

  RewriteRule ^test-url$ /index.php?test=1 [L]
  

• 访问 http://localhost:5000/test-url，若能正常加载站点，且通过var_dump($_GET['test'])（可临时添加到主题header.php中）能看到输出string(1) "1"，说明重写规则生效；若无法访问，需回到前面步骤检查Apache配置。

6. 确认Apache关联的是MacPorts安装的PHP #

由于刚更新了PHP，需确保Apache加载的是MacPorts的PHP模块：

• 打开httpd.conf，找到PHP模块加载行，示例（根据你的PHP版本调整）：

  LoadModule php82_module /opt/local/lib/apache2/modules/libphp82.so
  

• 确认路径正确，若不是MacPorts的路径，修改后重启Apache。

内容的提问来源于stack exchange，提问作者newbiedev