ThinkPHP搭建关键在环境确认、目录指向、配置生效三环节：需验证PHP版本及mbstring等四扩展，用create-project命令创建项目，Web服务器根目录必须设为public/，并手动运行迁移和种子命令启用登录页与数据库。
ThinkPHP 搭建不是“下载解压就能用”，关键在环境确认、目录指向、配置生效三个环节。跳过任一环节，轻则 404、白屏，重则登录失败、接口全 403。
环境准备：先看 PHP 版本和扩展
打开终端执行：
php -v —— 确认 ≥8.0.0（TP8）或 ≥7.2.5（TP6/7）；
php -m | grep -E 'mbstring|openssl|pdo|fileinfo' —— 四个扩展缺一不可。
若缺失，编辑 php.ini，取消对应 extension=xxx 行前的分号，然后重启 Apache/Nginx 或 php-fpm。
项目创建：必须用 create-project，不能 require
进入 Web 服务器根目录（如 /var/www/html 或 XAMPP/htdocs），再运行：
composer create-project topthink/think tp8
注意：
- 不要在桌面、Downloads 或已有项目里执行；
- tp8 是你自定义的项目文件夹名，可改；
- 不要用 composer require topthink/think，它只装核心类，不生成 public 入口和命令行工具，必报错。
Web 服务配置：public 必须是根目录
这是新手最常翻车的点：
- Apache：虚拟主机配置中 DocumentRoot 必须指向 tp8/public，且启用 AllowOverride All；
- Nginx：location 块内用 try_files $uri $uri/ /index.php?$query_string;；
- 本地快速验证：进项目根目录，执行 php think run，访问 http://localhost:8000 即可。
基础功能启用：登录页和数据库要手动激活
安装完不能直接访问登录页，因为：
- 用户表还没建：执行 php think migrate:run；
- 初始账号没插入：执行 php think seed:run；
- 路由或控制器未注册：默认无 /admin/login，需手动创建控制器并绑定路由；
- 若用 .env 配置数据库，确保已重命名 .env.example 为 .env，并填写 DB_HOST、DB_NAME 等，且 runtime/ 目录可写。
