必须用composer create-project安装，禁用手动解压；先验php -v≥7.2.5和composer --version，再执行composer create-project topthink/think tp，Web服务器根目录须指向public子目录。
在Windows 10或11系统上安装ThinkPHP框架，必须避开手动解压ZIP包这种已失效的旧方式——官方自TP6起彻底停供一键包，漏掉vendor目录会导致Class 'think\App' not found报错，项目根本无法启动。
确认前置环境是否就绪
打开命令提示符（Win + R → 输入cmd → 回车），依次执行以下两条命令：
php -v → 查看输出是否含PHP 7.2.5及以上版本号；若提示“不是内部或外部命令”，说明PHP未正确配置PATH环境变量，需先完成PHP安装与路径注册。
composer --version → 必须返回版本号（如Composer version 2.7.7）；若报错，说明Composer未安装或PHP路径未被识别，不能跳过此步直接装框架。
立即学习“PHP免费学习笔记（深入）”；
【务必确保这两条命令均能正常返回结果，否则后续所有操作都会失败】
用Composer创建ThinkPHP项目
方法一：标准命令行安装（推荐）
第一步：在资源管理器中打开你打算存放项目的文件夹（例如D:\www），空白处按住Shift + 右键 → 选择“在此处打开Powershell窗口”或“在此处打开命令窗口”。
第二步：输入命令并回车：composer create-project topthink/think tp。tp是生成的项目文件夹名，可改成任意英文名称（如myapp），但不能含空格或中文。
第三步：等待下载与解包完成（约1–3分钟）。过程中若卡在“Installing dependencies from lock file”，属正常现象；若超时中断，可能是源速度慢，可临时切换国内镜像：composer config -g repo.packagist https://mirrors.aliyun.com/composer/，再重试create-project命令。
方法二：指定ThinkPHP 6.x特定小版本（适合生产环境锁定）
执行：composer create-project topthink/think tp "6.3.*"。引号内版本号必须与GitHub Release页最新稳定版一致，不可写6.3.0或6.3.00。
Windows下关键权限与路径处理
安装完成后，立即检查runtime目录是否可写：进入tp目录 → 找到runtime文件夹 → 右键→属性→安全→编辑→勾选当前用户“完全控制”权限。IIS或Apache默认以IUSR或SYSTEM身份运行，不设此权限会导致日志写入失败、缓存无法生成、页面白屏。
若使用WAMP/XAMPP集成环境，还需确认Apache虚拟主机配置中已启用AllowOverride All，否则public/.htaccess伪静态规则不生效，访问index.php以外的URL会404。
不要把项目放在C:\Users\用户名\Documents这类有空格或特殊权限控制的路径下——Composer在解析路径时可能因反斜杠转义异常导致autoload失败。
验证ThinkPHP是否运行成功
方法一：用PHP内置服务器快速测试（无需Apache/Nginx）
进入tp目录 → 执行：php think run → 浏览器访问http://127.0.0.1:8000。看到ThinkPHP默认欢迎页即成功。
方法二：通过Web服务器访问
将tp目录下的public文件夹设为Web根目录（例如Apache的DocumentRoot指向D:/www/tp/public），然后访问http://localhost。注意：必须指向public子目录，而非tp根目录，否则入口文件暴露且安全风险极高。
执行php think version可查看当前框架精确版本及构建时间戳，这是最轻量的健康检查指令。
