FrankenPHP怎么通过服务名访问另一个容器-php教程-PHP中文网

frankenphp容器间通过服务名通信的前提是共用同一docker网络（如自定义bridge），而非默认bridge；需确保双方均加入该网络、目标容器已启动且监听0.0.0.0而非127.0.0.1，php代码中必须使用服务名（如mysql）而非localhost作为host。

frankenphp怎么通过服务名访问另一个容器

容器间通过服务名通信的前提是共用 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。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

示例（PDO 连接）：

$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