composer create-project 命令不支持直接安装到绝对路径，必须先 cd 到目标父目录（如 /var/www/html），再执行 composer create-project topthink/think=5.0.24 myapp --prefer-dist；TP5 要求 Web 服务器 DocumentRoot 必须指向 myapp/public，因 index.php 硬编码依赖上层目录结构，不可重命名或移动 public。
composer create-project 命令本身不支持「安装到指定 Web 子目录」（比如 /var/www/html/myapp）的同时自动配置好入口路径，它只负责把项目克隆到你当前终端所在位置的某个子目录里。想让 TP5 在非根路径下正常访问，关键不是改命令参数，而是控制执行命令时的当前工作目录 + 理解 public 目录的定位逻辑。
执行 composer create-project 前必须 cd 到目标父目录
很多人输完命令发现项目被建在了桌面或用户主目录，是因为没先 cd 进 Web 根目录。TP5 的 public 入口设计决定了：它必须被 Web 服务器直接映射为文档根（DocumentRoot），而不是放在子路径里靠 rewrite 拼凑。
- 正确做法：先切换到你的 Web 服务器实际根目录（如
/var/www/html或C:\wamp64\www），再运行命令 - 错误做法：在任意路径下运行
composer create-project topthink/think myapp，然后试图用http://localhost/myapp/public/访问——这会触发跨域资源加载失败、路由解析错乱、静态文件 404 等问题 - Windows 下常见陷阱：
cd C:\wamp64\www后运行命令，生成的myapp文件夹就在www下，此时应访问http://localhost/myapp/public/——但注意，这是「Web 路径」，不是「文件系统路径」；Apache/Nginx 必须把DocumentRoot指向myapp/public，而非www
--prefer-dist 和 =5.0.* 版本约束要写对
TP5 官方已停止维护 5.0.x 分支（2023 年起），但很多老项目仍依赖它。如果直接用 topthink/think 不加版本约束，Composer 会拉取 6.x 或更高版（不兼容），导致 base.php 找不到、think 命令失效等错误。
- 明确锁定 5.0 最后稳定版：
composer create-project topthink/think=5.0.24 myapp --prefer-dist -
--prefer-dist强制从压缩包安装（快且干净），避免 git clone 导致的thinkphp子模块缺失问题（尤其用 git 方式安装时容易漏掉 framework 仓库） - 不要用
dev-master：TP5 的 master 分支早已切到 6.x，dev-master会拉取完全不兼容的代码
为什么不能用 composer create-project ... /full/path/to/myapp？
Composer 不接受绝对路径作为项目名参数。命令末尾的 myapp 只是相对路径名，它永远基于你当前所在的 shell 目录。试图写成 composer create-project ... /var/www/html/myapp 会报错：[InvalidArgumentException] Project directory "/var/www/html/myapp" is not empty. 或直接忽略斜杠当成文件名。
立即学习“PHP免费学习笔记（深入）”；
- 唯一可靠方式：先
cd /var/www/html，再composer create-project topthink/think=5.0.24 myapp --prefer-dist - 若需批量创建多个项目，可用 shell 循环：
for d in app1 app2 app3; do cd /var/www/html && composer create-project topthink/think=5.0.24 $d --prefer-dist; done - Windows 下注意路径分隔符不影响命令，但 PowerShell 里用
cd C:\wamp64\www后执行即可，无需转义
public 目录不能被重命名或移动
TP5 的 index.php 里硬编码了上层目录结构：require __DIR__.'/../thinkphp/base.php';。一旦你把 public 改名为 web 或挪到其他层级，就会立即报 failed to open stream: No such file or directory 错误，就像 git 安装时漏掉 thinkphp 目录那样。
- 不要尝试修改
public名称：它不是配置项，是框架启动链的固定环节 - 虚拟主机配置中
DocumentRoot必须指向/path/to/myapp/public，而不是/path/to/myapp - Apache 的
.htaccess和 Nginx 的try_files规则都默认适配public路径，换名等于全量重写所有 Web 服务器配置
真正卡住人的从来不是命令怎么写，而是没意识到：TP5 的 public 不是“可选入口”，它是整个请求生命周期的起点和唯一可信边界。任何绕过它的路径操作，都会在调试阶段集中爆发为看似随机的加载失败。
