ThinkPHP不能用composer require安装，因其仅拉取核心类库，缺失public入口、app目录、think脚本及路由等关键文件，导致Class 'think\App' not found或404；必须用composer create-project初始化完整项目结构。
ThinkPHP 不能“安装”——它必须用 composer create-project 初始化一个完整项目结构，否则后续必报 Class 'think\App' not found 或 404。
为什么不能用 composer require topthink/think
这个命令只拉取框架核心类库，不生成 public/ 入口、app/ 应用目录、think 命令脚本，也不带路由和命令行支持。你得到的是一个“半截子”依赖，不是可运行的项目。
常见错误现象：
- 访问时直接 404，日志里反复出现
require(): Failed opening required '.../bootstrap.php' - 执行
php think make:controller报错Command "make:controller" is not defined - 把项目根目录设为 Web 根目录后，
.env和config/被外部直接访问
正确做法（在空目录中执行）：
立即学习“PHP免费学习笔记（深入）”；
-
composer create-project topthink/think tp8（tp8是项目文件夹名，可自定） - 如需指定版本，加
@8.0后缀：composer create-project topthink/think tp8@8.0 - 别在已有 Laravel/Symfony 项目里硬塞 ThinkPHP —— 自动加载和生命周期不兼容
Web 服务器必须指向 public/ 目录
这是 ThinkPHP 单入口模式的硬性要求。若映射到项目根目录，不仅暴露敏感配置，还会因找不到 public/index.php 导致启动失败。
配置要点：
- Apache：虚拟主机
DocumentRoot指向/path/to/tp8/public，并确保mod_rewrite已启用；.htaccess文件需存在且生效 - Nginx：server 块中用
try_files $uri $uri/ /index.php?$query_string;，且root指向/path/to/tp8/public - PHP 内置服务器（开发用）：
php think run自动处理，无需额外配置
容易踩的坑：
- 用 XAMPP/WAMP 直接把整个项目拖进
htdocs/，没改DocumentRoot→ 敏感文件泄露 + 白屏 - Apache 下
.htaccess不生效，因为AllowOverride None没改成All - Nginx 配置漏掉
fastcgi_param SCRIPT_FILENAME，导致$_SERVER['SCRIPT_NAME']错乱
.env 配置优先级高于 PHP 文件，但默认是注释状态
ThinkPHP 默认读取根目录下的 .env，但它只在 create-project 时生成一次，且所有关键项（数据库、调试开关）都被注释掉了。新手常把配置写进 config/database.php，结果完全不生效。
必须操作：
- 取消
APP_DEBUG=true的注释，否则任何错误都被静默吞掉，只剩白屏或 500 - 数据库写成扁平键名：
DB_TYPE=mysql、DB_HOST=127.0.0.1，不是database.type这种嵌套格式 - 改完
.env后，必须清空runtime/cache/，否则旧配置仍被缓存 - 确认
.env文件权限：Linux/macOS 下避免是root创建、www-data或_www用户无法读取
验证是否加载成功？在 app/common.php 加一行：var_dump($_ENV['APP_DEBUG'] ?? 'not loaded');，刷新页面看输出。
php think 命令跑不起来的几个真实原因
报 Command not found 或 Permission denied，往往不是命令拼错，而是环境链断裂。
排查顺序：
- 确认当前终端所在目录是项目根目录（含
think可执行脚本），不是app/或public/ - Linux/macOS 下检查权限：
ls -l think，若无x位，运行chmod +x think - 对比 CLI 和 Web 使用的 PHP 版本：
php -v和查看 phpinfo() 中的版本是否一致；共享主机常禁用exec()，此时php think会卡住 - 运行
php think version看是否输出框架版本，能过这关说明基础环境没问题
最常被忽略的一点：修改 .env 后，如果正在用 php think run，必须 Ctrl+C 终止再重跑，否则新配置不会加载。
整个流程里最脆弱的环节其实是路径和权限：PHP 版本不一致、.env 权限不对、Web 根目录设错、runtime/ 目录不可写——这些问题不会报具体错误，只会让你卡在白屏或 500，得一个个手动验证。
