ThinkPHP本地环境搭建核心在于项目结构、PHP版本、Web服务器指向public目录和.env加载时机四环节严丝合缝：必须用composer create-project初始化完整项目，PHP≥7.2.5且CLI与Web端版本一致，Web服务器DocumentRoot或root必须指向public/，.env需取消APP_DEBUG=true注释并重启服务。
ThinkPHP本地环境搭建不是“装个软件点下一步”就能完事，核心在于项目结构、PHP版本、Web服务器指向和环境加载时机四个环节严丝合缝。漏掉任何一环，轻则白屏报错，重则配置被外部直接访问。
第一步：用 Composer 创建完整项目结构
别解压 ZIP，也别用 composer require —— 那只会拉取半截框架，缺入口文件、缺命令脚本、缺路由支持，必然报 Class 'think\App' not found 或 404。
- 确保已安装 Composer（运行
composer --version验证） - 在空目录下执行（TP6 推荐稳定版）：
composer create-project "topthink/think:^6.1" myapp - 完成后进入
myapp/目录，确认存在think文件、public/目录和根目录下的.env
第二步：检查并统一 PHP 环境
TP6 要求 PHP ≥ 7.2.5，但强烈建议使用 PHP 8.0+；更要命的是，CLI 命令行用的 PHP 版本必须和 Web 服务器用的一致，否则 php think 正常，浏览器却报错。
- 终端执行：
php -v查 CLI 版本；访问http://localhost/phpinfo.php查 Web 版本 - Windows 用户常见陷阱：PATH 里有多个 PHP，CMD 默认调用旧版。用
where php查路径，删掉冲突项 - 必须启用扩展：
mbstring、openssl、pdo_mysql（或pdo_sqlite），在php.ini中取消对应行前的分号
第三步：Web 服务器必须指向 public/ 目录
这是 ThinkPHP 单入口设计的硬性要求。映射到项目根目录 = 暴露 config/、app/、.env，且静态资源 404、路由全失效。
立即学习“PHP免费学习笔记（深入）”；
-
Apache：修改虚拟主机配置，
DocumentRoot和<directory></directory>全部指向/path/to/myapp/public，并设AllowOverride All -
Nginx：
root指向/path/to/myapp/public，且关键配置不能少：fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; -
开发偷懒法：直接在项目根目录运行：
php -S localhost:8000 -t public/（注意-t public/不可省）
第四步：激活调试 + 确认 .env 生效
.env 文件默认所有配置项都被注释，不手动开启就等于没配——你改了数据库密码，但框架根本读不到，只给你一个空白页或 500 错误。
- 打开根目录
.env，取消这行注释：APP_DEBUG=true - 数据库配置写成扁平格式：
DB_HOST=127.0.0.1<br>DB_NAME=mydb<br>DB_USER=root<br>DB_PWD=123456
- 改完必须重启服务：
用php think run的要Ctrl+C再重跑；
用 Apache/Nginx 的要重启服务；
Linux/macOS 还要检查.env权限是否允许 Web 用户读取
