ThinkPHP 5.1 迁移 Docker 需绕过四大陷阱：硬编码路径、静态配置、runtime 权限失控（须挂载并 chown -R 82:82）、Nginx 重写失效（必须用 try_files + $query_string 或正确传递 PATH_INFO）；基础镜像基于 php:7.4-fpm-alpine，需补 gd/pdo_mysql/mbstring 扩展及 Asia/Shanghai 时区。
将运行多年的 ThinkPHP 5.1 遗留系统迁入 Docker 容器，需绕过硬编码路径、静态配置、runtime 目录权限失控、Nginx 重写失效等典型陷阱，不能直接套用新项目模板。
准备可复用的 PHP 运行环境镜像
基于官方 php:7.4-fpm-alpine 镜像启动，避免使用 debian 系列带来的体积膨胀和安全冗余。alpine 的 musl libc 与 TP5.1 兼容性已验证，但必须手动补全 gd、pdo_mysql、mbstring 三个扩展——缺任何一个都会导致验证码、数据库连接或中文处理失败。
执行 docker build -t tp51-php-base -f Dockerfile.php . 构建基础镜像，其中 【Dockerfile.php 必须在 RUN 命令末尾添加 apk add --no-cache tzdata && cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime】，否则日志时间戳全为 UTC，排查线上错误时会严重误判。
这一步操作起来很简单，直接把文件拖进去就行。
立即学习“PHP免费学习笔记（深入）”；
挂载关键目录并隔离 runtime
ThinkPHP 5.1 的 runtime 目录默认写入缓存、日志、模板编译文件，若不挂载到宿主机，容器重启后所有缓存丢失，每次请求都重新编译模板，CPU 使用率飙升至 90%+。
在 docker-compose.yml 中为 web 服务添加如下卷配置：
volumes:
- ./src:/var/www/html
- ./runtime:/var/www/html/runtime
- ./public:/var/www/html/public
注意：不要挂载整个 /var/www/html，否则会覆盖容器内已设好的 www-data 权限和 .htaccess 规则；只挂载 src 和 public 是安全边界。
挂载后立即执行 chown -R 82:82 runtime，因为 alpine 中 www-data 用户 UID 固定为 82，非此 UID 写入 runtime 将被拒绝。
修复 Nginx 重写与入口路由
方法一：使用标准 nginx.conf + rewrite 规则
在 nginx.conf 的 server 块中，location / 段必须包含：try_files $uri $uri/ /index.php?$query_string;。漏掉 $query_string 会导致 GET 参数全部丢失，所有分页、搜索功能瘫痪。
方法二：改用 fastcgi_params 替代 script_filename
在 location ~ \.php$ 块中，删除 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; 这一行，改用 include fastcgi_params; 并确保 fastcgi_params 文件里已定义 SCRIPT_NAME 和 PATH_INFO ——TP5.1 路由依赖 PATH_INFO 解析模块/控制器/操作，否则全部 404。
方法三（推荐）：启用 PATH_INFO 模式并关闭 PATH_INFO 兼容检测
第一步：在 .env 中设置 APP_ENV=production 且 APP_DEBUG=false
第二步：修改 application/config.php，将 'url_pathinfo_depr' => '/', 改为 'url_pathinfo_depr' => '_',（下划线分隔）
第三步：在 nginx 的 fastcgi_params 中追加 fastcgi_param PATH_INFO $fastcgi_path_info;
第四步：重启 nginx 容器，访问 /index.php/index_index_hello 测试是否返回预期内容
