如何用本地服务器Apache对接Docker部署的PHP7/MySQL/Apache环境?
本地Apache对接Docker化PHP7/MySQL栈的实操配置方案
核心逻辑
无需重构现有Docker环境的PHP7、MySQL运行配置,直接摘除Docker栈内自带的Apache组件,让宿主机本地已运行的Apache通过FastCGI协议直连容器内的PHP-FPM服务,数据库连接走Docker映射到宿主机本地回环的固定端口即可实现对接。
第一步:调整Docker栈的组件配置
- 停止Docker部署栈中自带的Apache容器,不要直接删除,后续如果需要回滚可以直接启动
- 把Docker内的PHP7服务调整为独立的PHP-FPM运行模式,去掉原有配置中和Apache绑定的启动参数:
- 修改PHP-FPM的监听地址为
0.0.0.0:9000(默认只监听容器内回环地址,宿主机无法访问) - 把9000端口绑定映射到宿主机的
127.0.0.1地址,不要暴露到公网 - 重启PHP-FPM容器后,在宿主机本地验证9000端口连通性,确保无防火墙拦截
- 修改PHP-FPM的监听地址为
- 调整MySQL容器的端口映射规则,把3306端口绑定到宿主机的
127.0.0.1地址,不要对外网暴露;同步检查数据库账号的授权范围,确保允许来自宿主机本地回环地址的连接,避免项目报数据库连接权限错误
第二步:配置宿主机本地Apache的对接规则
- 启用Apache必需的两个核心模块:
- Debian/Ubuntu 系服务器执行
a2enmod proxy_fcgi setenvif - RHEL/CentOS 系服务器在
httpd.conf中移除proxy_fcgi_module、setenvif_module配置行的注释
- Debian/Ubuntu 系服务器执行
- 为项目新建独立的Apache虚拟主机配置,核心配置逻辑如下:
<VirtualHost *:80> ServerName 你的项目域名 DocumentRoot "/宿主机上挂载的项目代码绝对路径" # 所有PHP请求转发到Docker内的PHP-FPM服务 <FilesMatch \.php$> SetHandler "proxy:fcgi://127.0.0.1:9000" </FilesMatch> <Directory "/宿主机上挂载的项目代码绝对路径"> Options Indexes FollowSymLinks AllowOverride All Require all granted </Directory> </VirtualHost> - 关键校验点:如果原有Docker环境是直接挂载宿主机目录作为项目代码路径,必须保证Docker容器内看到的项目绝对路径,和上面Apache配置里写的项目路径完全一致;否则会触发PHP-FPM找不到脚本文件的报错。如果路径存在差异,需要在PHP-FPM配置中增加路径映射规则,把宿主机传来的脚本路径替换为容器内的实际路径。
常见问题排查
- 访问PHP页面报
No input file specified:优先排查宿主机和容器内的项目代码路径是否一致,再检查Apache运行用户对项目目录的读权限 - 宿主机无法连接PHP-FPM:检查9000端口的映射绑定地址、PHP-FPM的监听配置、本地防火墙的回环端口拦截规则
- 数据库连接失败:检查MySQL容器的3306端口绑定地址、数据库账号的授权范围,不要为了图方便把MySQL端口绑定到
0.0.0.0暴露到公网 - 文件上传/写入失败:对齐宿主机Apache运行用户、Docker内PHP-FPM运行用户对项目目录的权限,避免出现权限割裂导致的写操作失败
内容的提问来源于stack exchange,提问作者mushood badulla
相关产品推荐
相关产品推荐

