thinkphp搭建需四大组件：php 8.0+（启用fileinfo、openssl等扩展）、web服务器（指向public目录）、数据库（pdo启用）、composer（配阿里云镜像），必须用create-project初始化项目，严禁require引入。
ThinkPHP 不是“装好就能用”的软件，它是一套需要完整工具链支撑的 PHP 框架。搭建一个可运行项目，关键不是下载代码，而是配齐环境、走对初始化流程、避开几个高发陷阱。
一、先配齐四大基础组件
缺一不可：PHP 解释器、Web 服务器、数据库、Composer。
- PHP 版本：ThinkPHP 8 要求 ≥ 8.0.0；TP6/7 推荐 ≥ 7.4，但建议直接用 PHP 8.0+（如 8.1 或 8.2），避免扩展兼容问题
-
Web 服务器：Apache 或 Nginx 均可，本地开发也可用 PHP 内置服务器（
php think run） -
数据库：MySQL 最常用，需确保已启动并创建好空库；PDO 扩展必须启用（
pdo和pdo_mysql） -
Composer：必须全局安装且能终端任意路径调用（执行
composer --version可验证）；国内用户建议临时切阿里云镜像：composer config -g repo.packagist https://mirrors.aliyun.com/composer/
二、用 create-project 创建完整项目
这是唯一正确起点。千万别用 composer require topthink/think，它只拉核心包，没有路由、命令行入口和 public 目录，必然报错 Class 'think\App' not found。
- 新建一个空文件夹，进入终端，执行：
composer create-project topthink/think myapp
（myapp是你的项目名，可自定义） - 如需指定版本（例如 TP6.1 LTS）：
composer create-project "topthink/think:^6.1" myapp - 安装完成后，确认目录结构含
app/、config/、public/、runtime/和根目录下的.env、think文件
三、关键配置与权限设置
很多 404、白屏、500 都卡在这步。
-
.env 文件必须启用调试：打开根目录
.env，取消APP_DEBUG=true前的注释（#），否则错误全被静默吞掉 -
数据库配置写在 .env，不是
config/database.php：DB_TYPE=mysql<br>DB_HOST=127.0.0.1<br>DB_NAME=your_db<br>DB_USER=root<br>DB_PWD=123456
注意：格式是扁平键名，不是嵌套数组 -
修改 .env 后清空缓存：删除
runtime/cache/和runtime/log/下所有内容，否则旧配置仍生效 -
runtime 目录必须可写：Linux/macOS 运行
chmod -R 755 runtime/；Windows 确保 Web 服务账户（如 IIS_IUSRS 或 www-data）有修改权限
四、Web 服务器必须指向 public 目录
这是最常被跳过、后果最严重的一环。若网站根目录设为项目根（含 app/、config/），则：
- .env 和 config/ 可被外部直接访问，存在严重安全风险
- index.php 找不到引导文件，报 404 或 “No input file specified”
- 静态资源（CSS/JS）全部 404，页面样式崩溃
正确做法：
-
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（不能漏掉$document_root） -
宝塔面板：网站设置 → 网站目录 → 运行目录选
/public -
本地快速测试：在项目根目录执行
php think run，默认访问http://127.0.0.1:8000
五、验证与排错小技巧
跑不起来？按顺序检查这几项：
- 当前终端是否在项目根目录下（即有
think文件的地方）？ - 执行
php think报 “Command not defined”？确认不是在app/或public/下误操作 - Linux/macOS 下
php think提示 Permission denied？运行chmod +x think - CLI 和 Web 使用的 PHP 版本是否一致？分别运行
php -v和查看 phpinfo() 对比 - 想确认 .env 是否加载成功？在
app/common.php开头加一行：var_dump($_ENV['APP_DEBUG'] ?? 'not loaded'); die;，访问页面看输出
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
