Docker部署的Apache为何仅PHP文件的URL重写规则不生效
Docker环境下Apache仅.php后缀请求重写规则失效问题排查与解决
问题现象
部署在Docker容器中的Apache服务出现异常:仅针对.php后缀文件的请求重写规则失效,其余后缀类型文件的重写功能均正常工作。
当前使用的.htaccess配置如下:
RewriteEngine On RewriteBase / RewriteRule ^(.*)\.php$ index.php [L] RewriteRule ^(.*)\.html$ index.php [L] RewriteRule ^(.*)\.txt$ index.php [L] RewriteRule ^(.*)\.xml$ index.php [L]
按照上述配置,所有后缀为.php、.html、.txt、.xml的请求都应被重写至index.php,但实际运行效果为:仅.php后缀的请求会被直接访问对应目标文件,完全忽略重写配置。
现有配置清单
- Dockerfile:
ARG APACHE_VERSION="" FROM httpd:${APACHE_VERSION:+${APACHE_VERSION}-}alpine RUN apk update; \ apk upgrade; # Copy apache vhost file to proxy php requests to php-fpm container COPY project.apache.conf /usr/local/apache2/conf/demo.apache.conf RUN echo "Include /usr/local/apache2/conf/demo.apache.conf" \ >> /usr/local/apache2/conf/httpd.conf
- .env环境变量配置:
APACHE_VERSION=2.4 PROJECT_ROOT=./www
- docker-compose.yml配置:
version: "3.2" services: apache: build: context: './apache/' args: APACHE_VERSION: ${APACHE_VERSION} depends_on: - php - mysql networks: - frontend - backend ports: - "80:80" volumes: - ${PROJECT_ROOT}/:/var/www/html/ container_name: apache
- Apache虚拟主机配置:
ServerName localhost LoadModule deflate_module /usr/local/apache2/modules/mod_deflate.so LoadModule proxy_module /usr/local/apache2/modules/mod_proxy.so LoadModule proxy_fcgi_module /usr/local/apache2/modules/mod_proxy_fcgi.so LoadModule rewrite_module modules/mod_rewrite.so <VirtualHost *:80> # Proxy .php requests to port 9000 of the php-fpm container ProxyPassMatch ^/(.*\.php(/.*)?)$ fcgi://php:9000/var/www/html/$1 DocumentRoot /var/www/html/ <Directory /var/www/html/> DirectoryIndex index.php Options Indexes FollowSymLinks AllowOverride All Require all granted </Directory> # Send apache logs to stdout and stderr CustomLog /proc/self/fd/1 common ErrorLog /proc/self/fd/2 </VirtualHost>
问题根源
Apache的请求处理存在固定的阶段优先级,这是问题的核心原因:
- 请求抵达后,首先执行vhost配置中处于目录上下文处理阶段之前的规则,例如
ProxyPassMatch - 完成URL到文件系统的映射后,才会进入目录处理阶段,加载对应路径下的.htaccess文件,执行mod_rewrite的重写规则
当前配置中的ProxyPassMatch规则会在第一阶段直接匹配所有.php后缀的请求,直接转发至php-fpm容器处理,流程完全跳过后续的目录处理环节,因此.htaccess中针对.php的重写规则不会被触发。其余后缀的请求不匹配ProxyPassMatch规则,会正常进入目录处理流程加载重写规则,因此功能正常。
解决方案
调整规则执行顺序,让重写规则先于代理逻辑生效,步骤如下:
- 移除vhost配置中原有的全局
ProxyPassMatch ^/(.*\.php(/.*)?)$ fcgi://php:9000/var/www/html/$1规则 - 在
块中开启重写引擎,将.php请求的代理逻辑通过mod_rewrite的 [P]标记实现,确保目录下的.htaccess重写规则优先匹配。修改后的vhost相关配置如下:
<VirtualHost *:80> DocumentRoot /var/www/html/ # 开启重写引擎,将代理逻辑放在目录配置之后 RewriteEngine On <Directory /var/www/html/> DirectoryIndex index.php Options Indexes FollowSymLinks AllowOverride All Require all granted </Directory> # 对未被.htaccess重写规则匹配的.php请求,转发到php-fpm RewriteCond %{REQUEST_URI} ^/(.*\.php(/.*)?)$ RewriteRule ^(.*)$ fcgi://php:9000/var/www/html/$1 [P,L] # Send apache logs to stdout and stderr CustomLog /proc/self/fd/1 common ErrorLog /proc/self/fd/2 </VirtualHost>
- 重启Apache容器使配置生效,验证效果:此时所有.php请求会先进入目录处理阶段加载.htaccess规则,符合重写条件的请求会被重写至index.php,未被重写的.php请求会正常转发给php-fpm处理。
注意事项
- 不要将带
[P]标记的代理规则写在.htaccess中,需放在vhost的全局重写上下文中,避免路径映射的权限问题 - 确保mod_proxy、mod_proxy_fcgi、mod_rewrite模块已正常加载,否则代理或重写功能会失效
内容的提问来源于stack exchange,提问作者KarelRuzicka
相关产品推荐
相关产品推荐

