本文探讨symfony应用在本地运行，而数据库运行在docker容器中时，因主机名无法解析导致的数据库连接问题。主要解决方案包括修改本地`hosts`文件映射容器ip，或将symfony应用也容器化以实现统一网络环境。文章将详细指导如何识别问题并实施两种解决方案，以确保symfony应用能正确连接到docker化的postgresql数据库。
在现代Web开发中，将应用程序与数据库分离部署，尤其是利用Docker容器化技术管理数据库服务，已成为常见实践。然而，当Symfony应用程序在本地主机上运行，而其依赖的PostgreSQL数据库运行在Docker Compose管理的容器中时，可能会遇到一个常见的连接问题：本地应用程序无法解析Docker内部的主机名。
当尝试在本地Symfony应用程序中执行如 php bin/console doctrine:fixture:load 等需要数据库连接的命令时，如果数据库配置中的主机名指向Docker容器内部的服务名（例如 my_els_db_postgres），可能会出现以下错误：
An exception occurred in the driver: SQLSTATE[08006] [7] could not translate host name "my_els_db_postgres" to address: Temporary failure in name resolution
这个错误明确指出，本地系统无法将 my_els_db_postgres 这个主机名解析为对应的IP地址。
Docker Compose会为服务创建一个内部网络，并在这个网络中提供DNS解析，使得容器之间可以通过服务名互相通信。例如，在 docker-compose.yml 中定义的 database 服务，其 container_name 为 my_els_db_postgres，在Docker内部网络中，其他容器可以通过 my_els_db_postgres 或 database 来访问它。
services:
database:
container_name: my_els_db_postgres
image: postgres:${POSTGRES_VERSION:-13}-alpine
environment:
POSTGRES_DB: ${POSTGRES_DB:-app_my_ELS}
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-ChangeMe}
POSTGRES_USER: ${POSTGRES_USER:-symfony}
volumes:
- db-data:/var/lib/postgresql/data:rw然而，本地主机（运行Symfony应用程序的环境）并不在Docker Compose创建的这个内部网络中。因此，本地主机的DNS解析器无法识别 my_els_db_postgres 这个名称，导致连接失败。
解决此问题主要有两种方法：
这种方法适用于Symfony应用仍需在本地主机上运行的场景。你需要手动将Docker数据库容器的IP地址映射到其服务名。
获取Docker容器的IP地址： 首先，确保你的Docker Compose服务正在运行。然后，使用 docker inspect 命令获取数据库容器的IP地址。
docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' my_els_db_postgres执行此命令后，你将获得一个IP地址，例如 172.18.0.2。
修改本地 hosts 文件： 将获取到的IP地址和容器服务名添加到你的本地 hosts 文件中。
使用管理员权限打开 hosts 文件，并添加如下一行（请替换为实际获取到的IP地址）：
172.18.0.2 my_els_db_postgres
保存文件后，你的本地系统就能解析 my_els_db_postgres 到正确的IP地址了。你可以通过 ping my_els_db_postgres 命令来测试解析是否成功。
注意事项：
services:
database:
container_name: my_els_db_postgres
image: postgres:${POSTGRES_VERSION:-13}-alpine
environment:
POSTGRES_DB: ${POSTGRES_DB:-app_my_ELS}
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-ChangeMe}
POSTGRES_USER: ${POSTGRES_USER:-symfony}
volumes:
- db-data:/var/lib/postgresql/data:rw
networks:
my_app_network: # 将数据库服务添加到自定义网络
ipv4_address: 172.18.0.2 # 指定一个静态IP地址
networks:
my_app_network: # 定义一个自定义网络
driver: bridge
ipam:
config:
- subnet: 172.18.0.0/24 # 指定子网，确保静态IP在该子网内更新 docker-compose.yml 后，需要执行 docker-compose down 再 docker-compose up -d 来重建服务和网络。然后，你就可以在本地 hosts 文件中永久地使用这个静态IP。
这是更推荐和健壮的解决方案，尤其是在团队协作或生产部署场景中。将Symfony应用程序（包括PHP-FPM、Web服务器如Nginx/Caddy）也作为Docker容器运行，并与数据库容器置于同一个Docker Compose网络中。
更新 docker-compose.yml： 在 docker-compose.yml 中添加PHP-FPM和Nginx（或Caddy）服务。
version: '3.8'
services:
database:
container_name: my_els_db_postgres
image: postgres:${POSTGRES_VERSION:-13}-alpine
environment:
POSTGRES_DB: ${POSTGRES_DB:-app_my_ELS}
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-ChangeMe}
POSTGRES_USER: ${POSTGRES_USER:-symfony}
volumes:
- db-data:/var/lib/postgresql/data:rw
networks:
- app_network # 所有服务都在同一个网络中
php:
build:
context: . # Dockerfile 位于项目根目录
dockerfile: Dockerfile.php # 指定PHP服务的Dockerfile
container_name: my_els_php
volumes:
- .:/var/www/html # 将项目目录挂载到容器内
- ./docker/php/php.ini:/usr/local/etc/php/conf.d/custom.ini # 自定义PHP配置 (可选)
depends_on:
- database # 确保数据库先启动
networks:
- app_network
environment:
# 在容器内部，可以直接使用服务名 'database' 作为主机名
DATABASE_URL: "postgresql://symfony:ChangeMe@database:5432/app_my_ELS?serverVersion=13&charset=utf8"
nginx:
image: nginx:alpine
container_name: my_els_nginx
ports:
- "80:80" # 将本地80端口映射到容器的80端口
volumes:
- .:/var/www/html:ro # 只读挂载项目代码
- ./docker/nginx/default.conf:/etc/nginx/conf.d/default.conf:ro # Nginx配置
depends_on:
- php # 确保PHP服务先启动
networks:
- app_network
networks:
app_network:
driver: bridge
volumes:
db-data:创建 Dockerfile.php： 在项目根目录或 docker/php 目录下创建 Dockerfile.php 文件，用于构建PHP-FPM容器。
# Dockerfile.php
FROM php:8.2-fpm-alpine
# 安装必要的PHP扩展和Composer
RUN apk add --no-cache \
postgresql-dev \
&& docker-php-ext-install pdo_pgsql \
&& curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer
# 设置工作目录
WORKDIR /var/www/html
# 复制Symfony项目（如果不是通过卷挂载）
# COPY . .
# 允许Composer在非交互模式下运行
ENV COMPOSER_ALLOW_SUPERUSER=1
# 暴露PHP-FPM端口
EXPOSE 9000
CMD ["php-fpm"]创建Nginx配置文件 docker/nginx/default.conf：
# docker/nginx/default.conf
server {
listen 80;
server_name localhost;
root /var/www/html/public; # Symfony项目的public目录
index index.php index.html;
location / {
try_files $uri /index.php$is_args$args;
}
location ~ \.php$ {
fastcgi_pass php:9000; # 使用服务名 'php' 和其内部端口
fastcgi_index index.php;
fastcgi_buffers 16 16k;
fastcgi_buffer_size 32k;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
error_log /var/log/nginx/error.log;
access_log /var/log/nginx/access.log;
}构建并启动服务：
docker-compose up -d --build
现在，Symfony应用程序和数据库都在Docker容器中运行，并通过Docker内部网络互相通信。在PHP容器内部，database 主机名将自动解析到PostgreSQL容器的IP地址。你可以通过进入PHP容器执行 php bin/console doctrine:fixture:load。
docker-compose exec php php bin/console doctrine:fixture:load
解决Symfony本地应用连接Docker容器数据库的主机名解析问题，关键在于确保本地系统能够正确解析Docker内部服务的主机名。
选择哪种方案取决于你的项目需求和开发流程。对于完整的Docker化开发流程，方案二无疑是更优的选择。
以上就是Symfony与Docker集成：解决数据库连接主机名解析失败的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
224
收藏
