解决Symfony与Docker数据库连接中的主机名解析问题-php教程-PHP中文网

解决Symfony与Docker数据库连接中的主机名解析问题

聖光之護

发布： 2025-11-19 14:02:12

原创

992人浏览过

解决Symfony与Docker数据库连接中的主机名解析问题

当本地运行的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地址。

码哩写作

最懂作者的AI辅助创作工具

查看详情

解决方案二：将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应用时，采用完全容器化的开发流程能够带来更高的环境一致性、更简化的依赖管理和更便捷的团队协作，是值得投入学习和实践的最佳实践。

以上就是解决Symfony与Docker数据库连接中的主机名解析问题的详细内容，更多请关注php中文网其它相关文章！

大家都在看：

使用PHP和MySQL通过自连接查询显示层级分类数据如何下载php zip文件_下载php处理压缩文件的相关文件方法如何在PHP生成HTML表格时隐藏空数据行 PHP网站子目录伪装根目录：使用前端控制器与URL重写实现 Node.js中实现PHP式动态变量赋值：global对象的使用与最佳实践