PHP框架Docker部署步骤及配置
时间:2026-04-02 13:37:21 351浏览 收藏
本文详细介绍了如何将PHP框架(如Laravel、Symfony、ThinkPHP等)通过Docker容器化部署,涵盖从Docker环境搭建、定制化Dockerfile构建PHP-FPM运行环境,到使用docker-compose.yml统一编排Nginx、MySQL、Redis等服务的完整流程,并提供了可直接复用的配置示例、Nginx反向代理设置及关键启动命令;同时强调了开发与生产环境下的差异化优化策略——如热更新支持、多阶段构建、敏感信息管理与日志治理,帮助开发者高效实现环境一致、部署简化、易于扩展且贴近实战的现代化PHP应用交付。

将PHP框架应用通过Docker容器化部署,可以提升环境一致性、简化部署流程并便于扩展。以下是通用的PHP框架(如Laravel、Symfony、ThinkPHP等)Docker化部署的操作步骤和关键配置。
Docker环境准备
确保服务器已安装Docker和Docker Compose:
- 安装Docker:参考官方文档根据操作系统进行安装
- 安装Docker Compose:使用pip install docker-compose或下载二进制文件
- 验证安装:docker --version 和 docker-compose --version
编写Dockerfile定义PHP运行环境
在项目根目录创建Dockerfile,以Laravel为例:
FROM php:8.2-fpm安装依赖扩展
RUN apt-get update && apt-get install -y \ git \ curl \ libpng-dev \ libonig-dev \ libxml2-dev \ zip \ unzip
启用PHP扩展
RUN docker-php-ext-install pdo_mysql mbstring exif pcntl bcmath gd
安装Composer
COPY --from=composer:latest /usr/bin/composer /usr/bin/composer
设置工作目录
WORKDIR /var/www
复制代码
COPY . .
安装依赖
RUN composer install --optimize-autoloader --no-dev --no-scripts
权限设置
RUN chown -R www-data:www-data /var/www
EXPOSE 9000
CMD ["php-fpm"]
使用docker-compose.yml编排服务
创建docker-compose.yml,整合Nginx、PHP-FPM、MySQL、Redis等服务:
version: '3.8'services: app: build: context: . dockerfile: Dockerfile container_name: php-app volumes:
- .:/var/www environment:
- PHP_IDE_CONFIG=serverName=localhost networks:
- app-network
nginx: image: nginx:alpine container_name: nginx-server ports:
- "80:80" volumes:
- .:/var/www
- ./nginx/conf.d:/etc/nginx/conf.d depends_on:
- app networks:
- app-network
db: image: mysql:8.0 container_name: mysql-db restart: unless-stopped environment: MYSQL_ROOT_PASSWORD: rootpassword MYSQL_DATABASE: app_db MYSQL_USER: app_user MYSQL_PASSWORD: app_pass volumes:
- dbdata:/var/lib/mysql
- ./mysql/init.sql:/docker-entrypoint-initdb.d/init.sql ports:
- "3306:3306" networks:
- app-network
redis: image: redis:alpine container_name: redis-cache ports:
- "6379:6379" networks:
- app-network
networks: app-network: driver: bridge
volumes: dbdata:
注意:需提前创建./nginx/conf.d/default.conf配置Nginx转发PHP请求到FPM。
Nginx配置示例
创建nginx/conf.d/default.conf:
server {
listen 80;
index index.php index.html;
server_name localhost;
root /var/www/public;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
fastcgi_pass app:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
include fastcgi_params;
}
}
启动与部署流程
执行以下命令完成部署:
- docker-compose build —— 构建镜像
- docker-compose up -d —— 后台启动所有服务
- docker-compose exec app php artisan key:generate(Laravel)—— 生成应用密钥
- docker-compose exec app php artisan config:cache —— 缓存配置
- 访问http://localhost验证服务是否正常
常见优化与注意事项
- 开发环境:挂载本地代码目录,实现热更新
- 生产环境:使用多阶段构建,减少镜像体积,关闭错误显示
- 敏感信息通过环境变量注入,避免硬编码
- 日志可挂载到宿主机或接入ELK等日志系统
- 定期清理无用镜像和容器,避免磁盘占用过高
基本上就这些,不复杂但容易忽略细节。
好了,本文到此结束,带大家了解了《PHP框架Docker部署步骤及配置》,希望本文对你有所帮助!关注golang学习网公众号,给大家分享更多文章知识!
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
229 收藏
-
文章 · php教程 | 3天前 | Cookie · session · php教程 · 登录态 · 后端排查 · php cookie session php-fpm SameSite session_start 登录态丢失484 收藏
-
336 收藏
-
文章 · php教程 | 5天前 | WEB开发 · 登录状态 · Cookie · PHP · session · session_start · php cookie session session_start PHPSESSID 登录态丢失196 收藏
-
227 收藏
-
483 收藏
-
文章 · php教程 | 6天前 | PHP · MD5 · 登录安全 · password_hash · password_verify · password_hash password_verify 登录安全 PHP密码迁移 MD5迁移174 收藏
-
422 收藏
-
文章 · php教程 | 1星期前 | PHP · web安全 · php教程 · Cookie安全 · 登录态 · php cookie HttpOnly Secure SameSite 登录态安全420 收藏
-
306 收藏
-
204 收藏
-
322 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习