PHP框架Docker部署步骤及配置

本文详细介绍了如何将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
<h1>安装依赖扩展</h1><p>RUN apt-get update && apt-get install -y \
git \
curl \
libpng-dev \
libonig-dev \
libxml2-dev \
zip \
unzip</p><h1>启用PHP扩展</h1><p>RUN docker-php-ext-install pdo_mysql mbstring exif pcntl bcmath gd</p><h1>安装Composer</h1><p>COPY --from=composer:latest /usr/bin/composer /usr/bin/composer</p><h1>设置工作目录</h1><p>WORKDIR /var/www</p><h1>复制代码</h1><p>COPY . .</p><h1>安装依赖</h1><p>RUN composer install --optimize-autoloader --no-dev --no-scripts</p><h1>权限设置</h1><p>RUN chown -R www-data:www-data /var/www</p><p>EXPOSE 9000</p><p>CMD ["php-fpm"]
</p>

使用docker-compose.yml编排服务

创建docker-compose.yml，整合Nginx、PHP-FPM、MySQL、Redis等服务：

version: '3.8'
<p>services:
app:
build:
context: .
dockerfile: Dockerfile
container_name: php-app
volumes:</p>

• .:/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;
<pre class="brush:php;toolbar:false"><code>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;
}</code>

}

启动与部署流程

执行以下命令完成部署：

• 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学习网公众号，给大家分享更多文章知识！