解决Symfony本地应用连接Docker容器数据库的指南

本文旨在解决symfony本地php应用无法通过服务名连接到docker容器内数据库的问题。核心在于本地环境无法解析docker内部网络服务名。教程将详细指导如何通过修改本地`hosts`文件，将docker容器的ip地址映射到其服务名，从而实现本地symfony应用与docker化数据库的成功通信，并探讨更佳的容器化实践。

理解本地Symfony与Docker数据库的连接挑战

在使用Symfony开发Web应用并结合Docker管理数据库服务时，一个常见的问题是，当Symfony应用在本地宿主机上运行，而数据库（如PostgreSQL）运行在Docker容器中时，本地应用无法通过Docker Compose文件中定义的container_name（例如my_els_db_postgres）来解析数据库地址。这是因为Docker容器拥有自己的内部网络，宿主机上的应用程序默认无法识别这些内部服务名。

当本地Symfony应用尝试使用如下.env配置连接数据库时：

DATABASE_URL="postgresql://symfony:ChangeMe@my_els_db_postgres:5432/app_my_ELS?serverVersion=13&charset=utf8"

并且docker-compose.yml中数据库服务定义如下：

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

本地PHP环境会尝试解析my_els_db_postgres这个主机名，但由于它不是一个公共DNS记录，也不是宿主机hosts文件中的条目，因此会导致“could not translate host name... Temporary failure in name resolution”的错误。

诊断连接问题

要确认问题是否出在主机名解析上，可以在本地终端尝试ping数据库容器的服务名：

ping my_els_db_postgres

如果收到“unknown host”或类似的错误，则表明本地环境确实无法解析该主机名。

解决方案：通过修改Hosts文件实现连接

解决此问题的最直接方法是将Docker数据库容器的IP地址手动添加到宿主机的hosts文件中，从而让本地PHP环境能够解析my_els_db_postgres到正确的IP地址。

步骤一：获取Docker容器的IP地址

首先，需要启动你的Docker数据库容器，然后获取其在Docker网络中的IP地址。

1. 启动Docker服务：

   docker-compose up -d database

   登录后复制
2. 获取容器IP地址： 使用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文件。

  sudo nano /etc/hosts

  登录后复制
• Windows： 以管理员身份打开记事本（或其他文本编辑器），然后打开C:\Windows\System32\drivers\etc\hosts文件。

在文件末尾添加一行，格式为[容器IP地址] [容器服务名]：

Clipfly

一站式AI视频生成和编辑平台，提供多种AI视频处理、AI图像处理工具。

98

查看详情

# Example: Docker PostgreSQL container IP mapping
172.18.0.2 my_els_db_postgres

请将172.18.0.2替换为你实际获取到的IP地址。保存并关闭文件。

步骤三：测试连接

修改hosts文件后，本地PHP应用现在应该能够通过my_els_db_postgres这个主机名找到数据库容器了。你可以再次尝试运行Symfony的fixture加载命令：

php bin/console doctrine:fixture:load

如果一切设置正确，此时应该能够成功连接并加载fixture。

注意事项与最佳实践

1. 动态IP地址： Docker容器的IP地址可能会在容器重启、Docker网络重构或宿主机重启后发生变化。如果IP地址改变，你需要重新获取并更新hosts文件。为了避免频繁修改，可以考虑为Docker网络配置静态IP地址范围，或在docker-compose.yml中为数据库服务指定静态IP。

   services:
     database:
       container_name: my_els_db_postgres
       # ...其他配置...
       networks:
         my_app_network:
           ipv4_address: 172.18.0.10 # 指定静态IP
   
   networks:
     my_app_network:
       ipam:
         config:
           - subnet: 172.18.0.0/24

   登录后复制

   然后，将hosts文件中的IP地址更新为这个静态IP。

2. 完全容器化： 最推荐的解决方案是将Symfony PHP应用也运行在Docker容器中。当所有服务都在同一个Docker Compose网络中时，它们可以直接通过服务名相互通信，无需修改宿主机的hosts文件。例如，如果你的PHP服务也定义在docker-compose.yml中：

   services:
     php:
       build:
         context: .
         dockerfile: Dockerfile
       volumes:
         - .:/var/www/html
       depends_on:
         - database
       # ...其他配置...
     database:
       # ...如上所示的数据库配置...

   登录后复制

   在这种情况下，PHP容器可以直接使用database服务名（或my_els_db_postgres容器名）来连接数据库，因为它们都在同一个Docker网络中。这提供了更好的隔离性、可移植性和一致性。

3. 开发与生产环境： 在开发环境中，修改hosts文件可能是一个快速的解决方案。但在生产环境中，所有服务都应该完全容器化，并通过Docker内部网络进行通信，以确保系统的健壮性和可维护性。

总结

当本地Symfony应用需要连接Docker容器中的数据库时，核心挑战在于宿主机无法解析Docker内部的服务名。通过获取Docker容器的IP地址并将其映射到宿主机的hosts文件中，可以有效地解决这一问题。然而，为了实现更稳定、可移植和专业的开发及部署流程，将所有服务（包括PHP应用本身）都容器化，并在Docker网络中进行通信，是更推荐的最佳实践。

以上就是解决Symfony本地应用连接Docker容器数据库的指南的详细内容，更多请关注php中文网其它相关文章！