使用Docker容器化Laravel与PostgreSQL:完整实践指南

使用Docker容器化Laravel与PostgreSQL:完整实践指南

本教程旨在提供一个使用docker容器化%ignore_a_1%应用与postgresql数据库的完整指南。我们将详细介绍如何配置dockerfile以构建php-fpm服务,集成composer和node.js,并创建docker-compose.yml文件来编排laravel应用容器和postgresql数据库容器。通过本指南,读者将学习如何构建、运行并管理一个基于docker的laravel开发环境,确保环境一致性和部署便捷性。

引言

在现代软件开发中,容器化技术已成为构建、部署和管理应用程序的基石。Docker通过提供轻量级、可移植且自包含的运行环境,极大地简化了开发工作流。本教程将指导您如何使用Docker和Docker Compose,将一个Laravel应用程序与PostgreSQL数据库进行容器化,从而实现一个高效、一致且易于维护的开发环境。

前提条件

在开始之前,请确保您的系统已安装以下软件:

Docker Desktop: 包含Docker Engine和Docker Compose。一个现有的Laravel项目(或创建一个新项目)。

项目结构

为了保持清晰和组织性,建议您的项目根目录包含以下文件和目录:

your-laravel-project/├── .env                 # Laravel 环境变量文件├── Dockerfile           # Laravel 应用的 Docker 构建文件├── docker-compose.yml   # Docker Compose 编排文件├── app/├── bootstrap/├── config/├── database/├── public/├── resources/├── routes/├── storage/├── tests/├── vendor/└── ... (其他Laravel文件)

1. 定义Laravel应用服务(Dockerfile)

Dockerfile用于构建包含Laravel应用及其所有依赖的Docker镜像。我们将基于PHP-FPM官方镜像,并安装必要的系统依赖、PHP扩展、Composer和Node.js

在项目根目录下创建名为Dockerfile的文件,并添加以下内容:

# 使用官方PHP-FPM运行时作为父镜像FROM php:7.4-fpm# 设置工作目录WORKDIR /app# 安装系统依赖:Git、Curl、图像处理库、PostgreSQL客户端、压缩工具等# 注意:Python3及其科学计算库(pandas, scikit-learn, numpy)在此处安装,# 如果您的Laravel应用不涉及数据科学,可以移除相关行以减小镜像体积。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 &&     ln -s /usr/bin/python3 /usr/bin/python# 安装Python包(可选,如果不需要数据科学工具可移除)RUN pip3 install --no-cache-dir pandas scikit-learn numpy# 安装PHP扩展:PostgreSQL PDO、多字节字符串、Exif、进程控制、高精度计算、GD库、ZipRUN docker-php-ext-install pdo_pgsql mbstring exif pcntl bcmath gd zip# 启用已安装的GD和Zip扩展RUN 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# 安装ComposerRUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer# 将应用程序文件复制到容器中COPY . .# 安装Laravel依赖# 移除旧的vendor目录和composer.lock以确保全新安装# 使用 composer install --no-dev --optimize-autoloader 优化生产环境的依赖安装RUN rm -rf vendor composer.lock && composer update && composer install --no-dev --optimize-autoloader# 设置Laravel目录的权限# www-data 是 PHP-FPM 进程通常使用的用户和组RUN chmod -R 775 storage bootstrap/cache &&     chown -R www-data:www-data /app# 安装Node.js依赖(如果使用Laravel Mix)RUN npm install# 暴露PHP-FPM默认端口9000EXPOSE 9000# 启动PHP-FPM服务CMD ["php-fpm"]

代码解释:

FROM php:7.4-fpm: 选择PHP 7.4 FPM作为基础镜像,它包含了运行PHP应用程序所需的环境。WORKDIR /app: 将容器内的工作目录设置为/app。所有后续命令都将在此目录下执行。RUN apt-get update && apt-get install -y …: 安装必要的系统软件包,包括Git、Curl、图像处理库、PostgreSQL客户端库(postgresql-client, libpq-dev)等。RUN docker-php-ext-install …: 安装并启用Laravel常用的PHP扩展,如pdo_pgsql(用于PostgreSQL连接)、mbstring、gd(图像处理)和zip。RUN curl -fsSL … | bash – && apt-get install -y nodejs: 安装Node.js和npm,这对于使用Laravel Mix编译前端资源非常重要。RUN curl -sS … | php — …: 安装Composer,用于管理PHP依赖。COPY . .: 将宿主机当前目录(即Laravel项目根目录)下的所有文件复制到容器的/app目录。RUN rm -rf vendor composer.lock && composer update && composer install –no-dev –optimize-autoloader: 清理旧的依赖,然后通过composer update更新composer.lock文件,最后执行composer install安装项目依赖。–no-dev用于跳过开发环境依赖,–optimize-autoloader用于优化自动加载。RUN chmod -R 775 storage bootstrap/cache && chown -R www-data:www-data /app: 设置storage和bootstrap/cache目录的写入权限,并更改整个/app目录的所有者为www-data用户,确保PHP-FPM进程有足够的权限。RUN npm install: 安装Node.js项目依赖。EXPOSE 9000: 声明容器将监听9000端口,这是PHP-FPM的默认端口。CMD [“php-fpm”]: 定义容器启动时执行的默认命令,即启动PHP-FPM服务。

2. 编排服务(docker-compose.yml)

docker-compose.yml文件用于定义和运行多容器Docker应用程序。我们将定义两个服务:一个用于Laravel应用(laravel-app),另一个用于PostgreSQL数据库(postgres-db)。

在项目根目录下创建名为docker-compose.yml的文件,并添加以下内容:

version: '3.8' # 推荐使用较新的Compose文件格式版本services:  # Laravel 应用服务  laravel-app:    container_name: laravel-app-container # 指定容器名称    build:      context: . # Dockerfile 所在的上下文路径      dockerfile: Dockerfile # 指定 Dockerfile 文件名    command: 'php artisan serve --host=0.0.0.0 --port=8000' # 启动Laravel开发服务器    restart: unless-stopped # 容器异常退出时自动重启    volumes:      - .:/app # 将宿主机当前目录挂载到容器的 /app 目录,实现代码同步    ports:      - "8000:8000" # 将宿主机的 8000 端口映射到容器的 8000 端口    depends_on:      - postgres-db # 声明此服务依赖于 postgres-db 服务    networks:      - app-network # 将此服务连接到 app-network 网络  # PostgreSQL 数据库服务  postgres-db:    container_name: postgres-db-container # 指定容器名称    image: postgres:13 # 使用官方 PostgreSQL 13 镜像    restart: unless-stopped # 容器异常退出时自动重启    environment: # 设置 PostgreSQL 环境变量      POSTGRES_DB: laravel_db # 数据库名称      POSTGRES_USER: laravel_user # 数据库用户      POSTGRES_PASSWORD: secret # 数据库密码      # POSTGRES_HOST_AUTH_METHOD: "trust" # 生产环境不推荐,仅用于开发简化认证    volumes:      - postgres_data:/var/lib/postgresql/data # 挂载数据卷,实现数据持久化    ports:      - "5432:5432" # 将宿主机的 5432 端口映射到容器的 5432 端口    networks:      - app-network # 将此服务连接到 app-network 网络# 定义网络,使服务之间可以互相通信networks:  app-network:    driver: bridge # 使用桥接网络驱动# 定义数据卷,用于 PostgreSQL 数据的持久化存储volumes:  postgres_data:    driver: local # 使用本地驱动

代码解释:

version: ‘3.8’: 指定Docker Compose文件格式版本。services: 定义了两个服务。laravel-app:build: 指示Docker Compose根据当前目录下的Dockerfile构建镜像。command: ‘php artisan serve –host=0.0.0.0 –port=8000’: 覆盖Dockerfile中的CMD,直接使用Laravel自带的开发服务器启动应用。这在开发环境中非常方便。volumes: – .:/app: 将宿主机项目根目录挂载到容器的/app目录。这意味着您在宿主机上修改代码,容器内会立即同步,无需重新构建镜像。ports: – “8000:8000”: 将宿主机的8000端口映射到容器的8000端口,您可以通过http://localhost:8000访问Laravel应用。depends_on: – postgres-db: 声明laravel-app服务依赖于postgres-db服务,Docker Compose会确保postgres-db先启动。networks: – app-network: 将laravel-app服务连接到名为app-network的自定义网络。postgres-db:image: postgres:13: 使用官方的PostgreSQL 13镜像。environment: 设置PostgreSQL的环境变量,包括数据库名、用户名和密码。这些信息将用于Laravel应用的数据库连接。volumes: – postgres_data:/var/lib/postgresql/data: 使用一个命名卷postgres_data来持久化PostgreSQL的数据。这样即使容器被删除,数据也不会丢失。ports: – “5432:5432”: 将宿主机的5432端口映射到容器的5432端口,允许您从宿主机连接到数据库。networks: – app-network: 将postgres-db服务连接到app-network网络。networks: 定义了一个名为app-network的桥接网络,允许laravel-app和postgres-db服务通过服务名互相通信。volumes: 定义了一个命名卷postgres_data,用于PostgreSQL的数据持久化。

3. 配置Laravel环境变量(.env)

以上就是使用Docker容器化Laravel与PostgreSQL:完整实践指南的详细内容,更多请关注php中文网其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1342432.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
DDD实践:如何合理设计值对象与处理复杂数据结构
上一篇 2025年12月13日 05:35:47
php怎么用拼接字符串数组_PHP实现字符串与数组拼接操作
下一篇 2025年12月13日 05:36:01

相关推荐

发表回复

登录后才能评论
关注微信