kubernetes/docker swarm中部署thinkphp插件需分离插件目录与运行时路径、适配反向代理url生成、支持环境变量覆盖配置、多应用插件应拆分为独立服务。
在 Kubernetes 或 Docker Swarm 环境中部署 ThinkPHP 插件时，若仍沿用本地开发习惯直接挂载 addons/ 目录、依赖 runtime 缓存自动写入、或让插件自行读取 $_SERVER 变量生成 URL，将导致插件路由 404、配置加载失败、跨实例缓存不一致、反向代理后链接跳转到 HTTP 而非 HTTPS 等连锁故障。
插件目录与运行时路径必须分离
插件代码（addons/）需作为只读层打包进镜像，而插件运行时产生的缓存、日志、模板编译文件必须指向容器内可写路径。
在 Dockerfile 中设置环境变量：ENV TP_RUNTIME_PATH=/var/www/runtime
在 docker-compose.yml 的服务定义下添加卷挂载：volumes: - tp-runtime:/var/www/runtime，并确保该命名卷已通过 docker volume create tp-runtime 创建。
【addons/ 目录不可挂载为宿主机目录】否则插件启用/禁用状态会因容器重启丢失，且不同 Pod 实例间无法同步插件生命周期状态。
插件 URL 生成必须适配反向代理
ThinkPHP 插件内调用 url()、url('admin/index/index') 等函数时，默认从 $_SERVER['HTTPS'] 和 $_SERVER['HTTP_HOST'] 取值——这些在容器内始终是内部 HTTP 请求，不反映真实客户端协议与域名。
第一步：在 public/index.php 顶部插入代理头识别逻辑（早于 App::run()）：
if (isset($_SERVER['HTTP_X_FORWARDED_PROTO']) && $_SERVER['HTTP_X_FORWARDED_PROTO'] === 'https') { $_SERVER['HTTPS'] = 'on'; }
if (isset($_SERVER['HTTP_X_FORWARDED_HOST'])) { $_SERVER['HTTP_HOST'] = $_SERVER['HTTP_X_FORWARDED_HOST']; }
第二步：在 config/app.php 中启用可信代理，并限定信任范围：
'trust_proxy' => true,
'trusted_proxies' => ['10.0.0.0/8', '172.16.0.0/12', '192.168.0.0/16'],
'url_domain_deploy' => true
第三步：通过环境变量注入 baseDomain，例如在 docker-compose.yml 中写 env_file: .env，其中包含 APP_BASE_DOMAIN=https://myapp.example.com
插件配置必须支持环境变量覆盖
插件自身的 config.php（如 addons/wechat/config.php）不能硬编码数据库地址、API 密钥等敏感项，否则无法在测试/生产环境切换。
方法一：改用 env() 函数动态读取
return [
'app_id' => env('WECHAT_APP_ID', 'default_id'),
'secret' => env('WECHAT_SECRET', ''),
];
方法二：在插件的 Plugin.php 的 install() 方法中，检查环境变量是否存在，若缺失则抛出异常终止启用流程，避免静默失败。
注意：.env 文件必须挂载进容器，且路径在容器内为 /var/www/.env；不要用 COPY .env 到镜像，否则构建时就固化了配置。
多应用插件必须拆分为独立服务
当插件提供完整子系统能力（如独立后台管理、小程序 API 接口），不应塞进主应用的 addons/ 下共享同一入口和容器进程，否则无法独立扩缩容、健康检查失效、发布相互阻塞。
将插件重构为独立 ThinkPHP 应用：新建目录 api-wechat/，用 composer create-project topthink/think 初始化，再迁移原插件的 controller/model/service。
在该子应用的 config/app.php 中关闭多应用模式：
'app_multi_module' => false,
'default_app' => 'api-wechat'
在 Kubernetes 中为其单独定义 Deployment + Service + Ingress，Ingress path 规则设为 /wechat-api/ → api-wechat:80，由 Nginx 重写 URI 后转发。
主应用中移除对该插件的任何路由绑定、钩子监听或服务注册代码，仅保留前端页面中的 /wechat-api/ 接口调用地址。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
