ThinkPHP在容器云平台怎么部署_ThinkPHPPaaS环境适配操作【操作】-ThinkPHP-PHP中文网

容器化部署thinkphp 6+时，web根目录必须为public目录，nginx root需指向/public；dockerfile应多阶段构建，仅保留public、runtime、vendor等必要目录；环境变量tp_app_env/tp_app_debug须动态注入，runtime目录需通过initcontainer设权限并挂载emptydir或pvc；ingress须透传x-forwarded-proto/host头并配置url_domain_deploy=true。

thinkphp在容器云平台怎么部署_thinkphppaas环境适配操作【操作】

容器化部署时 `public` 目录必须作为 Web 根目录

ThinkPHP 6+ 默认采用 public 入口分离结构，但很多新手在写 Dockerfile 或配置 Nginx 时仍沿用旧习惯，把整个项目根目录挂载为 Web 根，导致 index.php 可访问但路由 404、runtime 写入失败或敏感目录（如 app/、config/）被直接暴露。

正确做法是：

Nginx 配置中 root 必须指向容器内 /var/www/html/public（或你设定的构建路径），而非 /var/www/html
Dockerfile 中建议用多阶段构建，最终镜像只保留 public/、runtime/、vendor/ 和必要配置，避免打包 app/ 源码到运行镜像（安全+体积）
若使用 Helm 部署到 Kubernetes，volumeMounts 应单独挂载 runtime 到空目录或 PVC，且设置 chmod 755 权限（容器用户需有写权限）

`TP_APP_ENV` 和 `TP_APP_DEBUG` 必须通过环境变量注入，不能硬编码

云平台（如阿里云 EDAS、腾讯云 TKE、华为云 CCE）通常禁止修改运行中容器的文件系统，而 ThinkPHP 的 .env 文件一旦被打包进镜像就无法动态变更。硬编码 APP_DEBUG=true 在生产环境会暴露敏感信息，且无法随集群灰度策略切换。

应改用环境变量驱动：

启动容器时传入 -e TP_APP_ENV=production -e TP_APP_DEBUG=false
确保 config/app.php 中对应字段写成 Env::get('TP_APP_ENV', 'production')，而不是直接写死字符串
注意 ThinkPHP 6.1+ 对 TP_ 前缀做了自动识别，但低版本需手动在 think\initializer\Env 初始化前调用 Env::set()
若平台不支持自定义环境变量前缀（如某些 PaaS 只允许 APP_），可改用 $_ENV['APP_ENV'] 并同步修改配置读取逻辑

Kubernetes 下 `runtime` 目录权限和生命周期管理

ThinkPHP 的 runtime 目录用于缓存、日志、模板编译等，容器重启后若未持久化或权限不对，会导致 Cache not writable、Template compile error 等错误，且日志丢失无法排查。

ThinkPHP5.1企业站点快速开发-源码课件

ThinkPHP5.1企业站点快速开发

下载

关键操作点：

不要在 Dockerfile 中用 RUN chmod -R 777 runtime —— 这在以非 root 用户运行的 Pod 中无效，且违反最小权限原则
应在 Deployment 的 securityContext 中指定 runAsUser: 82（与 www-data UID 一致），并用 initContainer 执行 chown -R 82:82 /var/www/html/runtime
推荐将 runtime 挂载为 emptyDir（临时缓存）或独立 PVC（需保留日志/会话），但注意 PVC 的 accessModes 必须为 ReadWriteMany（多副本 Pod 共享时）
若使用阿里云 NAS 或腾讯云 CFS，需确认挂载参数含 uid=82,gid=82，否则容器内看到的文件属主仍是 root

路由和 HTTPS 重定向在 Ingress 层失效的问题

本地开发时 url() 生成的链接可能是 http://localhost:8000/index，上云后经 Ingress（如 Nginx Ingress 或 ALB）转发，后端 PHP 拿不到原始 Scheme 和 Host，导致生成的 URL 错误、JS 请求跨域、微信回调地址不匹配。

必须显式告知 ThinkPHP 当前请求上下文：

在 config/app.php 中设置 'url_domain_deploy' => true，启用域名部署模式
Ingress 配置中添加 nginx.ingress.kubernetes.io/force-ssl-redirect: "true"，并在 fastcgi_params 或 proxy_set_header 中透传 X-Forwarded-Proto 和 X-Forwarded-Host
若用 Cloudflare 或 WAF，还需加 X-Forwarded-Proto: https 到请求头，并在入口文件 public/index.php 开头补一行：$_SERVER['HTTPS'] = ($_SERVER['HTTP_X_FORWARDED_PROTO'] ?? '') === 'https' ? 'on' : 'off';