thinkphp 6+ 必须用 composer create-project 全局安装，而非 require；需配置国内镜像、确保 php ≥ 7.2 及扩展启用、设 public 为 web 根目录、runtime 可写，并验证 php think run 能正常启动。
如果您尝试安装 ThinkPHP 框架，但执行 composer require topthink/think 后项目无法运行或报错 Class 'think\App' not found，则说明未采用正确的全局初始化方式。ThinkPHP 6+ 及后续版本必须通过 create-project 命令完成全局项目级安装，而非局部引入依赖。以下是多种可行的全局安装方法：
一、使用 create-project 命令创建完整项目结构
该方法是官方唯一推荐的全局安装方式，它会自动下载框架骨架、生成 app/、config/、public/、runtime/ 等标准目录，并执行 post-create-project-cmd 脚本（如初始化 .env、设置权限），确保项目开箱即用。
1、在目标空目录下打开终端，执行：composer create-project topthink/think tp-demo
2、若需指定 ThinkPHP 版本（例如 TP 6.1 LTS），执行：composer create-project "topthink/think:^6.1" tp-demo
3、安装完成后，进入 tp-demo 目录，确认 public/ 为 Web 服务器 root 目录，否则将导致 404 错误
4、检查 runtime/ 目录是否具备写入权限：Linux/macOS 执行 chmod -R 755 runtime/；Windows 用户需确保 IIS 或 Apache 运行账户对该目录有修改权限
二、配置国内镜像源加速全局安装过程
因 Packagist 官方源同步延迟或网络限制，国内用户常遇 could not find package topthink/think 错误。切换至稳定镜像可绕过此问题，且不影响后续全局命令调用。
1、清除本地缓存以避免源污染：composer clear-cache
2、查看当前全局源配置：composer config -g repo.packagist
3、若输出非 https://packagist.org，重置为官方源：composer config -g repo.packagist https://packagist.org
4、临时切换至阿里云镜像（推荐）：composer config -g repo.packagist https://mirrors.aliyun.com/composer/
5、执行完安装后，可切回官方源：composer config -g repo.packagist https://packagist.org
三、验证并修复 Composer 全局可用性
全局安装失败常源于 Composer 未正确注册至系统 PATH，导致终端任意路径下无法识别 composer 命令。此步骤确保所有后续操作均基于可用的全局环境。
1、检查 Composer 是否已全局生效：composer --version，若提示 command not found，则需补全路径配置
2、Linux/macOS 用户执行：export PATH="$HOME/.composer/vendor/bin:$PATH"（临时生效），或写入 ~/.bashrc / ~/.zshrc 实现永久生效
3、Windows 用户需将 %USERPROFILE%\AppData\Roaming\Composer\vendor\bin 添加至系统环境变量 Path
4、验证 PHP CLI 版本与 ThinkPHP 要求匹配：php -v，TP 6.x 需 PHP ≥ 7.2，TP 7.x 需 PHP ≥ 8.1
5、确认 openssl、pdo、mbstring 等扩展已启用：检查 php.ini 中对应 extension= 行前无分号，且 ext 目录存在对应 .dll 或 .so 文件
四、处理 create-project 后 php think 命令失效问题
即使项目结构完整，php think 命令仍可能因权限或执行环境异常而中断。该步骤专用于恢复框架命令行工具的全局可调用状态。
1、检查 think 文件权限：ls -l think，若无 x 标志，执行：chmod +x think
2、确认当前终端调用的是系统默认 PHP：which php，避免 MAMP/XAMPP 等集成环境导致 CLI 与 Web 使用不同 PHP 实例
3、Windows 用户禁止双击运行 think 文件，必须在命令行中显式执行：php think
4、若提示 ParseError 或 Unknown named parameter，立即检查 PHP 版本是否低于框架最低要求
5、运行 php think run 启动内置服务器，访问 http://localhost:8000 验证首页是否正常渲染
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
