当本地运行的symfony应用尝试连接docker容器中的postgresql数据库时，常因无法解析容器服务名而遭遇“主机名解析失败”的错误。本文将详细阐述此问题的原因，并提供两种主要解决方案：一是通过修改本地主机的hosts文件来映射容器ip，以实现本地应用与docker数据库的通信；二是更推荐的做法，将symfony应用本身也容器化，使其与数据库在同一docker网络中，从而利用docker内部dns实现无缝连接和数据夹具加载。
理解主机名解析失败的原因
在使用Docker Compose时，每个服务（如数据库服务）都会在Docker内部网络中获得一个服务名称，该名称在同一Docker网络中的其他容器之间是可解析的。例如，如果您的docker-compose.yml中定义了一个名为database的服务，那么在同一网络中的其他容器可以通过database这个主机名访问它。
然而，当您的Symfony应用是直接在本地主机上运行，而不是在Docker容器中时，它并不属于Docker的内部网络。因此，本地主机无法直接解析my_els_db_postgres（在您的.env文件中配置的主机名，对应docker-compose.yml中的container_name）这个主机名。本地操作系统的DNS解析机制并不知道my_els_db_postgres对应的是一个Docker容器的IP地址，从而导致SQLSTATE[08006] [7] could not translate host name "my_els_db_postgres" to address: Temporary failure in name resolution的错误。
要解决这个问题，我们需要确保本地Symfony应用能够正确地将my_els_db_postgres解析到Docker容器的实际IP地址。
解决方案一：修改本地主机的hosts文件
此方法适用于Symfony应用在本地主机运行，而数据库在Docker容器中的场景。核心思想是将Docker容器的IP地址手动映射到本地主机的hosts文件中，从而让本地DNS解析能够找到数据库容器。
步骤一：获取Docker容器的IP地址
首先，您需要找到正在运行的PostgreSQL容器的IP地址。可以通过以下命令实现：
docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' my_els_db_postgres执行此命令后，您将得到一个类似于172.17.0.2的IP地址。
步骤二：修改本地主机的hosts文件
将获取到的IP地址和数据库主机名添加到您本地操作系统的hosts文件中。
-
Linux/macOS:
打开终端，使用文本编辑器（如nano或vim）编辑/etc/hosts文件：
sudo nano /etc/hosts
- Windows: 使用管理员权限打开记事本，然后打开文件C:\Windows\System32\drivers\etc\hosts。
在文件末尾添加一行，格式为[容器IP地址] [主机名]：
# Example: Replace with your actual IP 172.17.0.2 my_els_db_postgres
保存并关闭文件。现在，您的本地Symfony应用在尝试连接my_els_db_postgres时，会通过hosts文件将其解析到正确的IP地址。
注意事项：设置Docker容器的静态IP（可选但推荐）
Docker容器的IP地址在容器重启后可能会发生变化。为了避免每次IP变化都修改hosts文件，您可以为数据库容器设置一个静态IP地址。这需要在docker-compose.yml中定义一个自定义网络并指定ipv4_address。
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:
my_custom_network:
ipv4_address: 172.18.0.2 # 为数据库容器指定一个静态IP
networks:
my_custom_network:
driver: bridge
ipam:
config:
- subnet: 172.18.0.0/24 # 定义子网
gateway: 172.18.0.1 # 定义网关
volumes:
db-data:更新docker-compose.yml后，执行docker-compose up -d重建服务。然后，您就可以在本地hosts文件中使用172.18.0.2作为my_els_db_postgres的IP地址。
解决方案二：将Symfony应用也容器化（推荐）
将Symfony应用也运行在Docker容器中是更符合Docker最佳实践的做法。这样，Symfony应用容器和数据库容器将处于同一个Docker网络中，可以直接通过服务名称进行通信，无需修改本地hosts文件，也避免了IP地址变动的问题。
步骤一：为Symfony应用创建Docker镜像
首先，您需要为Symfony应用创建一个Dockerfile。这是一个基本的PHP-FPM Dockerfile示例，您可以根据项目需求进行调整：
# .docker/php/Dockerfile.php
FROM php:8.2-fpm-alpine
# 安装必要的系统依赖
RUN apk add --no-cache \
postgresql-dev \
git \
zip \
unzip \
icu-dev \
libxml2-dev \
oniguruma-dev \
libzip-dev \
autoconf \
g++ \
make
# 安装PHP扩展
RUN docker-php-ext-install pdo pdo_pgsql intl opcache zip exif pcntl
# 安装Composer
COPY --from=composer:latest /usr/bin/composer /usr/local/bin/composer
# 设置工作目录
WORKDIR /var/www/html
# 暴露PHP-FPM端口
EXPOSE 9000
CMD ["php-fpm"]步骤二：更新docker-compose.yml
将Symfony应用作为一个服务添加到docker-compose.yml中，并确保它与数据库服务在同一网络中。
version: '3.8'
services:
php:
build:
context: .
dockerfile: .docker/php/Dockerfile.php # 指向您的PHP Dockerfile
container_name: my_els_php # 为PHP容器指定名称
volumes:
- .:/var/www/html # 将本地项目代码挂载到容器内
- ~/.ssh:/root/.ssh:ro # 如果需要在容器内使用SSH密钥（例如，Composer私有库）
depends_on:
- database # 确保数据库服务在PHP服务启动前可用
environment:
# 在容器内，直接使用数据库服务的名称作为主机名
DATABASE_URL: postgresql://symfony:ChangeMe@database:5432/app_my_ELS?serverVersion=13&charset=utf8
# 如果您使用Nginx或其他Web服务器，还需要配置它们来转发请求到PHP-FPM
# 例如，如果您需要一个Nginx服务：
# web:
# image: nginx:alpine
# ports:
# - "80:80"
# volumes:
# - .:/var/www/html
# - ./docker/nginx/nginx.conf:/etc/nginx/conf.d/default.conf
# depends_on:
# - php
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
volumes:
db-data:步骤三：启动Docker Compose服务
在项目根目录执行以下命令启动所有服务：
docker-compose up -d --build
--build选项会强制重新构建PHP镜像，确保最新的Dockerfile生效。
步骤四：执行Symfony命令
现在，您可以在PHP容器内部执行Symfony命令，例如加载数据夹具：
docker-compose exec php php bin/console doctrine:fixture:load
由于PHP容器和数据库容器都在同一个Docker网络中，它们可以通过database这个服务名称进行通信，因此doctrine:fixture:load命令将能够成功连接到数据库。
总结
解决Symfony与Docker数据库连接中的主机名解析问题，关键在于确保Symfony应用能够正确识别数据库容器的网络位置。
- 对于本地运行的Symfony应用，修改本地hosts文件并为Docker容器设置静态IP是一种可行方案，但可能需要手动维护。
- 对于完全容器化的开发环境，将Symfony应用也放入Docker容器中是更推荐和专业的做法。这利用了Docker Compose的内部DNS解析机制，使得服务间通信更加简洁、稳定和可移植。
在构建现代Web应用时，采用完全容器化的开发流程能够带来更高的环境一致性、更简化的依赖管理和更便捷的团队协作，是值得投入学习和实践的最佳实践。
