FrankenPHP容器间通过服务名通信的前提是共用同一Docker网络（如自定义bridge），而非默认bridge；需确保双方均加入该网络、目标容器已启动且监听0.0.0.0而非127.0.0.1，PHP代码中必须使用服务名（如mysql）而非localhost作为host。
容器间通过服务名通信的前提是共用 Docker 网络
FrankenPHP 容器要能用服务名（比如 mysql 或 redis）访问其他容器，它们必须处于同一个自定义 Docker 网络中。Docker 默认的 bridge 网络不支持服务名解析，docker-compose 自动创建的网络才支持 DNS 服务发现。
常见错误现象：getaddrinfo EAI_AGAIN mysql 或 Connection refused —— 很可能是因为 FrankenPHP 容器压根没和目标容器在同一个网络里，或者目标容器没启动成功。
- 用
docker-compose.yml编排时，所有服务默认在同一网络（如default），服务名就是service键的值（如mysql:→ 可用mysql访问） - 纯
docker run启动 FrankenPHP 时，必须显式加--network mynet，且目标容器也得加入同一网络（docker network connect mynet other-container） - 检查是否连通：进 FrankenPHP 容器执行
ping mysql或nc -zv mysql 3306；失败则先确认网络配置和目标容器状态
PHP 代码里用服务名当 host，别写 localhost 或 127.0.0.1
FrankenPHP 是 PHP 运行时，它跑的 PHP 脚本发起的网络请求（PDO、cURL、Redis 扩展等）走的是容器内网络栈，不是宿主机。所以连接 MySQL 时，host 必须填 mysql，而不是 localhost —— 后者会尝试连容器自己的 3306 端口，而那里根本没 MySQL。
示例（PDO 连接）：
立即学习“PHP免费学习笔记（深入）”；
$pdo = new PDO('mysql:host=mysql;dbname=test', 'user', 'pass');
-
host=mysql：解析为同网络下名为mysql的容器 IP -
host=localhost：解析为 127.0.0.1 → 连自己容器 → 失败 -
host=172.20.0.3：虽然能通，但硬编码 IP 不可靠（重启容器 IP 会变） - 如果目标服务监听非标准端口（如 PostgreSQL 在 5433），记得在 DSN 里显式写
port=5433
docker-compose.yml 中服务名大小写和依赖顺序不影响 DNS 解析
Docker 内置 DNS 不区分服务名大小写，也不要求 depends_on 控制启动顺序来保证 DNS 可用——DNS 记录只要容器启动并接入网络，就立刻可解析。但 depends_on 仍有必要，因为服务进程本身可能还没 ready（比如 MySQL 还在初始化）。
- 服务名写成
MySql或MYSQL，PHP 里仍可用小写mysql连（Docker DNS 统一转小写） -
depends_on只控制容器启动顺序，不等待应用就绪；真要等 DB ready，得在 FrankenPHP 启动脚本里加重试逻辑或用wait-for-it.sh - 若用
network_mode: "host"，容器直接用宿主机网络，服务名失效，只能用host.docker.internal（Linux 需额外参数启用）或宿主机 IP
调试 DNS 解析失败时优先查 /etc/resolv.conf 和 nslookup
FrankenPHP 容器里 curl http://mysql 失败，别急着改代码，先确认底层 DNS 是否工作。
- 进容器执行
cat /etc/resolv.conf：正常应含nameserver 127.0.0.11（Docker 内置 DNS） - 执行
nslookup mysql：看能否返回 IP；若超时，说明网络或服务名不对 - 检查
docker-compose ps输出：确认目标服务状态是Up，不是Exit或Restarting - FrankenPHP 镜像若基于 Alpine，
nslookup需装bind-tools；Debian/Ubuntu 基础镜像通常自带
localhost 当成“同 compose 文件里的其他服务”。DNS 解析是自动的，但前提是网络和容器都在线且命名正确。 
