使用Docker容器化Laravel与PostgreSQL的完整教程

admin 百科 2025-12-12 14

本教程详细指导如何利用docker和docker compose容器化laravel应用程序与postgresql数据库。文章涵盖了优化的dockerfile配置，用于构建laravel应用镜像；以及一份完整的docker-compose.yml文件，用于编排laravel应用、postgresql数据库和网络。此外，教程还提供了laravel环境配置、容器启动与管理命令，并分享了重要的注意事项与最佳实践，旨在帮助开发者高效搭建和部署开发环境。

使用Docker容器化Laravel与PostgreSQL的完整教程-第2张图片-佛山资讯网

1. 引言

在现代Web开发中，Docker已成为部署和管理应用程序及其依赖的强大工具。通过容器化，我们可以确保开发、测试和生产环境的一致性，极大地简化了环境配置和团队协作。本教程将指导您如何使用Docker和Docker Compose将Laravel应用与PostgreSQL数据库进行容器化，构建一个高效、可移植的开发环境。

2. 项目结构概述

在开始之前，请确保您的Laravel项目已经准备就绪。我们将创建两个核心文件：Dockerfile 用于构建Laravel应用程序的Docker镜像，以及 docker-compose.yml 用于定义和运行Laravel应用与PostgreSQL数据库服务。这些文件通常放置在Laravel项目的根目录下。

.
├── app/
├── bootstrap/
├── config/
├── database/
├── public/
├── resources/
├── routes/
├── storage/
├── tests/
├── vendor/
├── .env
├── composer.json
├── composer.lock
├── artisan
├── Dockerfile              <-- Laravel 应用的 Dockerfile
└── docker-compose.yml      <-- Docker Compose 配置文件

登录后复制

3. Dockerfile 配置 (Laravel 应用容器)

Dockerfile 用于定义如何构建您的Laravel应用程序镜像。以下是一个针对Laravel 7.x/8.x (PHP 7.4) 和PostgreSQL优化的Dockerfile示例。

# 使用官方PHP-FPM镜像作为基础，版本为7.4
FROM php:7.4-fpm

# 设置容器内的工作目录
WORKDIR /app

# 安装系统依赖：
# git, curl: 常用的版本控制和网络工具
# libpng-dev, libonig-dev, libxml2-dev, libzip-dev, zip, unzip: PHP扩展所需的库
# postgresql-client, libpq-dev: PostgreSQL客户端工具和PHP PostgreSQL扩展所需的开发库
# python3, python3-pip: 如果您的项目需要Python脚本或数据科学工具 (可选)
RUN apt-get update && apt-get install -y \
    git \
    curl \
    libpng-dev \
    libonig-dev \
    libxml2-dev \
    libzip-dev \
    zip \
    unzip \
    vim \
    postgresql-client \
    libpq-dev \
    python3 \
    python3-pip && \
    rm -rf /var/lib/apt/lists/* && \
    ln -s /usr/bin/python3 /usr/bin/python

# 安装可选的Python包 (如果需要，可根据项目需求调整)
# RUN pip3 install --no-cache-dir pandas scikit-learn numpy

# 安装并启用PHP扩展：
# pdo_pgsql: PostgreSQL数据库驱动
# mbstring: 多字节字符串支持
# exif: 处理图像元数据
# pcntl: 进程控制 (通常用于队列)
# bcmath: 任意精度数学
# gd: 图像处理库 (需要libpng-dev)
# zip: Zip文件处理 (需要libzip-dev)
RUN docker-php-ext-install -j$(nproc) pdo_pgsql mbstring exif pcntl bcmath gd zip && \
    docker-php-ext-enable gd zip

# 安装Node.js和npm (如果您的Laravel项目使用Laravel Mix或其他前端构建工具，则需要)
# 这里安装的是Node.js 16.x版本
RUN curl -fsSL https://deb.nodesource.com/setup_16.x | bash - \
    && apt-get install -y nodejs && \
    rm -rf /var/lib/apt/lists/*

# 安装Composer (PHP依赖管理器)
RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer

# 将本地项目文件复制到容器的工作目录
COPY . .

# 安装Laravel项目依赖
# 先删除旧的vendor目录和composer.lock以确保清洁安装
# 使用 --no-dev 和 --optimize-autoloader 进行生产环境优化安装
RUN rm -rf vendor composer.lock && \
    composer install --no-dev --optimize-autoloader

# 设置Laravel存储和缓存目录的权限，确保Web服务器可以写入
RUN chmod -R 775 storage bootstrap/cache && \
    chown -R www-data:www-data /app

# 如果项目使用Laravel Mix，安装Node.js依赖并编译前端资源 (可选)
# RUN npm install && npm run prod

# 暴露PHP-FPM的默认端口
EXPOSE 9000

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

登录后复制

Dockerfile 解释:

FROM php:7.4-fpm: 选择PHP 7.4 FPM作为基础镜像。FPM (FastCGI Process Manager) 是生产环境中运行PHP应用的推荐方式，它与Nginx等Web服务器配合使用。
WORKDIR /app: 设置容器内的工作目录，所有后续命令都将在此目录下执行。
RUN apt-get update && apt-get install -y ...: 更新包列表并安装必要的系统依赖。这包括PostgreSQL客户端工具 (postgresql-client) 和PHP扩展所需的开发库 (libpq-dev, libpng-dev 等)。
RUN docker-php-ext-install ...: 安装并启用PHP扩展，如 pdo_pgsql (PostgreSQL数据库驱动)、gd (图像处理) 等，这些是Laravel应用可能需要的。
RUN curl ... | bash - && apt-get install -y nodejs: 安装Node.js和npm，如果您的Laravel项目需要前端构建（例如使用Laravel Mix）。
RUN curl ... | php -- ... composer: 安装Composer，用于管理PHP依赖。
COPY . .: 将当前目录（您的Laravel项目）下的所有文件复制到容器的 /app 目录。
RUN composer install --no-dev --optimize-autoloader: 安装Laravel项目的PHP依赖。--no-dev 排除开发依赖，--optimize-autoloader 优化Composer自动加载器，这对于生产环境非常有用。
RUN chmod -R 775 storage bootstrap/cache && chown -R www-data:www-data /app: 设置Laravel的 storage 和 bootstrap/cache 目录的权限，确保Web服务器用户 (www-data) 可以写入。
EXPOSE 9000: 声明容器将监听9000端口，这是PHP-FPM的默认端口。
CMD ["php-fpm"]: 定义容器启动时执行的命令，即启动PHP-FPM服务。