从零到一：基于Docker Compose构建ThinkPHP 8.1微服务化开发栈
1. 为什么选择Docker Compose搭建ThinkPHP开发环境
每次接手新项目时，最头疼的就是搭建开发环境。记得去年团队来了个新人，光是配环境就折腾了三天，不是PHP版本不对就是MySQL连接不上。这种经历让我下定决心要把开发环境标准化，而Docker Compose就是解决这个痛点的最佳方案。
用Docker Compose管理ThinkPHP环境有几个明显优势：
- 环境隔离：每个服务运行在独立容器中，不会污染宿主机环境
- 一键启动：只需一个命令就能拉起整个服务栈
- 版本可控：可以精确指定PHP、MySQL等组件的版本
- 团队协作：docker-compose.yml文件纳入版本控制，全团队使用相同环境
我特别喜欢Docker Compose的依赖管理功能。比如配置里写明Nginx依赖PHP服务，启动时会自动按正确顺序启动容器，再也不用担心服务启动顺序的问题了。
2. 从零开始搭建基础环境
2.1 安装必备工具
在开始之前，我们需要确保系统已经安装了Docker和Docker Compose。打开终端执行以下命令检查版本：
docker --version docker-compose --version如果还没安装，可以参考官方文档进行安装。我建议使用Docker Desktop，它自带了Docker Compose，特别适合新手。安装完成后记得把Docker服务跑起来，这个小细节经常被忽略。
2.2 创建项目目录结构
好的目录结构能让后续维护更轻松。我习惯这样组织代码：
thinkphp-docker/ ├── docker-compose.yml ├── nginx/ │ └── conf.d/ │ └── thinkphp.conf └── app/ └── (ThinkPHP项目代码)用mkdir命令创建这些目录：
mkdir -p thinkphp-docker/{nginx/conf.d,app}这种结构把Nginx配置和项目代码分开存放，后期要修改配置时一目了然。
3. 编写Docker Compose配置文件
3.1 定义基础服务
docker-compose.yml是整个环境的核心，我们先从最基础的三个服务开始：
version: '3.8' services: php: image: php:8.1-fpm volumes: - ./app:/var/www/html networks: - app-network nginx: image: nginx:alpine ports: - "8080:80" volumes: - ./app:/var/www/html - ./nginx/conf.d:/etc/nginx/conf.d depends_on: - php networks: - app-network mysql: image: mysql:8.0 environment: MYSQL_ROOT_PASSWORD: secret MYSQL_DATABASE: thinkphp volumes: - mysql-data:/var/lib/mysql networks: - app-network volumes: mysql-data: networks: app-network: driver: bridge这个配置有几个关键点：
- 使用PHP 8.1的fpm镜像
- Nginx使用轻量级的alpine版本
- MySQL 8.0配置了默认数据库和root密码
- 所有服务共享同一个自定义网络
3.2 优化PHP容器配置
基础PHP镜像缺少一些ThinkPHP必需的扩展，我们需要通过Dockerfile来定制：
FROM php:8.1-fpm RUN apt-get update && \ apt-get install -y \ libzip-dev \ zip \ unzip RUN docker-php-ext-install pdo_mysql mbstring zip然后在docker-compose.yml中修改php服务：
php: build: . volumes: - ./app:/var/www/html这样构建时会自动安装所需扩展。建议把这些常用扩展一次性装好，避免后期反复折腾。
4. 配置Nginx支持ThinkPHP
4.1 编写Nginx配置文件
在nginx/conf.d目录下创建thinkphp.conf：
server { listen 80; server_name localhost; 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 $realpath_root$fastcgi_script_name; include fastcgi_params; } }这个配置有几个注意点：
- root要指向public目录
- 路由重写要兼容ThinkPHP的路由规则
- fastcgi_pass指向php服务的9000端口
4.2 测试Nginx配置
启动前可以先验证配置是否正确：
docker-compose run --rm nginx nginx -t如果看到"configuration file /etc/nginx/nginx.conf test is successful"就说明配置没问题。
5. 初始化ThinkPHP项目
5.1 创建ThinkPHP项目
在项目目录下执行：
docker-compose run --rm php composer create-project topthink/think app这个命令会：
- 启动一个临时PHP容器
- 使用composer安装ThinkPHP
- 完成后自动删除容器
5.2 配置数据库连接
修改app/config/database.php：
return [ 'default' => 'mysql', 'connections' => [ 'mysql' => [ 'type' => 'mysql', 'hostname' => 'mysql', 'database' => 'thinkphp', 'username' => 'root', 'password' => 'secret', 'hostport' => '3306', 'charset' => 'utf8mb4', ], ], ];关键点是hostname要写mysql服务的名称，这是Docker Compose提供的服务发现功能。
6. 启动与调试
6.1 一键启动服务
现在可以启动所有服务了：
docker-compose up -d启动后可以通过以下命令检查状态：
docker-compose ps如果所有服务状态都是"Up"就说明启动成功了。
6.2 常见问题排查
如果遇到问题，可以查看日志：
docker-compose logs nginx docker-compose logs php docker-compose logs mysql我遇到过几个典型问题：
- Nginx报502错误：通常是PHP服务没启动或端口不对
- 数据库连接失败：检查database.php配置和MySQL容器日志
- 文件权限问题：确保app目录有足够权限
7. 开发环境优化技巧
7.1 使用Xdebug调试
在Dockerfile中添加：
RUN pecl install xdebug && \ docker-php-ext-enable xdebug然后配置php.ini：
[xdebug] xdebug.mode=debug xdebug.client_host=host.docker.internal xdebug.start_with_request=yes这样就能在IDE中设置断点调试了。
7.2 热重载配置
修改docker-compose.yml，添加文件监视：
services: php: volumes: - ./app:/var/www/html - ./php/conf.d:/usr/local/etc/php/conf.d这样修改PHP配置后只需重启容器就能生效，不用重建镜像。
7.3 使用Redis缓存
添加redis服务：
redis: image: redis:alpine networks: - app-network然后在ThinkPHP中配置cache.php使用Redis，能显著提升性能。