使用Docker容器化Laravel与PostgreSQL:构建高效开发环境

聖光之護
发布: 2025-12-08 14:58:02
原创
896人浏览过

使用Docker容器化Laravel与PostgreSQL:构建高效开发环境

本教程详细指导如何使用docker和docker compose容器化laravel应用与postgresql数据库,从而搭建一个隔离、可复现且高效的开发环境。文章涵盖了laravel应用(php-fpm、composer、node.js)和postgresql数据库的dockerfile与docker-compose.yml配置,并提供了部署步骤及关键注意事项,帮助开发者快速启动和管理项目。

一、概述:为何选择Docker容器化Laravel与PostgreSQL?

在现代Web开发中,为Laravel应用及其依赖(如PostgreSQL数据库)构建一个稳定、一致的开发和部署环境至关重要。Docker通过容器化技术,将应用及其所有依赖项打包到一个独立的、可移植的单元中,解决了“在我机器上能跑”的问题。Docker Compose则进一步简化了多容器应用的定义和运行,使得Laravel应用与PostgreSQL数据库能够协同工作。

使用Docker进行容器化具有以下优势:

  • 环境隔离: 每个服务运行在独立的容器中,避免了依赖冲突。
  • 环境一致性: 确保开发、测试和生产环境的一致性,减少部署问题。
  • 快速启动: 新团队成员可以快速搭建开发环境。
  • 资源高效利用: 容器比虚拟机更轻量,启动更快。
  • 可移植性: 容器可以在任何支持Docker的平台上运行。

本教程将提供一个完整的配置示例,帮助您快速上手。

二、Laravel应用容器(Dockerfile)

Laravel应用容器基于PHP-FPM镜像构建,并安装了运行Laravel所需的所有系统依赖、PHP扩展、Composer以及Node.js。

# 使用官方PHP-FPM运行时作为基础镜像,指定版本以确保稳定性
FROM php:7.4-fpm

# 设置工作目录
WORKDIR /app

# 安装系统依赖:
# git, curl: 常用的命令行工具
# libpng-dev, libonig-dev, libxml2-dev, libzip-dev: PHP GD, mbstring, XML, Zip扩展所需
# zip, unzip: 文件压缩解压工具
# vim: 文本编辑器(可选,用于容器内调试)
# postgresql-client, libpq-dev: PostgreSQL客户端工具和PHP pgsql扩展所需库
# 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 && \
    # 创建Python3的软链接,使其可以通过python命令访问
    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: 处理图像EXIF数据
# pcntl: 进程控制(常用于Artisan队列)
# bcmath: 任意精度数学计算
# gd: 图像处理库
# zip: Zip文件处理
RUN docker-php-ext-install pdo_pgsql mbstring exif pcntl bcmath gd zip && \
    docker-php-ext-enable gd zip

# 安装Node.js和npm(用于Laravel Mix或前端资产编译)
# 这里安装的是Node.js 16.x版本
RUN curl -fsSL https://deb.nodesource.com/setup_16.x | bash - \
    && apt-get install -y nodejs

# 安装Composer
RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer

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

# 安装Laravel依赖
# 先删除旧的vendor目录和composer.lock以确保全新安装
RUN rm -rf vendor composer.lock && \
    composer update --no-dev --optimize-autoloader && \
    composer install --no-dev --optimize-autoloader

# 设置Laravel存储和缓存目录的权限
RUN chmod -R 775 storage bootstrap/cache && \
    chown -R www-data:www-data /app

# 安装Node.js依赖(如果项目使用Laravel Mix或其他前端工具)
RUN npm install

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

# 启动PHP-FPM服务
CMD ["php-fpm"]
登录后复制

Dockerfile说明:

  • 基础镜像: php:7.4-fpm 提供了一个带有PHP-FPM的PHP环境,适用于与Nginx等Web服务器配合使用。
  • 系统依赖: 包含了PostgreSQL客户端、必要的PHP扩展库以及Node.js等工具。
  • PHP扩展: 安装了pdo_pgsql等Laravel常用扩展。
  • Composer和Node.js: 用于管理PHP和JavaScript依赖。
  • 文件复制与权限: 将本地项目代码复制到容器内,并设置Laravel所需的文件权限。
  • EXPOSE 9000 和 CMD ["php-fpm"]: 表示容器将监听9000端口并启动PHP-FPM服务。在实际部署中,通常会有一个Nginx容器作为Web服务器,将请求转发给此PHP-FPM容器处理。然而,在下面的docker-compose.yml中,我们将通过command指令直接运行Laravel的开发服务器。

三、Docker Compose配置(docker-compose.yml)

Docker Compose文件定义了应用的服务(Laravel应用和PostgreSQL数据库)、网络和数据卷,实现多容器应用的编排。

启科网络PHP商城系统
启科网络PHP商城系统

启科网络商城系统由启科网络技术开发团队完全自主开发,使用国内最流行高效的PHP程序语言,并用小巧的MySql作为数据库服务器,并且使用Smarty引擎来分离网站程序与前端设计代码,让建立的网站可以自由制作个性化的页面。 系统使用标签作为数据调用格式,网站前台开发人员只要简单学习系统标签功能和使用方法,将标签设置在制作的HTML模板中进行对网站数据、内容、信息等的调用,即可建设出美观、个性的网站。

启科网络PHP商城系统 0
查看详情 启科网络PHP商城系统
version: '3.8' # 使用较新的Docker Compose文件格式版本

services:
  # Laravel应用服务
  app:
    container_name: laravel-app # 指定容器名称
    build:
      context: . # 构建上下文为当前目录
      dockerfile: Dockerfile # 使用当前目录下的Dockerfile
    # 覆盖Dockerfile中的CMD,直接运行Laravel开发服务器
    # 注意:生产环境通常会使用Nginx + PHP-FPM
    command: 'php artisan serve --host=0.0.0.0 --port=8000'
    restart: unless-stopped # 容器异常退出时自动重启
    volumes:
      - .:/app # 将当前目录挂载到容器的/app目录,实现代码热重载
    ports:
      - "80:8000" # 将宿主机的80端口映射到容器的8000端口
    environment:
      # Laravel .env 文件中的数据库连接配置,确保与db服务匹配
      DB_CONNECTION: pgsql
      DB_HOST: db # 数据库服务名称,Docker Compose会自动解析为IP
      DB_PORT: 5432
      DB_DATABASE: laravel_db
      DB_USERNAME: laravel_user
      DB_PASSWORD: supersecretpassword
      APP_KEY: # 建议在.env文件中设置,或通过`php artisan key:generate`生成
    depends_on:
      - db # 确保db服务在app服务之前启动
    networks:
      - app_network # 连接到自定义网络

  # PostgreSQL数据库服务
  db:
    image: postgres:13 # 使用官方PostgreSQL 13镜像,建议指定版本
    container_name: laravel-postgres # 指定容器名称
    restart: unless-stopped # 容器异常退出时自动重启
    environment:
      # PostgreSQL环境变量,用于初始化数据库
      POSTGRES_DB: laravel_db
      POSTGRES_USER: laravel_user
      POSTGRES_PASSWORD: supersecretpassword
      # POSTGRES_HOST_AUTH_METHOD: "trust" # 避免在生产环境中使用此设置,不安全
    volumes:
      - db_data:/var/lib/postgresql/data # 持久化数据库数据到命名卷
    ports:
      - "5432:5432" # 将宿主机的5432端口映射到容器的5432端口,方便本地连接数据库
    networks:
      - app_network # 连接到自定义网络

# 定义网络,使app和db服务可以在内部通过服务名互相通信
networks:
  app_network:
    driver: bridge # 默认的桥接网络类型

# 定义数据卷,用于持久化数据库数据
volumes:
  db_data:
登录后复制

Docker Compose说明:

  • version: '3.8': 指定Compose文件格式版本。
  • services: 定义了两个服务:app(Laravel应用)和db(PostgreSQL数据库)。
  • app 服务:
    • build:指示Docker Compose使用当前目录的Dockerfile构建镜像。
    • command:注意,这里覆盖了Dockerfile中的CMD,直接运行Laravel的开发服务器php artisan serve。这适用于开发环境,简化了配置,无需额外的Web服务器(如Nginx)。
    • volumes:将宿主机当前目录挂载到容器的/app,这样您在宿主机修改代码后,容器内会立即反映,实现热重载。
    • ports:将宿主机的80端口映射到容器的8000端口,您可以通过http://localhost访问应用。
    • environment:设置了Laravel连接PostgreSQL所需的数据库环境变量。DB_HOST设置为db,这是数据库服务的名称,Docker Compose会自动将其解析为容器的内部IP。
    • depends_on:确保db服务在app服务启动前就绪。
  • db 服务:
    • image: postgres:13:直接使用Docker Hub上的官方PostgreSQL 13镜像。
    • environment:设置了PostgreSQL初始化数据库所需的用户名、密码和数据库名。
    • volumes:使用命名卷db_data来持久化数据库数据。这样,即使容器被删除,数据也不会丢失。
    • ports:将宿主机的5432端口映射到容器的5432端口,方便您使用本地数据库管理工具连接。
  • networks: 定义了一个名为app_network的自定义桥接网络,使得app和db服务可以在这个网络中通过服务名互相通信。
  • volumes: 定义了db_data命名卷,用于db服务的数据持久化。

四、部署与运行

完成Dockerfile和docker-compose.yml的配置后,您可以按照以下步骤部署和运行您的Laravel与PostgreSQL应用:

  1. 创建项目目录: 在您的项目根目录(包含Dockerfile和docker-compose.yml的目录)下,确保您的Laravel项目文件已存在。

  2. 配置Laravel .env 文件: 在您的Laravel项目根目录中,复制.env.example为.env,并修改数据库连接信息以匹配docker-compose.yml中的配置:

    DB_CONNECTION=pgsql
    DB_HOST=db # 注意这里是db,而不是localhost或127.0.0.1
    DB_PORT=5432
    DB_DATABASE=laravel_db
    DB_USERNAME=laravel_user
    DB_PASSWORD=supersecretpassword
    登录后复制

    同时,生成APP_KEY:

    php artisan key:generate
    登录后复制

    (如果您在宿主机运行此命令,请确保宿主机有PHP环境。或者,可以在容器启动后进入容器执行此命令。)

  3. 构建并启动容器: 在项目根目录打开终端,执行以下命令:

    # 停止并移除旧的容器(如果存在)
    sudo docker-compose down
    
    # 构建服务镜像,并在后台启动所有服务
    sudo docker-compose build --no-cache && sudo
    登录后复制

以上就是使用Docker容器化Laravel与PostgreSQL:构建高效开发环境的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号