10分钟可跑通ThinkPHP欢迎页，30分钟写出首个路由页面，1小时连通数据库并展示数据；关键需确保PHP环境、.env配置正确及控制器命名规范。
新手搭建一个可运行的 ThinkPHP 网站，从零开始到首页显示欢迎页，最快 10 分钟内就能完成；但要能独立开发带数据库、表单、路由和基础交互的完整功能模块（比如用户列表页），通常需要 2～4 周持续实操，每天投入 1.5 小时以上。
第一步：10分钟跑通欢迎页（环境+骨架）
这不是“学完再动手”，而是用一条命令跳过配置陷阱：
- 确认 PHP ≥ 8.0，且
mbstring、openssl、pdo、fileinfo四个扩展真实启用（运行php -m检查，别只看php -v） - 执行：
composer create-project topthink/think mysite（自动拉取完整项目结构，含app/、public/、think入口） - 进入目录：
cd mysite，再运行：php think run - 浏览器打开 https://www.php.cn/link/f0838b2ebfc6440a474eabdc326bf31a ——看到 “ThinkPHP V8.x” 欢迎页，即成功
第二步：30分钟写出第一个可用页面（路由+控制器）
不用写视图也能返回内容，快速验证逻辑链路：
- 生成控制器：
php think make:controller Hello（自动生成app/controller/Hello.php） - 编辑该文件，在
index()方法中写：return 'Hello, World!'; - 在
app/route.php中添加：Route::get('hello', 'Hello/index'); - 访问 https://www.php.cn/link/f0838b2ebfc6440a474eabdc326bf31a/hello，立刻看到返回结果
第三步：1小时连上数据库并展示数据（模型+查询）
避免卡在配置里反复试错，直接用 .env 文件驱动：
立即学习“PHP免费学习笔记（深入）”；
- 在项目根目录新建
.env，填入数据库信息（注意端口、密码空值也要写DB_PWD=）：DATABASE_URL=mysql://root:@127.0.0.1:3306/testdb - 生成模型：
php think make:model User（对应user表） - 在控制器里调用：
return User::select();或Db::name('user')->select(); - 若报错，先执行
php think route:list确认路由生效，再用try { Db::query('SELECT 1'); }快速验证连接
关键避坑提醒
新手最常浪费时间的地方，其实就三个：
-
Web 根目录指向错误：必须让服务器（或 php think run）指向
public/目录，不是项目根目录 -
.env 文件位置或格式错：必须放在项目根目录，不能是
config/.env；等号前后不要空格；空密码写成DB_PWD= -
控制器命名不规范：文件名
User.php→ 类名必须是User，命名空间固定为app\controller，方法必须是public
