使用docker部署thinkphp8项目，核心是构建一个包含nginx、php-fpm和扩展的镜像，并将项目代码挂载或复制到容器中。具体做法是编写`dockerfile`定义运行环境，配置`nginx.conf`处理路由转发，并通过`docker-compose.yml`编排服务，最后执行`docker compose up -d`启动即可。
Dockerfile中如何配置PHP扩展与基础环境
在构建镜像时，必须确保安装了ThinkPHP8所需的PHP扩展，如PDO、MySQL、GD等。基于官方PHP镜像，使用`docker-php-ext-install`命令安装扩展是最标准且高效的做法，这样能避免手动编译带来的依赖问题，最终生成的镜像体积可控且环境纯净。
FROM php:8.2-fpm
# 安装系统依赖及PHP扩展
RUN apt-get update && apt-get install -y \
libpng-dev libjpeg-dev libfreetype6-dev \
&& docker-php-ext-configure gd --with-freetype --with-jpeg \
&& docker-php-ext-install pdo_mysql gd zip bcmath
# 设置工作目录
WORKDIR /var/www/html
# 复制代码（实际部署建议单独挂载）
COPY . .
# 修改权限
RUN chown -R www-data:www-data /var/www/html
上述代码定义了从`php:8.2-fpm`开始的基础镜像。首先更新apt源并安装图片处理和数据库连接所需的系统库。接着通过`docker-php-ext-configure`配置GD库以支持图片和字体，随后安装`pdo_mysql`用于数据库交互，以及`zip`和`bcmath`以满足ThinkPHP常见的压缩和计算需求。最后将工作目录设为`/var/www/html`并调整文件所有者为PHP-FPM运行的用户`www-data`，防止后续写入日志或缓存时出现权限错误。
立即学习“PHP免费学习笔记（深入）”；
Docker Hub (hub.docker.com)。此技能适用于所有 Docker Hub 操作，包括读取、创建、更新和删除数据。只要任务涉及 Docker Hub，就使用此技能。
Nginx配置如何实现ThinkPHP的路由重写
ThinkPHP8默认使用Pathinfo模式或URL伪静态，需要Nginx配置`try_files`指令来将所有非文件请求重定向到`index.php`入口文件。正确的配置能确保RESTful风格的URL被正确解析，避免404错误，这是部署成功的关键环节。
server {
listen 80;
server_name example.com;
root /var/www/html/public;
index index.php index.html;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
fastcgi_pass unix:/run/php/php-fpm.sock;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}
该配置将网站根目录指向ThinkPHP的`public`文件夹，这是安全且标准的做法。在`location /`块中，`try_files`指令优先尝试匹配静态资源，若不存在则重写URL至`index.php`并携带查询字符串，从而支持ThinkPHP的路由机制。对于PHP文件的处理，通过Unix Socket与PHP-FPM通信，传递正确的脚本路径参数，确保后端能正确执行请求。
如何通过Docker Compose编排多容器服务
在实际生产或测试环境中，通常需要将Web服务、PHP应用和数据库分离。使用`docker-compose.yml`可以一键启动Nginx、PHP-FPM和MySQL容器，并配置网络互通和数据卷持久化，简化了本地开发和上线的流程。
version: '3.8'
services:
nginx:
image: nginx:latest
ports:
- "80:80"
volumes:
- ./nginx/conf.d:/etc/nginx/conf.d
- ./:/var/www/html
depends_on:
- php
php:
build: .
volumes:
- ./:/var/www/html
depends_on:
- mysql
mysql:
image: mysql:8.0
environment:
MYSQL_ROOT_PASSWORD: root
MYSQL_DATABASE: tp8
volumes:
- db_data:/var/lib/mysql
volumes:
db_data:
此Compose文件定义了三个服务。Nginx容器映射80端口，并将本地Nginx配置和项目代码挂载到容器内，依赖于PHP服务。PHP容器使用当前目录构建，同样挂载代码目录以便热更新，并依赖MySQL。MySQL容器初始化指定密码和数据库名，并使用命名卷`db_data`持久化数据，防止容器重启后数据丢失。这种结构清晰分离了关注点，便于维护和扩展。
