ThinkPHP入门到精通全教程，从环境搭建到项目实战
本教程围绕ThinkPHP框架打造，从零基础入门到精通全流程讲解，开篇指导搭建本地开发环境，涵盖PHP运行环境配置、Composer工具安装及ThinkPHP框架初始化部署，随后系统讲解路由规则、控制器逻辑、数据库模型、视图渲染等核心基础内容，再进阶介绍中间件、缓存机制、权限控制等高级特性，最后通过完整项目实战，带领学习者融会贯通所学知识，独立完成可上线的Web项目，适合PHP开发新手及想进阶框架开发的开发者系统学习。TP教程是什么意思，ThinkPHP入门到精通全教程，从环境搭建到项目实战
本文中的TP指的是国内主流的PHP开发框架ThinkPHP,它是一款高效、开源的MVC架构PHP框架，凭借中文文档完善、生态成熟、学习门槛低的优势，成为国内中小企业和开发者搭建Web应用的首选框架之一，无论你是零基础的编程新手，还是有一定PHP基础的开发者，通过本教程都能快速掌握ThinkPHP的核心用法，从环境配置到实战开发形成完整的知识体系。
第一章：环境准备与ThinkPHP安装
1 开发环境搭建
开发ThinkPHP项目前,我们需要先搭建PHP运行环境，目前主流的搭建方式有两种：
集成环境包（适合新手）
推荐使用XAMPP、WAMP或Laragon这类集成包，一键安装Apache/Nginx、PHP、MySQL三大组件，以XAMPP为例：
- 前往XAMPP官方网站下载对应系统的安装包,运行安装程序后按照向导完成安装；
- 打开XAMPP控制面板,启动Apache和MySQL模块；
- 访问
http://localhost看到XAMPP欢迎页面，证明环境搭建成功。Composer全局安装（专业开发者首选）
Composer是PHP的依赖管理工具,ThinkPHP官方推荐通过Composer安装和管理项目依赖，首先需要安装Composer：
- 前往Composer中文网下载安装包,完成安装后在终端输入
composer -V，能看到版本信息即安装成功。
2 ThinkPHP框架安装
目前ThinkPHP最新稳定版为TP8,我们可以通过两种方式安装：
传统下载安装
前往ThinkPHP官方GitHub仓库下载最新的安装包,解压后将文件移动到网站根目录即可，不过这种方式无法快速管理依赖包，更推荐使用Composer安装。
Composer在线安装
打开终端,进入你想要创建项目的目录，执行以下命令：
composer create-project topthink/think tp8
等待安装完成后,会在当前目录生成名为tp8的项目文件夹，这就是我们的ThinkPHP8项目。
3 项目启动与首次访问
进入项目目录,执行内置服务器启动命令：
cd tp8 php think run
终端会显示Server running on http://0.0.0.0:8000，在浏览器访问该地址，能看到ThinkPHP官方欢迎页面，证明项目安装成功。
第二章：TP核心架构与基础语法
1 项目目录结构详解
ThinkPHP的目录设计遵循MVC开发模式,核心目录功能如下：
| 目录名 | 功能说明 |
|--------------|--------------------------------------------------------------------------|
| app/ | 业务代码核心目录，包含控制器、模型、视图、验证器等业务文件 |
| config/ | 项目配置文件目录，包含数据库、路由、缓存等全局配置 |
| public/ | 项目入口目录，包含唯一的入口文件index.php和静态资源文件 |
| runtime/ | 框架运行时缓存、日志文件目录，默认自动生成，无需手动管理 |
| vendor/ | Composer安装的第三方依赖包目录 |
2 路由配置与使用
ThinkPHP支持多种路由定义方式,最常用的是配置文件路由和注解路由，我们以配置文件路由为例：
打开route/app.php文件，这是全局路由配置文件，我们可以在这里定义所有接口和页面路由。
比如定义一个简单的测试路由：
use think\facade\Route;
// 定义GET请求路由，访问/test时执行Test控制器的index方法
Route::get('test', 'Test/index');
接下来我们需要创建对应的控制器文件,在app/controller/目录下新建Test.php：
<?php
namespace app\controller;
class Test
{
public function index()
{
return 'Hello ThinkPHP8! 这是我的第一个TP页面';
}
}
重新启动项目服务,访问http://localhost:8000/test就能看到输出的文字内容。
3 控制器与业务逻辑
控制器是处理用户请求的核心入口,所有业务逻辑都可以在控制器中完成，除了基础的返回文本，我们还可以返回JSON数据、渲染视图页面等。 比如创建一个用户列表页面的控制器：
<?php
namespace app\controller;
use app\model\User;
class UserController
{
// 用户列表页面
public function list()
{
// 查询数据库中的用户数据
$userList = User::order('id', 'desc')->select();
// 将数据传递到视图页面
return view('user/list', [
'userList' => $userList,
'title' => '用户管理列表'
]);
}
}
4 模型与数据库操作
ThinkPHP内置了完善的ORM模型系统,可以快速完成数据库的增删改查操作，无需手动编写SQL语句。
第一步：配置数据库连接
在项目根目录的.env文件中配置数据库信息：
[DATABASE] TYPE = mysql HOSTNAME = 127.0.0.1 DATABASE = tp8_test USERNAME = root PASSWORD = HOSTPORT = 3306 CHARSET = utf8mb4
第二步：创建模型文件
在app/model/目录下新建User.php模型文件，默认对应数据库中的user表：
<?php
namespace app\model;
use think\Model;
class User extends Model
{
// 可以自定义表名、主键等信息，默认无需额外配置
}
第三步：基础数据库操作
// 查询所有用户数据
$users = User::select();
// 根据ID查询单个用户
$user = User::find(1);
// 新增用户
User::create([
'username' => 'zhangsan',
'email' => 'zhangsan@example.com'
]);
// 更新用户数据
User::where('id', 1)->update(['username' => 'lisi']);
// 删除用户
User::destroy(1);