当本地运行的symfony应用尝试连接%ignore_a_1%容器中的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:WindowsSystem32driversetchosts。
在文件末尾添加一行，格式为[容器IP地址] [主机名]：
# Example: Replace with your actual IP172.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 # 为数据库容器指定一个静态IPnetworks: 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.phpFROM 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# 安装ComposerCOPY --from=composer:latest /usr/bin/composer /usr/local/bin/composer# 设置工作目录WORKDIR /var/www/html# 暴露PHP-FPM端口EXPOSE 9000CMD ["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:rwvolumes: 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应用时，采用完全容器化的开发流程能够带来更高的环境一致性、更简化的依赖管理和更便捷的团队协作，是值得投入学习和实践的最佳实践。
以上就是解决Symfony与Docker数据库连接中的主机名解析问题的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1336551.html
微信扫一扫 
支付宝扫一扫 
