本文探讨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 这个名称，导致连接失败。
解决方案
解决此问题主要有两种方法：
方案一：修改本地 hosts 文件映射容器IP
这种方法适用于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 文件中。- Linux/macOS: 编辑 /etc/hosts
- Windows: 编辑 C:/Windows/System32/drivers/etc/hosts
使用管理员权限打开 hosts 文件，并添加如下一行（请替换为实际获取到的IP地址）：
172.18.0.2 my_els_db_postgres
登录后复制保存文件后，你的本地系统就能解析 my_els_db_postgres 到正确的IP地址了。你可以通过 ping my_els_db_postgres 命令来测试解析是否成功。
-
注意事项：
- IP地址可能变化： Docker容器的IP地址在容器重新创建（例如 docker-compose down 后 docker-compose up）时可能会改变。如果IP地址发生变化，你需要重复上述步骤更新 hosts 文件。
- 设置静态IP（可选，更稳定）： 为了避免IP地址频繁变化，你可以在 docker-compose.yml 中为数据库服务配置一个静态IP地址。这需要定义一个自定义网络。
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应用程序也容器化
这是更推荐和健壮的解决方案，尤其是在团队协作或生产部署场景中。将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内部服务的主机名。
- 临时或快速方案： 修改本地 hosts 文件，将容器IP映射到其服务名。但需注意IP可能变化，可结合静态IP配置提高稳定性。
- 推荐和最佳实践： 将Symfony应用程序也完全容器化，与数据库容器置于同一Docker Compose网络中。这样，所有服务都能通过其服务名互相发现和通信，提供了一个更一致、可移植且易于管理的开发和部署环境。
选择哪种方案取决于你的项目需求和开发流程。对于完整的Docker化开发流程，方案二无疑是更优的选择。
以上就是Symfony与Docker集成：解决数据库连接主机名解析失败的详细内容，更多请关注php中文网其它相关文章！