ThinkPHP运行目录(public)指向变更对生产环境的影响

public 目录被挪动后，Nginx 404 或直接暴露 index.php

ThinkPHP 默认要求 public 是 Web 服务器的根目录（DocumentRoot），否则静态资源（css、js、images）路径全错，且 index.php 可能被当成普通文件下载或 404。常见错误现象是首页能打开但样式丢失、AJAX 接口返回 404、或者访问 /index.php/route 报 500（因为 $_SERVER[‘SCRIPT_NAME’] 和实际路径不匹配）。

解决关键是让 Web 服务器「假装」public 还在原位，哪怕它物理位置变了：

Nginx 必须把 root 指向新 public 路径，不能只改 alias；否则 try_files $uri $uri/ /index.php?$query_string 会找不到 index.phpApache 需确保 .htaccess 文件仍在新 public 目录下，且 AllowOverride All 已启用；否则重写规则失效，所有路由都 fallback 到 404如果用 Swoole 或 RoadRunner，public 路径变更不影响运行时，但必须同步更新 server.php 中的 static_handler 配置指向新路径，否则静态资源 404

APP_PATH 和 RUNTIME_PATH 的路径依赖没同步更新

ThinkPHP 启动时靠 public/index.php 里的 define(‘APP_PATH’, __DIR__ . ‘/../app/’); 定位应用目录。一旦 public 移动，这个相对路径就断了——常见错误是报 require(): Failed opening required ‘…/app/common.php’ 或 RuntimeException: Can’t write cache file。

必须手动修正这些常量定义：

立即学习“PHP免费学习笔记（深入）”；

APP_PATH 要按新 public 位置重新计算，比如新 public 在 /var/www/myapp/web/，那 APP_PATH 就该是 /var/www/myapp/app/RUNTIME_PATH 建议绝对路径，避免依赖相对定位；尤其注意磁盘权限：Web 进程用户（如 www-data）必须有写入权限，否则日志、缓存、模板编译全失败别漏掉 EXTEND_PATH 和 VENDOR_PATH（如果自定义过），它们同样受 public 位置影响

URL 生成函数（url()、Url::build()）输出路径异常

ThinkPHP 的 URL 生成依赖 request()->root()，而它默认从 $_SERVER[‘SCRIPT_NAME’] 和当前请求 URI 推导。一旦 public 不再是 Web 根目录，root() 就会算错，导致 url(‘index/hello’) 输出 /index/hello（少了一层子路径）或 /public/index/hello（多了一层）。

修复方式不是改函数调用，而是配置运行时上下文：

在 public/index.php 开头加 $_SERVER[‘SCRIPT_NAME’] = ‘/subdir/index.php’;（若部署在子目录）或在 config/app.php 中显式设置 ‘url_domain_root’ => ‘/subdir’（适用于 Nginx alias 或子目录部署）更稳妥的做法是用 Url::build() 时传 [‘domain’ => true] 强制带域名，避免路径推导干扰

CDN 或反向代理下静态资源 404 或缓存错乱

生产环境常配 CDN 或 Nginx 缓存静态资源，但 public 路径一变，CDN 的缓存 Key（比如基于 URI 路径）就和源站实际文件路径对不上。典型表现是刷新页面 CSS 不生效、图片显示为 404，但直连源站正常。

关键不是清 CDN 缓存，而是确认源站响应头和路径一致性：

检查 Nginx 是否把 public/static/ 映射到了正确物理路径，且 location ~* \.(js|css|png|jpg)$ 块里没有遗漏 root 或 alias 配置确认 ThinkPHP 的 __STATIC__ 模板变量是否仍指向正确 URL（它由 request()->root() 决定，同上一个问题）如果用了版本号控制（如 static/css/app.css?v=123），确保构建脚本生成的哈希值对应的是新 public 下的真实文件，而不是旧路径残留的缓存

路径变更本身不难，难的是所有隐式依赖它的环节：Web 服务器配置、PHP 常量、URL 推导逻辑、CDN 缓存策略、甚至运维部署脚本——漏掉任意一个，线上就出半截问题。