Docker Compose部署PHP+MySQL+Redis生产环境-php教程-PHP中文网

docker compose本身不适用于高可用生产环境，缺乏服务发现、滚动更新等能力；小项目或过渡期可使用，但须规避mysql认证失败、redis网络不通、nginx 502、php配置不生效等常见陷阱。

docker compose部署php+mysql+redis生产环境

直接上生产环境？别急——docker-compose 本身不是为高可用生产编排设计的，它缺服务发现、滚动更新、跨主机调度和健康自动恢复能力。真要上生产，得先确认你是否在用 Swarm 或 Kubernetes；如果只是小项目、内部系统、或过渡期环境，那 docker-compose 可以用，但必须绕开几个关键陷阱。

mysql 容器启动失败：挂载配置后连不上

常见现象是容器反复重启，docker-compose logs mysql 显示 mysqld: Can't read dir of '/etc/mysql/conf.d/' 或 Unknown variable 'default_authentication_plugin'。

MySQL 8.0+ 默认用 caching_sha2_password 插件，老 PHP 客户端（如 mysqli 扩展未升级）会认证失败，加 default_authentication_plugin=mysql_native_password 到 my.cnf 的 [mysqld] 段
挂载 conf.d/ 目录时，确保宿主机该目录非空且权限为 644，否则 MySQL 启动时因读取失败静默退出
不要把 data 卷挂载到一个已存在且非空的宿主机目录——MySQL 会拒绝初始化，改用干净目录或删掉旧数据再试

php-fpm 无法连接 redis：host 名字写错或端口没暴露

PHP 报错 Connection refused 或 php_network_getaddresses: getaddrinfo failed，基本是网络层不通。

PHP 8.5.5

PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。

下载

redis 服务名必须和 docker-compose.yml 中 services 下一级 key 完全一致（比如写成 redis-server，代码里就得用 redis-server，不能写 redis）
Redis 容器默认只监听 127.0.0.1，必须在 redis.conf 里显式设 bind 0.0.0.0 并关掉 protected-mode yes（生产环境需配密码 + 网络隔离）
如果用了 ports 暴露 6379，PHP 代码里仍应连 redis:6379（走 Docker 内网），而不是 localhost:6379（会连宿主机）

nginx 报 502 Bad Gateway：php-fpm socket 路径或权限不匹配

这是最常卡住的点——Nginx 和 PHP-FPM 在两个容器里，不能靠 Unix socket 文件直连，必须走 TCP。

PHP-FPM 配置里禁用 listen = /run/php/php-fpm.sock，改用 listen = 9000（或自定义端口），并设 listen.allowed_clients = 0.0.0.0/0
Nginx 的 fastcgi_pass 改成 php-fpm:9000（注意 service 名 + 冒号 + 端口），别写 127.0.0.1:9000
检查 PHP-FPM 的 www.conf 是否有 user = www-data，而 Nginx 容器里也得用同 UID 用户运行，否则日志里可能看不到错误，只报 502

volume 挂载后 php.ini 不生效：路径和加载顺序搞错了

改了 php.ini 但 phpinfo() 里看不到效果，大概率是文件没被加载，或被后加载的配置覆盖。

PHP 官方镜像默认从 /usr/local/etc/php/conf.d/ 加载 .ini 文件，把你的 php.ini 放进去并重命名为 99-custom.ini（前缀数字保证最后加载）
不要挂载整个 /usr/local/etc/php/，否则会覆盖 conf.d/ 下的扩展启用文件（如 docker-php-ext-enable 生成的）
挂载后进容器执行 php --ini 看实际加载路径，再用 php -m | grep redis 确认扩展是否真启用了