在现代php项目开发中，利用.htaccess文件进行url重写是实现“漂亮url”（pretty urls）的常见做法，这有助于提升用户体验和搜索引擎优化。然而，许多开发者在本地开发环境（如xampp、wamp）中功能正常，但部署到远程apache服务器时却遭遇“file not found”错误，尤其当项目结构包含一个前端控制器（如public/index.php）和用于路由的.htaccess规则时。这通常是由于apache服务器的默认安全配置限制了.htaccess文件的解析能力或未启用必要的模块。
常见项目结构与.htaccess示例
一个典型的PHP项目可能采用如下结构：
- /app：包含所有应用程序逻辑。
- /public：包含公共资源（图片、CSS、JS）和前端控制器index.php。
- 根目录下的.htaccess文件：用于将所有请求重写到public/index.php。
例如，一个.htaccess文件可能包含以下规则：
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule (.*) public/index.php/$1 [L]这条规则的含义是：
- RewriteEngine On：启用重写引擎。
- RewriteCond %{REQUEST_FILENAME} !-f：如果请求的文件路径不是一个实际存在的文件，则执行下一条规则。
- RewriteRule (.*) public/index.php/$1 [L]：将所有不指向实际文件的请求重写到public/index.php，并将原始请求路径作为参数传递。
当这些规则在部署后失效时，通常需要检查Apache的两个关键配置。
立即学习“PHP免费学习笔记（深入）”；
核心配置一：启用.htaccess解析（AllowOverride All）
Apache服务器默认出于安全考虑，可能不会允许.htaccess文件中的所有指令覆盖主配置文件中的设置。要使.htaccess文件中的RewriteRule等指令生效，您需要明确地在Apache的虚拟主机配置中允许这种覆盖。
定位虚拟主机配置文件： 通常，您的网站或子域名的配置文件位于/etc/apache2/sites-available/目录下（Debian/Ubuntu系统）或/etc/httpd/conf.d/目录下（CentOS/RHEL系统）。文件命名可能类似于yourdomain.com.conf或dev.example.org.conf。如果您使用Plesk等面板，可能需要通过面板界面或查找Plesk生成的配置文件。
-
修改<Directory>指令： 在您的虚拟主机配置文件中，找到与您的项目根目录或public目录对应的<Directory>块。在该块内，确保存在AllowOverride All指令。如果不存在，请添加；如果为AllowOverride None，请修改为All。
示例配置片段：
<VirtualHost *:80> ServerName dev.example.org DocumentRoot /var/www/vhosts/dev.example.org/httpdocs # 您的项目根目录 <Directory /var/www/vhosts/dev.example.org/httpdocs> Options Indexes FollowSymLinks AllowOverride All # 确保此行存在并设置为All Require all granted </Directory> # 如果您的DocumentRoot直接指向public目录，则Directory路径可能有所不同 # <Directory /var/www/vhosts/dev.example.org/httpdocs/public> # AllowOverride All # </Directory> ErrorLog ${APACHE_LOG_DIR}/dev.example.org_error.log CustomLog ${APACHE_LOG_DIR}/dev.example.org_access.log combined </VirtualHost>注意事项： AllowOverride All允许.htaccess文件覆盖所有类型的Apache配置指令。在生产环境中，出于安全考虑，有时会使用更具体的选项，如AllowOverride FileInfo（仅允许与文件类型和重写相关的指令）。但对于解决URL重写问题，All是最直接有效的方式。
核心配置二：激活mod_rewrite模块
mod_rewrite是Apache用于URL重写的核心模块。如果此模块未启用，.htaccess文件中的RewriteEngine和RewriteRule指令将无法工作。
-
检查mod_rewrite状态： 您可以通过命令行工具检查当前Apache服务器已加载的模块。
apachectl -M | sort
或者
a2query -m rewrite
如果mod_rewrite已启用，您会在输出中看到rewrite_module (shared)或类似信息。
-
启用mod_rewrite模块： 如果mod_rewrite未启用，您可以使用以下命令来启用它（适用于Debian/Ubuntu系统）：
sudo a2enmod rewrite
对于CentOS/RHEL系统，通常需要编辑httpd.conf文件，找到#LoadModule rewrite_module modules/mod_rewrite.so这一行，去除开头的#注释符。
-
重启Apache服务： 在进行上述任何配置更改后，无论是修改虚拟主机配置还是启用模块，都必须重启Apache服务以使更改生效。
sudo systemctl restart apache2 # Debian/Ubuntu sudo systemctl restart httpd # CentOS/RHEL
或
sudo service apache2 restart # 旧版Debian/Ubuntu sudo service httpd restart # 旧版CentOS/RHEL
部署后验证与注意事项
完成上述两个核心配置后，您的PHP项目应该能够正确解析.htaccess中的URL重写规则。
验证URL：尝试访问您的项目URL，例如http://dev.example.org/some/page，确保它不再显示“File not found”错误，而是由public/index.php正确处理。
检查Apache错误日志：如果问题依然存在，请检查Apache的错误日志文件（通常在/var/log/apache2/error.log或/var/log/httpd/error_log），其中可能包含有关配置错误或权限问题的详细信息。
-
RewriteBase指令：如果您的项目部署在子目录而非域名的根目录，例如http://dev.example.org/myproject/，您可能需要在.htaccess文件中添加RewriteBase指令：
RewriteEngine On RewriteBase /myproject/ # 根据您的子目录路径进行调整 RewriteCond %{REQUEST_FILENAME} !-f RewriteRule (.*) public/index.php/$1 [L]这确保了重写规则在子目录环境中也能正确解析路径。
总结
解决PHP项目部署中.htaccess URL重写失败的问题，关键在于理解Apache服务器的配置要求。通过确保在虚拟主机配置中设置AllowOverride All以允许.htaccess文件覆盖主配置，以及激活mod_rewrite模块来启用URL重写功能，您可以有效地解决“File not found”错误，并使您的漂亮URL在生产环境中正常工作。务必在每次配置更改后重启Apache服务，并利用错误日志进行故障排查。
