本文旨在解决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地址。
-
启动Docker服务：
docker-compose up -d database
-
获取容器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地址] [容器服务名]：
# 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。
注意事项与最佳实践
-
动态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。
-
完全容器化： 最推荐的解决方案是将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网络中。这提供了更好的隔离性、可移植性和一致性。
开发与生产环境： 在开发环境中，修改hosts文件可能是一个快速的解决方案。但在生产环境中，所有服务都应该完全容器化，并通过Docker内部网络进行通信，以确保系统的健壮性和可维护性。
总结
当本地Symfony应用需要连接Docker容器中的数据库时，核心挑战在于宿主机无法解析Docker内部的服务名。通过获取Docker容器的IP地址并将其映射到宿主机的hosts文件中，可以有效地解决这一问题。然而，为了实现更稳定、可移植和专业的开发及部署流程，将所有服务（包括PHP应用本身）都容器化，并在Docker网络中进行通信，是更推荐的最佳实践。
