本教程详细指导如何使用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# 安装ComposerRUN 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默认端口9000EXPOSE 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数据库）、网络和数据卷，实现多容器应用的编排。
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应用：
创建项目目录：在您的项目根目录（包含Dockerfile和docker-compose.yml的目录）下，确保您的Laravel项目文件已存在。
配置Laravel .env 文件：在您的Laravel项目根目录中，复制.env.example为.env，并修改数据库连接信息以匹配docker-compose.yml中的配置：
DB_CONNECTION=pgsqlDB_HOST=db # 注意这里是db，而不是localhost或127.0.0.1DB_PORT=5432DB_DATABASE=laravel_dbDB_USERNAME=laravel_userDB_PASSWORD=supersecretpassword
同时，生成APP_KEY：
php artisan key:generate
（如果您在宿主机运行此命令，请确保宿主机有PHP环境。或者，可以在容器启动后进入容器执行此命令。）
构建并启动容器：在项目根目录打开终端，执行以下命令：
# 停止并移除旧的容器（如果存在）sudo docker-compose down# 构建服务镜像，并在后台启动所有服务sudo docker-compose build --no-cache && sudo
以上就是使用Docker容器化Laravel与PostgreSQL：构建高效开发环境的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1342008.html
微信扫一扫 
支付宝扫一扫 
