本教程详细指导如何使用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程序语言，并用小巧的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说明：
- 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
以上就是使用Docker容器化Laravel与PostgreSQL：构建高效开发环境的详细内容，更多请关注php中文网其它相关文章！