部署本地php项目到docker的核心在于构建包含php运行环境、web服务器和数据库的容器化环境，并通过dockerfile和docker-compose.yml编排服务。1. 准备工作包括安装docker desktop并整理项目结构；2. 编写dockerfile定义php-fpm和nginx服务，配置nginx处理php请求；3. 使用docker-compose.yml编排php、nginx和数据库服务，设置卷挂载和环境变量；4. 运行docker-compose up启动服务，进入容器安装依赖并执行迁移；5. 注意文件权限、数据库连接、环境变量、路径配置和xdebug调试等常见问题；6. 优化开发流程使用卷挂载和热重载，生产环境采用多阶段构建、缓存优化、健康检查、ci/cd集成和安全加固提升效率与安全性。
将本地PHP项目部署到Docker，核心在于构建一个包含PHP运行环境、Web服务器（如Nginx/Apache）以及数据库（如MySQL）的容器化环境，并将你的代码映射或复制进去。这能极大提升开发和部署的一致性与效率，说实话，这在现代开发中几乎成了标配，能省去不少“在我机器上能跑”的扯皮。
把一个本地PHP项目搬进Docker，这事儿说起来简单，做起来也确实不复杂，但里头有些细节得捋清楚。我通常会这么操作：
1. 准备工作与项目结构
首先，确保你的机器上装了Docker Desktop。这是基础。你的PHP项目，无论是Laravel、Symfony还是纯粹的WordPress，通常都有一个入口文件（比如index.php或public/index.php），并且会用到Composer管理依赖。
2. 核心：Dockerfile 和 docker-compose.yml
这是魔法发生的地方。我们需要为PHP应用本身（PHP-FPM）、Web服务器（Nginx或Apache）以及数据库（MySQL或PostgreSQL）各定义一个服务。
Dockerfile.php (PHP-FPM 服务)
这个文件定义了你的PHP应用容器。它包含了PHP运行时、必要的扩展以及Composer。
# Dockerfile.php
FROM php:8.2-fpm-alpine # 使用轻量级的Alpine版本，当然你也可以选择Debian
WORKDIR /var/www/html
# 安装常用的PHP扩展，根据你的项目需求调整
RUN apk add --no-cache \
nginx \ # Nginx在这里是为了演示，实际PHP-FPM容器不需要Nginx
libzip-dev \
zip \
git \
curl \
postgresql-dev \ # 如果你用PostgreSQL
mysql-client \ # 如果你用MySQL
&& docker-php-ext-install pdo pdo_mysql pdo_pgsql opcache bcmath exif pcntl zip \
&& docker-php-ext-enable opcache
# 安装Composer
COPY --from=composer:latest /usr/bin/composer /usr/bin/composer
# 复制你的应用代码，在生产环境会这么做，开发环境通常用卷挂载
# COPY . .
# 设置目录权限，非常重要！
RUN chown -R www-data:www-data /var/www/html
EXPOSE 9000
CMD ["php-fpm"]小提示： 生产环境我会把代码直接COPY进去，减少部署时的网络依赖；开发环境则更倾向于卷挂载，方便实时修改代码。
立即学习“PHP免费学习笔记（深入）”；
Dockerfile.nginx (Nginx 服务)
这个容器负责接收HTTP请求，然后转发给PHP-FPM处理。
# Dockerfile.nginx FROM nginx:stable-alpine WORKDIR /var/www/html # 复制Nginx配置文件 COPY nginx.conf /etc/nginx/conf.d/default.conf EXPOSE 80 CMD ["nginx", "-g", "daemon off;"]
nginx.conf (Nginx 配置)
这个配置文件告诉Nginx如何处理PHP请求。
# nginx.conf
server {
listen 80;
index index.php index.html;
error_log /var/log/nginx/error.log;
access_log /var/log/nginx/access.log;
root /var/www/html/public; # 注意，这里指向你的项目public目录
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
try_files $uri =404;
fastcgi_split_path_info ^(.+\.php)(/.+)$;
fastcgi_pass php:9000; # 这里的'php'是docker-compose服务名
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param PATH_INFO $fastcgi_path_info;
}
}docker-compose.yml (编排所有服务)
这个文件把所有服务（PHP-FPM、Nginx、数据库）关联起来。
# docker-compose.yml
version: '3.8'
services:
nginx:
build:
context: .
dockerfile: Dockerfile.nginx
ports:
- "80:80"
volumes:
- ./src:/var/www/html # 假设你的项目代码在当前目录下的src文件夹
depends_on:
- php
php:
build:
context: .
dockerfile: Dockerfile.php
volumes:
- ./src:/var/www/html # 同上，将本地代码挂载到容器内
environment:
# 你的PHP应用需要的环境变量，例如数据库连接信息
DB_CONNECTION: mysql
DB_HOST: db
DB_PORT: 3306
DB_DATABASE: your_database
DB_USERNAME: your_user
DB_PASSWORD: your_password
# 如果需要Xdebug，可以在这里配置
# extra_hosts:
# - "host.docker.internal:host-gateway" # macOS/Windows Docker Desktop
# environment:
# XDEBUG_MODE: develop,debug
# XDEBUG_CONFIG: "client_host=host.docker.internal client_port=9003 idekey=VSCODE"
# ports:
# - "9003:9003" # 如果需要从外部连接Xdebug
db:
image: mysql:8.0 # 或者 postgres:14-alpine
ports:
- "3306:3306" # 仅在开发时可能需要暴露端口以便外部工具连接
environment:
MYSQL_ROOT_PASSWORD: your_root_password
MYSQL_DATABASE: your_database
MYSQL_USER: your_user
MYSQL_PASSWORD: your_password
volumes:
- db_data:/var/lib/mysql # 持久化数据库数据
volumes:
db_data: # 定义一个卷，用于持久化数据库数据注意： src 目录应该包含你的所有PHP项目文件。如果你的项目就在当前目录，可以把 ./src 改成 .。
3. 运行项目
在你项目根目录（也就是 docker-compose.yml 所在的目录），打开终端，运行：
docker-compose up -d
-d 参数让容器在后台运行。第一次运行会下载镜像、构建容器，可能需要一些时间。
4. 安装依赖与数据库迁移 一旦容器启动，你可能需要在PHP容器内部安装Composer依赖，并运行数据库迁移。
docker-compose exec php composer install # 进入php容器执行composer install docker-compose exec php php artisan migrate # 如果是Laravel项目
现在，你的PHP项目应该可以通过 http://localhost 访问了。
说实话，我个人觉得Docker在PHP项目部署上带来了革命性的变化。它解决了一大堆传统部署方式的痛点，主要体现在以下几个方面：
Dockerfile 和 docker-compose.yml 都是代码，可以和你的项目代码一起被Git管理。团队成员之间可以共享这些配置文件，确保开发环境的统一，极大提升协作效率。把一个跑得好好的本地PHP项目搬进Docker，虽然好处多多，但过程中也确实会遇到一些小麻烦，有些甚至是“甜蜜的烦恼”。我总结了几个大家常碰到的：
www-data）可能没有权限访问你挂载进来的项目文件。解决办法通常是在Dockerfile里调整文件和目录的所有者和权限（chown -R www-data:www-data /var/www/html），或者在宿主机上调整文件权限。localhost或127.0.0.1连接数据库。但在Docker Compose网络里，你需要使用服务名作为主机名，比如db（如果你在docker-compose.yml里把数据库服务命名为db）。忘记改这个，项目肯定跑不起来。docker-compose.yml的environment字段或.env文件来管理。但要注意，如果你的PHP框架有自己的.env加载机制，确保容器内部能正确读取到。vendor目录也一起提交到Git，然后挂载进容器。更好的做法是在Dockerfile或者容器启动后，在PHP容器内部执行composer install。这样可以确保依赖是针对容器环境（特别是CPU架构）正确编译的，也保持了镜像的精简。root路径是否正确指向了PHP项目的public目录？PHP-FPM的fastcgi_pass是否指向了正确的PHP服务名和端口（通常是php:9000）？这些细节错了，页面就会404或502。client_host的设置，告诉Xdebug你的IDE在哪里。对于Docker Desktop，host.docker.internal通常能派上用场。端口映射也要注意。Dockerfile里手动安装这些依赖。将PHP项目容器化只是第一步，真正让它发挥效用，还需要一些优化手段，尤其是在开发和部署流程上。我平时会特别关注这些点：
volumes: - ./src:/var/www/html）能让宿主机上的代码修改即时反映到容器内，无需重启或重建容器。对于一些框架（如Laravel），配合Webpack或Vite的热重载，开发体验会非常顺滑。Dockerfile中使用多阶段构建，可以先在一个构建阶段安装依赖、编译前端资源，然后只把最终运行所需的代码和产物复制到最终的轻量级运行时镜像中。这样可以大幅减小镜像体积，提高部署速度，减少攻击面。Dockerfile中，把不常变动的步骤（如安装系统依赖、复制Composer文件、composer install）放在前面，把经常变动的（如复制项目代码）放在后面。只要前面的层没有变化，Docker就会使用缓存，避免重复执行。docker-compose.yml文件（例如docker-compose.dev.yml和docker-compose.prod.yml）来管理，或者使用环境变量在运行时区分。docker-compose.yml中为服务添加健康检查，确保服务真正启动并可用，而不是仅仅容器运行起来了。这对于自动化部署和编排系统（如Kubernetes）尤为重要。以上就是如何将本地PHP项目部署到Docker PHP代码迁移到容器操作流程的详细内容，更多请关注php中文网其它相关文章！
PHP怎么学习？PHP怎么入门？PHP在哪学？PHP怎么学才快？不用担心，这里为大家提供了PHP速学教程(入门到精通)，有需要的小伙伴保存下载就能学习啦！
广告
收藏
收藏
收藏
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
608
