如何使用 Docker 容器化 Laravel 和 PostgreSQL 应用

使用Docker容器化Laravel和PostgreSQL应用，可以让开发环境和生产环境保持高度一致，避免依赖冲突问题，同时简化部署流程。整个过程主要包含Dockerfile编写、PostgreSQL服务配置、docker-compose编排三个核心步骤。

环境准备

首先需要确保本地已经安装了Docker和Docker Compose，执行以下命令可以验证安装是否成功：

docker --version
docker-compose --version

如果命令返回了对应的版本号，说明环境已经准备就绪。

编写Laravel应用Dockerfile

在Laravel项目根目录创建Dockerfile文件，用于构建应用镜像，内容如下：

# 使用官方PHP镜像作为基础镜像
FROM php:8.2-fpm

# 安装系统依赖和PHP扩展
RUN apt-get update && apt-get install -y 
    git 
    unzip 
    libpq-dev 
    && docker-php-ext-install pdo pdo_pgsql

# 安装Composer
COPY --from=composer:latest /usr/bin/composer /usr/bin/composer

# 设置工作目录
WORKDIR /var/www/html

# 复制项目文件到容器
COPY . .

# 安装PHP依赖
RUN composer install --no-dev --optimize-autoloader

# 设置文件权限
RUN chown -R www-data:www-data /var/www/html 
    && chmod -R 755 /var/www/html

# 暴露9000端口
EXPOSE 9000

# 启动PHP-FPM
CMD ["php-fpm"]

配置PostgreSQL服务

PostgreSQL不需要单独编写Dockerfile，直接使用官方镜像即可，只需要在docker-compose中配置对应的环境变量和数据持久化目录。

编写docker-compose.yml编排文件

在项目根目录创建docker-compose.yml文件，定义两个服务以及网络、数据卷配置：

version: '3.8'

services:
  # Laravel应用服务
  app:
    build:
      context: .
      dockerfile: Dockerfile
    container_name: laravel_app
    restart: unless-stopped
    working_dir: /var/www/html
    volumes:
      - .:/var/www/html
    networks:
      - laravel_network
    depends_on:
      - postgres

  # PostgreSQL数据库服务
  postgres:
    image: postgres:15
    container_name: laravel_postgres
    restart: unless-stopped
    environment:
      POSTGRES_DB: laravel_db
      POSTGRES_USER: laravel_user
      POSTGRES_PASSWORD: laravel_password
    volumes:
      - postgres_data:/var/lib/postgresql/data
    networks:
      - laravel_network

# 定义数据卷，用于PostgreSQL数据持久化
volumes:
  postgres_data:

# 定义自定义网络
networks:
  laravel_network:
    driver: bridge

配置Laravel环境变量

修改Laravel项目的.env文件，将数据库连接配置指向PostgreSQL容器：

DB_CONNECTION=pgsql
DB_HOST=postgres
DB_PORT=5432
DB_DATABASE=laravel_db
DB_USERNAME=laravel_user
DB_PASSWORD=laravel_password

注意这里的DB_HOST要填写docker-compose中定义的PostgreSQL服务名称postgres，Docker会自动进行服务发现。

启动容器并验证

在项目根目录执行以下命令启动所有容器：

docker-compose up -d

容器启动后，可以执行以下命令进入Laravel容器，运行数据库迁移验证连接是否正常：

docker-compose exec app php artisan migrate

如果迁移命令执行成功，说明Laravel已经可以正常连接PostgreSQL容器。

常见注意事项

• 如果本地已经运行了PostgreSQL服务占用了5432端口，需要修改docker-compose中postgres服务的端口映射，避免端口冲突。
• 开发阶段可以将项目目录挂载到容器，修改代码后不需要重新构建镜像，提升开发效率。
• 生产环境部署时，建议不要将项目目录挂载到容器，而是直接将代码打包到镜像中，提升安全性。
• 如果需要停止所有容器，可以执行docker-compose down命令，加上-v参数可以同时删除数据卷。

DockerLaravelPostgreSQL容器化修改时间：2026-07-12 01:30:23