
本教程详细指导如何使用docker和docker compose容器化laravel应用与postgresql数据库,从而搭建一个隔离、可复现且高效的开发环境。文章涵盖了laravel应用(php-fpm、composer、node.js)和postgresql数据库的dockerfile与docker-compose.yml配置,并提供了部署步骤及关键注意事项,帮助开发者快速启动和管理项目。
在现代Web开发中,为Laravel应用及其依赖(如PostgreSQL数据库)构建一个稳定、一致的开发和部署环境至关重要。Docker通过容器化技术,将应用及其所有依赖项打包到一个独立的、可移植的单元中,解决了“在我机器上能跑”的问题。Docker Compose则进一步简化了多容器应用的定义和运行,使得Laravel应用与PostgreSQL数据库能够协同工作。
使用Docker进行容器化具有以下优势:
本教程将提供一个完整的配置示例,帮助您快速上手。
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说明:
Docker Compose文件定义了应用的服务(Laravel应用和PostgreSQL数据库)、网络和数据卷,实现多容器应用的编排。
启科网络商城系统由启科网络技术开发团队完全自主开发,使用国内最流行高效的PHP程序语言,并用小巧的MySql作为数据库服务器,并且使用Smarty引擎来分离网站程序与前端设计代码,让建立的网站可以自由制作个性化的页面。 系统使用标签作为数据调用格式,网站前台开发人员只要简单学习系统标签功能和使用方法,将标签设置在制作的HTML模板中进行对网站数据、内容、信息等的调用,即可建设出美观、个性的网站。
0
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说明:
完成Dockerfile和docker-compose.yml的配置后,您可以按照以下步骤部署和运行您的Laravel与PostgreSQL应用:
创建项目目录: 在您的项目根目录(包含Dockerfile和docker-compose.yml的目录)下,确保您的Laravel项目文件已存在。
配置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环境。或者,可以在容器启动后进入容器执行此命令。)
构建并启动容器: 在项目根目录打开终端,执行以下命令:
# 停止并移除旧的容器(如果存在) sudo docker-compose down # 构建服务镜像,并在后台启动所有服务 sudo docker-compose build --no-cache && sudo
以上就是使用Docker容器化Laravel与PostgreSQL:构建高效开发环境的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号