ThinkPHP快速使用手册

目录

介绍

安装（windows环境）

安装Composer

安装ThinkPHP

目录结构

配置文件

第一个接口（Controller层）

Hello World

 自定义Controller

请求参数

获取查询参数（Get请求）

获取指定请求参数 

获取所有URL的请求参数

获取json数据（Post）

获取JSON数据中的属性

一些问题

响应参数

路由

基础路由映射

 路由写法解析

模型（Model）

模型的定义

模型使用测试

模型的设置

设置表名

 设置主键

模型字段的设置

废弃字段

访问数据库 

数据库的连接

增删改查（CURD）

新增

删除 

更新/修改

查询

查询单条

获取多条数据

模糊查询

 多条件

 排序

聚合函数的使用

分页查询

原生查询

部署

部署前准备 

部署方式一：内置服务器直接启动  

部署方式二：使用Nginx服务器

最后

---

介绍

---

 官方介绍 

ThinkPHP是一个免费开源的，快速、简单的面向对象的轻量级PHP开发框架，是为了敏捷WEB应用开发和简化企业应用开发而诞生的。

ThinkPHP诞生十七年来一直秉承简洁实用的设计原则，在保持出色的性能和至简代码的同时，更注重易用性。

遵循Apache2开源许可协议发布，意味着你可以免费使用ThinkPHP，甚至允许把你基于ThinkPHP开发的应用开源或商业产品发布/销售。

---

本文章主要是针对已有其他后端开发框架基础的人群，如SpringBoot（Java），Express（NodeJS） 等。

这样，阅读本文章你就可以快速了解ThinkPHP框架如何ORM的与数据库做交互，提供访问接口。 

 ThinkPHP为MVC架构，但本文章不说明视图层（V），使用接口测试工具apifox来测试ThinkPHP创造出的接口。 

安装（windows环境）

安装Composer

我们安装ThinkPHP之前，要先去安装Composer。

为什么要安装composer?

因为ThinkPHP的下载需要通过Composer来进行

Composer是一个PHP的依赖管理工具，可以用于管理项目中的PHP库和包的依赖关系。

类似于NodeJS中的npm包管理器，也类似前端脚手架构建vue项目的Vite。

 安装步骤 

1. 下载Composer安装包

访问官方下载地址：Composer下载https://doc.thinkphp.cn/v8_0/setup.html

2. 执行下载的.exe安装引导程序，无脑下一步。

其中需要注意的勾选：

3. 检查安装结果：命令行输入composer。

看见输出就好了。

安装ThinkPHP

安装好了composer之后，我们就能使用composer"脚手架"来创建ThinkPHP基础项目了。 

使用脚手架去构建TP（ThinkPHP）基本项目需要下载代码、依赖包等文件，而Composer的下载服务器在国外，直接下载会很慢，因此我们可以配置一下国内的镜像源。

1. 安装前配置国内镜像：

命令：composer config -g repo.packagist composer 镜像源地址

阿里云: https://mirrors.aliyun.com/composer/ 

华为云: https://repo.huaweicloud.com/repository/php/

例如执行命令： 配置阿里国内镜像源

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

2. 切换到你PHP网站根目录（www目录）下执行安装命令：

composer create-project topthink/think tp6

命令是创建一个ThinkPHP项目。（tp6为根目录名称，可自定义）

这个操作类似于前端我们使用vite脚手架构建vue项目类似 。

3. 运行测试

cd进入刚创建的tp6目录，执行运行命令：php think run

看到输出信息：项目运行在了“内置服务器”的8000端口。

通过访问URL：localhost:8000 即可访问项目首页。

 

这样我们的ThinkPHP基本项目的构造就完成了。 

上面提到了“内置服务器”，是基于 PHP 内置的 CLI 开发服务器。

在本地开发调试的时候我们直接使用内置服务器是可行的。

但是在部署到生产环境的时候，建议还是要部署到Apache或Nginx上。

目录结构

上面说了Composer将像是一个脚手架帮我们去构建特定结构的ThinkPHP项目。

那么接下来我们就可以看看生成的这个项目结构长啥样。

目录还是不少，下面我会说明几个较为常用的说明：

1. app目录：是应用目录，我们就在这个目录进行编码，例如接口的编写。

2. config是配置目录，里面存放着各类配置文件，如数据库的配置。

3. public是公共目录，对外访问目录，像上面我们通过访问localhost:8000显示的页面就是这个目录中的index.php文件。

4. route是定义路由的目录，就是定义我们的接口URL以什么样子暴露出去让前端进行调用。

 更详细的目录和文件说明，我们可以访问官方文档进行查看：ThinkPHP目录结构

配置文件

脚手架构建的这个基础项目中的配置文件很多，目前我们可以就关注一个

就是“database.php”，顾名思义就是数据库连接的配置。

我们展开/config目录看看其中的各种配置文件。

总之，后续我们要配置一些参数，如数据库的连接参数，我们就到/config下找就好。

第一个接口（Controller层）

接下来，我们进行正题吧。

让我们一起来写出ThinkPHP的第一个"Hello World"接口 。

Hello World

打开文件controller/Index.php