在 PHP 面试中，ThinkPHP 框架的掌握程度往往是考察重点，而随着容器化技术的普及，Docker 部署 ThinkPHP 项目 已经成为中高级岗位的常见考点。面试官不仅关注你是否会写控制器和模型，更在意你能否将项目高效、可移植地交付到生产环境。本文将从面试实战角度出发，系统讲解 Docker 部署 ThinkPHP 的完整流程与高频问题。
一、为什么面试官爱问 Docker 部署 ThinkPHP？
传统 LNMP 部署方式存在环境不一致、依赖冲突、迁移困难等痛点。Docker 通过镜像和容器实现了“一次构建，处处运行”，恰好解决了 ThinkPHP 项目在多环境下的部署难题。
面试中，这个问题可以同时考察：
- 你对 ThinkPHP 运行原理的理解（入口文件、路由、缓存目录权限）
- 你对 Docker 核心概念（镜像、容器、卷、网络）的掌握
- 你排查线上问题的工程能力
因此，回答时不能只背命令，而要讲清楚“为什么这样做”。
二、部署架构设计
一个典型的 ThinkPHP + Docker 部署方案包含三个核心服务：
- Nginx 容器：负责静态资源处理和反向代理，将 PHP 请求转发给 PHP-FPM。
- PHP-FPM 容器：运行 ThinkPHP 代码，处理业务逻辑。
- MySQL 容器：提供数据库服务（也可用外部数据库）。
此外，通常还会加入 Redis 容器用于缓存和会话。各容器通过自定义 Docker 网络通信，代码目录通过数据卷挂载，实现宿主机与容器内的文件同步。
三、实战步骤详解
1. 准备项目与 Dockerfile
假设 ThinkPHP 项目根目录为 tp-app，首先编写 PHP 的 Dockerfile：
FROM php:8.1-fpm
RUN docker-php-ext-install pdo_mysql mbstring
WORKDIR /var/www/html
COPY . /var/www/html
RUN chown -R www-data:www-data /var/www/html/runtime
这里的关键点是安装 pdo_mysql 扩展，并确保 runtime 目录可写——这是 ThinkPHP 运行的必要条件，也是面试常问的细节。
2. 编写 docker-compose.yml
使用 Docker Compose 编排多容器：
version: '3.8'
services:
php:
build: .
volumes:
- ./tp-app:/var/www/html
networks:
- tp-net
nginx:
image: nginx:alpine
ports:
- "8080:80"
volumes:
- ./tp-app:/var/www/html
- ./nginx.conf:/etc/nginx/conf.d/default.conf
depends_on:
- php
networks:
- tp-net
mysql:
image: mysql:8.0
environment:
MYSQL_ROOT_PASSWORD: root
MYSQL_DATABASE: tp_db
volumes:
- mysql-data:/var/lib/mysql
networks:
- tp-net
networks:
tp-net:
volumes:
mysql-data:
注意 depends_on 只保证启动顺序，不保证服务就绪。生产环境应配合健康检查或启动脚本等待 MySQL 就绪。
3. 配置 Nginx
Nginx 配置文件需要正确指向 ThinkPHP 的入口文件 public/index.php：
server {
listen 80;
root /var/www/html/public;
index index.php index.html;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
fastcgi_pass php:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}
fastcgi_pass php:9000 中的 php 是 Compose 服务名，Docker 内置 DNS 会将其解析为容器 IP，这是面试中经常被追问的知识点。
4. 启动与验证
docker-compose up -d
docker-compose ps
访问 http://localhost:8080，若看到 ThinkPHP 默认页面即部署成功。若报错，优先检查 runtime 目录权限和 Nginx 的 root 路径。
四、面试高频问题与回答要点
Q1：ThinkPHP 的 runtime 目录为什么要单独处理权限？
ThinkPHP 在运行时会将日志、缓存、编译模板写入 runtime 目录。容器内 PHP-FPM 以 www-data 用户运行，若该目录属主为 root 且无写权限，就会报“目录不可写”错误。解决方式是在 Dockerfile 中 chown，或在宿主机调整目录权限。
Q2：代码挂载用 volumes 还是 COPY？
开发环境推荐 volumes 挂载，修改代码即时生效，无需重建镜像。生产环境推荐 COPY 进镜像，保证镜像自包含、可回滚，避免宿主机文件意外修改影响运行。
Q3：容器间如何通信？
通过自定义 bridge 网络，容器可用服务名互相访问。不要使用 links（已废弃），也不要依赖默认 bridge 网络，因为默认网络不支持服务名解析。
Q4：如何优化镜像体积？
使用 php:8.1-fpm-alpine 基础镜像、多阶段构建、合并 RUN 指令减少层数、清理 apt 缓存。这些都能体现你的工程素养。
Q5：部署后 404 或 500 怎么排查？
404 通常是 Nginx root 路径未指向 public 目录；500 多为 PHP 扩展缺失或 runtime 权限问题。排查顺序：docker-compose logs 查看日志 → 进入容器 docker exec -it 验证扩展 → 检查目录权限。
五、总结
Docker 部署 ThinkPHP 项目的核心在于：理解请求从 Nginx 到 PHP-FPM 的流转路径，掌握容器网络与数据卷的使用，并处理好 ThinkPHP 特有的 runtime 权限问题。面试中，与其罗列命令，不如讲清楚架构设计和问题排查思路——这才是区分初级与中高级工程师的关键。
建议你在本地完整跑通一遍上述流程，并尝试故意制造权限错误和网络不通的场景，积累真实的排错经验。这样在面试中，你就能从容应对面试官的每一个追问。
未经允许不得转载：任鹏个人博客 » ThinkPHP 面试精讲：Docker 部署 ThinkPHP 项目实践
