本教程详细指导如何使用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程序语言，并用小巧的MySql作为数据库服务器，并且使用Smarty引擎来分离网站程序与前端设计代码，让建立的网站可以自由制作个性化的页面。 系统使用标签作为数据调用格式，网站前台开发人员只要简单学习系统标签功能和使用方法，将标签设置在制作的HTML模板中进行对网站数据、内容、信息等的调用，即可建设出美观、个性的网站。
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=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
