ThinkPHP项目部署到子目录_如何配置路由与资源路径映射-ThinkPHP-PHP中文网

ThinkPHP 6 子目录部署需手动设置 base path：在 public/index.php 中定义 APP_BASE_PATH 并配置 config/app.php 的 app_url 和 app_host，同时正确配置 Web 服务器的 RewriteBase（Apache）或 location（Nginx），并清理 runtime 缓存确保路径一致。

thinkphp项目部署到子目录_如何配置路由与资源路径映射

ThinkPHP 6 部署到子目录时 public 目录不能直接放在根目录下

如果你把整个 ThinkPHP 项目（含 public 目录）扔进服务器的 /var/www/html/myapp/，而网站实际访问地址是 https://example.com/myapp/，那么默认情况下所有资源路径（CSS、JS、图片）和路由都会 404。根本原因不是路由没配好，而是框架压根不知道自己运行在子目录里。

关键动作是：必须让 public/index.php 正确识别当前 URL 的子目录前缀，并将它作为 base path 注入请求上下文。ThinkPHP 6 默认使用 $_SERVER['SCRIPT_NAME'] 推导，但它在 Apache + mod_rewrite 或 Nginx 下常被截断，导致路径计算错误。

实操建议：

在 public/index.php 开头（require __DIR__.'/../vendor/autoload.php'; 之前）手动设置 $_SERVER['SCRIPT_NAME']，例如：
```
$_SERVER['SCRIPT_NAME'] = '/myapp/public/index.php';
```
或者更稳妥地，在 public/index.php 中显式传入 base path：
```
define('APP_BASE_PATH', '/myapp/');
```
，然后在 config/app.php 中用该常量覆盖 'app_host' => '' 和 'base_url' => APP_BASE_PATH
不要依赖 url() 函数自动补前缀——它只在正确识别 base path 后才可靠

静态资源路径（CSS/JS/IMG）全部 404 的真正原因

不是文件没放对位置，而是 public 目录被当成了 Web 根目录，但实际 Web 根是上层目录。浏览器请求 /static/js/app.js，服务器却在 /var/www/html/static/js/app.js 找，而不是 /var/www/html/myapp/public/static/js/app.js。

解决方式取决于 Web 服务器配置，而非 PHP 代码：

Apache：确保 .htaccess 中的 RewriteBase 设置为 /myapp/，且开启 AllowOverride All
Nginx：在 server 块中用 location /myapp/ 匹配，并把 root 指向 /var/www/html/myapp/public，同时加 try_files $uri $uri/ /myapp/index.php?$query_string;
不改服务器？那就把所有资源链接硬编码加前缀：，并确保 config/app.php 中 'app_url' => 'https://example.com/myapp'

路由生成（url()）返回的链接缺少子目录前缀

url('index/index') 返回 /index/index 而不是 /myapp/index/index，说明框架未将子目录纳入 URL 构建逻辑。这通常是因为 Request 对象的 baseUrl() 方法返回空或错误值。

Skill Weave Chains — 技能链路由引擎

开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。

下载

验证方法：在控制器里 dump request()->baseUrl()，如果输出为空或 /，就确认是 base path 丢失。

修复要点：

确保 public/index.php 中已定义 APP_BASE_PATH，并在 config/app.php 中设置：
```
'app_url' => env('APP_URL', 'https://example.com/myapp'),
```
禁用「自动识别域名」：在 config/app.php 中设 'app_host' => 'example.com'，避免因 Host 头异常干扰 base path 推导
若用 Swoole 或 Hyperf 兼容模式部署，需额外在 server.php 中手动注入 SCRIPT_NAME 和 PATH_INFO

子目录部署后接口返回 500 但日志无记录

常见于 public/index.php 中加载自动加载器失败，或 runtime 目录权限不对——但更隐蔽的原因是：子目录路径参与了缓存键计算，导致 config_cache.php 生成时用了错误的绝对路径，后续所有配置读取都失败。

排查步骤：

清空 runtime/cache/ 和 runtime/config/，再访问一次触发重新生成
检查 runtime 目录是否可写，且其父目录（myapp/runtime）的 owner 是 Web 进程用户（如 www-data）
临时在 public/index.php 开头加 error_reporting(E_ALL); ini_set('display_errors', '1');，看是否报 Class 'think\App' not found —— 若是，说明 vendor/autoload.php 路径错了，应改为 require __DIR__.'/../vendor/autoload.php';（注意是两个点）