首先安装Docker和Docker Compose并验证,接着创建Dockerfile配置PHP环境,编写docker-compose.yml编排Nginx、PHP-FPM、MySQL等服务,设置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
立即学习“PHP免费学习笔记(深入)”;
安装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等日志系统
- 定期清理无用镜像和容器,避免磁盘占用过高
基本上就这些,不复杂但容易忽略细节。











