thinkphp6-学习记录-应用手册

thinkphp6

  • ​​ThinkPHP6-开发学习整理 TP6 框架源码下载​​
  • ​​项目目录​​
  • ​​框架测试​​
  • ​​安装​​
  • ​​重点介绍​​
  • ​​TP6的架构详述-依赖注入​​
  • ​​容器与系统服务和门面​​
  • ​​中间件​​
  • ​​事件触发监听​​
  • ​​路由器详解​​
  • ​​主要特性:​​
  • ​​连接数据库​​
  • ​​配置文件​​
  • ​​连接参数​​
  • ​​切换连接​​
  • ​​模型类定义​​
  • ​​配置参数参考​​
  • ​​断线重连​​
  • ​​分布式数据库​​
  • ​​分布式支持​​
  • ​​读写分离​​
  • ​​主库读取​​
  • ​​查询构造器​​
  • ​​查询数据​​
  • ​​查询单个数据​​
  • ​​模型​​
  • ​​模型字段​​
  • ​​字段类型​​
  • ​​废弃字段​​
  • ​​获取数据​​
  • ​​模型赋值​​
  • ​​严格区分字段大小写​​
  • ​​模型数据转驼峰​​
  • ​​新增​​
  • ​​添加一条数据​​
  • ​​获取自增ID​​
  • ​​批量增加数据​​
  • ​​静态方法​​
  • ​​更新​​
  • ​​查找并更新​​
  • ​​批量更新数据​​
  • ​​直接更新(静态方法)​​
  • ​​自动识别​​
  • ​​删除​​
  • ​​删除当前模型​​
  • ​​根据主键删除​​
  • ​​条件删除​​
  • ​​查询​​
  • ​​获取单个数据​​
  • ​​获取多个数据​​
  • ​​自定义数据集对象​​
  • ​​使用查询构造器​​
  • ​​获取某个字段或者某个列的值​​
  • ​​动态查询​​
  • ​​聚合查询​​
  • ​​数据分批处理​​
  • ​​使用游标查询​​
composer update topthink/framework

ThinkPHP6-开发学习整理 TP6 框架源码下载

打开Composer官网:https://www.phpcomposer.com/
​​​ https://packagist.org/​​

输入搜索关键字: topthink, 在下面会列出与ThinkPHP框架相关的组件包
-project topthink/think

thinkphp6-学习记录-应用手册

// 打开终端,执行指令:

composer create-project topthink/think tp6 6.0.*-dev

/**

* 指令中各个参数的解释:

* `create-project`: 是composer中的项目创建命令

* `topthink/think`: ThinkPHP的组件包

* `tp6`: 是当前的项目目录(如果没有创建, 该命令会自动创建的)

* `6.0.*-dev`: 要下载的版本标签

*/

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

项目目录

thinkphp6-学习记录-应用手册

框架测试
,
功能与 php -S localhost:8000
创建本地服务器, 启动框架
php think run

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册




安装

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

重点介绍

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

TP6的架构详述-依赖注入

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

容器与系统服务和门面

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

中间件

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

事件触发监听

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

路由器详解

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

thinkphp6-学习记录-应用手册

数据库

新版的数据库和模型操作已经独立为​​ThinkORM库​​​,默认安装应用的时候会自动安装,如果你不需要使用该ORM库的话,可以单独卸载​​topthink/think-orm​​后安装其它的ORM库。

主要特性:

基于PDO和PHP强类型实现
支持原生查询和查询构造器
自动参数绑定和预查询
简洁易用的查询功能
强大灵活的模型用法
支持预载入关联查询和延迟关联查询
支持多数据库及动态切换
支持MongoDb
支持分布式及事务
支持断点重连
支持JSON查询
支持数据库日志
支持PSR-16缓存及PSR-3日志规范
要使用Db类必须使用门面方式(think\facade\Db)调用

连接数据库

如果应用需要使用数据库,必须​​配置数据库连接信息​​,数据库的配置文件有多种定义方式。

配置文件

在全局或者应用配置目录(不清楚配置目录位置的话参考配置章节)下面的​​database.php​​中(后面统称为数据库配置文件)配置下面的数据库参数:

return [
'default' => 'mysql',
'connections' => [
'mysql' => [
// 数据库类型
'type' => 'mysql',
// 服务器地址
'hostname' => '127.0.0.1',
// 数据库名
'database' => 'thinkphp',
// 数据库用户名
'username' => 'root',
// 数据库密码
'password' => '',
// 数据库连接端口
'hostport' => '',
// 数据库连接参数
'params' => [],
// 数据库编码默认采用utf8
'charset' => 'utf8',
// 数据库表前缀
'prefix' => 'think_',
],
],
];

新版采用​​多类型​​​的方式配置,方便​​切换数据库​​。

​default配置​​​用于设置​​默认使用​​​的​​数据库连接配置​​​。
​​​connections配置​​​具体的数据库连接信息,default配置参数定义的​​连接配置​​必须要存在。

​ype参数​​​用于指定​​数据库类型​

type 数据库

mysql  MySQL
sqlite SqLite
pgsql PostgreSQL
sqlsrv SqlServer
mongo MongoDb
oracle Oracle

每个​​应用​​​可以设置 ​​独立的数据库连接参数​​,通常直接更改default参数即可:

return [
'default' => 'admin',
];

连接参数

可以针对不同的连接需要添加数据库的​​连接参数​​​(具体的连接参数可以参考​​PHP手册​​),内置采用的参数包括如下:

PDO::ATTR_CASE              => PDO::CASE_NATURAL,
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_ORACLE_NULLS => PDO::NULL_NATURAL,
PDO::ATTR_STRINGIFY_FETCHES => false,
PDO::ATTR_EMULATE_PREPARES =>

在数据库配置文件中设置的​​params参数​​​中的​​连接配置​​​将会和内置的设置参数​​合并​​​,如果需要使用​​长连接​​,并且返回数据库的小写列名,可以在数据库配置文件中增加下面的定义:

'params' => [
\PDO::ATTR_PERSISTENT => true,
\PDO::ATTR_CASE => \PDO::CASE_LOWER,
],

你可以在params参数里面配置任何​​PDO支持的连接参数​​。

切换连接

我们可以在数据库配置文件中​​定义多个连接信息​

return [
'default' => 'mysql',
'connections' => [
'mysql' => [
// 数据库类型
'type' => 'mysql',
// 服务器地址
'hostname' => '127.0.0.1',
// 数据库名
'database' => 'thinkphp',
// 数据库用户名
'username' => 'root',
// 数据库密码
'password' => '',
// 数据库连接端口
'hostport' => '',
// 数据库连接参数
'params' => [],
// 数据库编码默认采用utf8
'charset' => 'utf8',
// 数据库表前缀
'prefix' => 'think_',
],
'demo' => [
// 数据库类型
'type' => 'mysql',
// 服务器地址
'hostname' => '127.0.0.1',
// 数据库名
'database' => 'demo',
// 数据库用户名
'username' => 'root',
// 数据库密码
'password' => '',
// 数据库连接端口
'hostport' => '',
// 数据库连接参数
'params' => [],
// 数据库编码默认采用utf8
'charset' => 'utf8',
// 数据库表前缀
'prefix' => 'think_',
],
],
];

我们可以调用​​Db::connect方法​​动态配置数据库连接信息,例如:

\think\facade\Db::connect('demo')
->table('user')
->find();

​connect方法​​​必须在查询的​​最开始调用​​​,而且​​必须紧跟着调用查询方法​​,否则可能会导致部分查询失效或者依然使用默认的数据库连接。

动态连接数据库的connect方法​​仅对当次查询有效​​。

这种方式的动态连接和切换数据库比较方便,经常用于​​多数据库连接​​的应用需求。

模型类定义

如果某个模型类里面定义了​​connection属性​​​的话,则该模型操作的时候会自动按照给定的​​数据库配置进行连接​​,而不是配置文件中设置的默认连接信息,例如:

<?php
namespace app\index\model;

use think\Model;

class User extends Model
{
protected $connection = 'demo';
}

需要注意的是,ThinkPHP的数据库连接是​​惰性​​​的,所以并不是在实例化的时候就连接数据库,而是在​​有实际的数据操作​​的时候才会去连接数据库。

配置参数参考

下面是默认支持的数据库连接信息:

参数名  描述  默认值
type 数据库类型 无
hostname 数据库地址 127.0.0.1
database 数据库名称 无
username 数据库用户名 无
password 数据库密码 无
hostport 数据库端口号 无
dsn 数据库连接dsn信息 无
params 数据库连接参数 空
charset 数据库编码 utf8
prefix 数据库的表前缀 无
deploy 数据库部署方式:0 集中式(单一服务器),1 分布式(主从服务器) 0
rw_separate 数据库读写是否分离 主从式有效 false
master_num 读写分离后 主服务器数量 1
slave_no 指定从服务器序号 无
fields_strict 是否严格检查字段是否存在 true
fields_cache 是否开启字段缓存 false
trigger_sql 是否开启SQL监听 true
auto_timestamp 自动写入时间戳字段 false
query 指定查询对象 think\db\Query

常用数据库​​连接参数(params)​​​可以参考PHP在线手册http://php.net/manual/zh/pdo.constants.php中的以​​PDO::ATTR_​​开头的常量。

如果同时定义了 参数化数据库连接信息 和 dsn信息,则会​​优先使用dsn信息​​。

如果是使用pgsql数据库驱动的话,请先导入 ​​thinkphp/library/think/db/connector/pgsql.sql​​文件到数据库执行。

断线重连

如果你使用的是​​长连接​​​或者​​命令行​​​,在超出一定时间后,数据库​​连接会断开​​​,这个时候你需要开启​​断线重连​​才能确保应用不中断。

在数据库连接配置中设置:

// 开启断线重连
'break_reconnect' =>

开启后,系统会自动判断数据库断线并 ​​尝试重新连接​​​。大多数情况下都能自动识别,如果在一些特殊的情况下或者某些​​数据库驱动的断线标识错误​​还没有定义,支持配置下面的信息:

// 断线标识字符串
'break_match_str' => [
'error with',
],

在 ​​break_match_str配置​​​中加入你的​​数据库错误信息关键词​​。

分布式数据库

分布式支持

数据访问层​​支持分布式数据库​​​,包括​​读写分离​​​,要启用分布式数据库,需要开启​​数据库配置文件​​​中的​​deploy参数​​:

return [
'default' => 'mysql',
'connections' => [
'mysql' => [
// 启用分布式数据库
'deploy' => 1,
// 数据库类型
'type' => 'mysql',
// 服务器地址
'hostname' => '192.168.1.1,192.168.1.2',
// 数据库名
'database' => 'demo',
// 数据库用户名
'username' => 'root',
// 数据库密码
'password' => '',
// 数据库连接端口
'hostport' => '',
],
],
];

启用分布式数据库后,​​hostname参数是关键​​​,hostname的个数决定了分布式数据库的​​数量​​​,默认情况下​​第一个地址​​就是主服务器。

主从服务器支持设置不同的​​连接参数​​,包括:

连接参数
username
password
hostport
database
dsn
charset

如果主从服务器的上述参数一致的话,只需要设置一个,对于不同的参数,可以​​分别设置​​,例如:

return [
'default' => 'mysql',
'connections' => [
'mysql' => [
// 启用分布式数据库
'deploy' => 1,
// 数据库类型
'type' => 'mysql',
// 服务器地址
'hostname' => '192.168.1.1,192.168.1.2,192.168.1.3',
// 数据库名
'database' => 'demo',
// 数据库用户名
'username' => 'root,slave,slave',
// 数据库密码
'password' => '123456',
// 数据库连接端口
'hostport' => '',
// 数据库字符集
'charset' => 'utf8',
],
],
];
  • 记住,要么相同,要么每个都要设置。

分布式的数据库参数支持使用​​数组定义​​​(通常为了避免多个账号和密码的​​误解析​​),例如:

return [
'default' => 'mysql',
'connections' => [
'mysql' => [
// 启用分布式数据库
'deploy' => 1,
// 数据库类型
'type' => 'mysql',
// 服务器地址
'hostname' =>[ '192.168.1.1','192.168.1.2','192.168.1.3'],
// 数据库名
'database' => 'demo',
// 数据库用户名
'username' => 'root,slave,slave',
// 数据库密码
'password' => ['123456','abc,def','hello']
// 数据库连接端口
'hostport' => '',
// 数据库字符集
'charset' => 'utf8',
],
],
];

读写分离

还可以设置分布式数据库的读写是否分离,默认的情况下​​读写不分离​​,也就是每台服务器都可以进行读写操作,对于主从式数据库而言,需要设置读写分离,通过下面的设置就可以:

'rw_separate' =>

在读写分离的情况下,默认第一个数据库配置是​​主服务器​​​的配置信息,​​负责写入数据​​​,如果设置了​​master_num参数​​​,则可以支持​​多个主服务器写入​​​(每次​​随机连接​​其中一个主服务器)。

其它的地址都是​​从数据库​​​,​​负责读取数据​​​,数量不限制。每次连接从服务器并且进行​​读取操作​​​的时候,系统会​​随机进行在从服务器中选择​​。

同一个数据库连接的​​每次请求​​​只会连接​​一次​​主服务器和从服务器,如果某次请求的从服务器连接不上,会自动切换到主服务器进行查询操作。

如果不希望随机读取,或者某种情况下其它​​从服务器暂时不可用​​​,还可以设置​​slave_no​​​ 指定​​固定服务器​​​进行读操作 ,slave_no指定的序号表示​​hostname中数据库地址的序号​​,从0开始。

调用查询类或者模型的​​CURD操作​​​的话,系统会​​自动判断当前执行的方法是读操作还是写操作​​​并自动连接主从服务器,如果你用的是​​原生SQL​​​,那么需要​​注意系统的默认规则​​​:
​​​写操作​​​必须用数据库的​​execute方法​​​,​​读操作​​​必须用数据库的​​query方法​​​,否则会发生​​主从读写错乱​​的情况。

发生下列情况的话,会自动连接​​主服务器​​:

使用了数据库的写操作方法(execute/insert/update/delete以及衍生方法);
如果调用了数据库事务方法的话,会自动连接主服务器;
从服务器连接失败,会自动连接主服务器;
调用了查询构造器的lock方法;
调用了查询构造器的master/readMaster方法

主从数据库的​​数据同步​​​工作​​不在框架实现​​​,需要数据库考虑​​自身的同步或者复制机制​​​。如果在大数据量或者特殊的情况下写入数据后可能会存在同步延迟的情况,可以调用​​master()方法​​​进行​​主库查询操作​​。

在实际生产环境中,很多云主机的数据库分布式实现机制和本地开发会有所区别,但通常会采下面用两种方式:

第一种:提供了写IP和读IP(一般是虚拟IP),进行数据库的读写分离操作;
第二种:始终保持同一个IP连接数据库,内部会进行读写分离IP调度(阿里云就是采用该方式)。

主库读取

有些情况下,需要直接从主库读取数据,例如刚写入数据之后,从库数据还没来得及同步完成,你可以使用

Db::name('user')
->where('id', 1)
->update(['name' => 'thinkphp']);
Db::name('user')
->master(true)
->find(1);

不过,实际情况远比这个要复杂,因为你并不清楚后续的方法里面是否还存在相关查询操作,这个时候我们可以配置开启数据库的​​read_master配置​​参数。

// 开启自动主库读取
‘read_master’ => true,
开启后,一旦我们对某个数据表进行了写操作,那么当前请求的后续所有对该表的查询都会使用主库读取。

查询构造器

查询数据

查询单个数据

查询单个数据使用find方法:

// table方法必须指定完整的数据表名
Db::table('think_user')->where('id', 1)->find();

最终生成的SQL语句可能是:

SELECT * FROM `think_user` WHERE  `id` = 1 LIMIT 1

find方法查询结果不存在,返回 ​​null​​​,否则返回​​结果数组​

如果希望查询数据不存在的时候返回空数组,可以使用

// table方法必须指定完整的数据表名
Db::table('think_user')->where('id', 1)->findOrEmpty();

如果希望在没有找到数据后抛出异常可以使用

Db::table('think_user')->where('id', 1)->findOrFail();

如果没有查找到数据,则会抛出一个​​think\db\exception\DataNotFoundException​​异常。

如果没有任何的查询条件 并且也没有调用​order方法​​​的话 ,​​find查询​​不会返回任何结果。

模型

模型字段

模型的数据字段和​​对应数据表​​​的字段是对应的,
默认会自动获取(包括字段类型),但自动获取会导致增加一次查询,
因此你可以在模型中明确​​​定义字段信息​​避免多一次查询的开销。

<?php
namespace app\model;

use think\Model;

class User extends Model
{
// 设置字段信息
protected $schema = [
'id' => 'int',
'name' => 'string',
'status' => 'int',
'score' => 'float',
'create_time' => 'datetime',
'update_time' => 'datetime',
];
}

字段类型的定义可以使用PHP类型或者数据库的字段类型都可以,

字段类型定义的作用主要用于​​查询的参数​​自动绑定类型。

时间字段尽量采用​​实际的数据库类型​​​定义,便于时间查询的字段自动识别。
如果是json类型直接定义为json即可。

如果你没有定义​​schema属性​​的话,可以在部署完成后运行如下指令。

php think optimize:schema

运行后会 ​​自动生成​​​数据表的​​字段信息缓存​​​。使用命令行缓存的优势是​​Db类的查询​​​仍然有效。
需要在数据库配置中设置​​​fields_cache​​为true才能生成缓存。

字段类型

schema属性一旦定义,就必须​​定义完整的数据表字段类型​​​。
如果你只希望对​​​某个字段定义需要自动转换的类型​​​,可以使用​​type属性​​,例如:

<?php
namespace app\model;

use think\Model;

class User extends Model
{
// 设置字段自动转换类型
protected $type = [
'score' => 'float',
];
}

type属性定义的不一定是实际的字段,也有可能是你的​​字段别名​​。

废弃字段

如果因为历史遗留问题 ,你的​​数据表存在很多的废弃字段​​,你可以在模型里面定义这些不再使用的字段。

<?php
namespace app\model;

use think\Model;

class User extends Model
{
// 设置废弃字段
protected $disuse = [ 'status', 'type' ];
}

在查询和写入的时候会忽略定义的status和type废弃字段。

获取数据

在​​模型外部​​获取数据的方法如下

$user = User::find(1);
echo $user->create_time;
echo $user->name;

由于模型类实现了​​ArrayAccess接口​​​,所以可以​​当成数组​​使用。

$user = User::find(1);
echo $user['create_time'];
echo $user['name'];

如果你是在​​模型内部​​获取数据的话,需要改成:

$user = $this->find(1);
echo $user->getAttr('create_time');
echo $user->getAttr('name');

否则可能会出现意想不到的错误。

模型赋值

可以使用下面的代码给​​模型对象​​赋值

$user = new User();
$user->name = 'thinkphp';
$user->score = 100;

该方式赋值会​​自动执行模型的修改器​​,如果不希望执行修改器操作,可以使用

$data['name'] = 'thinkphp';
$data['score'] = 100;
$user = new User($data);

或者使用

$user = new User();
$data['name'] = 'thinkphp';
$data['score'] = 100;
$user->data($data);

​data方法​​支持使用修改器

$user = new User();
$data['name'] = 'thinkphp';
$data['score'] = 100;
$user->data($data, true);

如果需要对数据进行过滤,可以使用

$user = new User();
$data['name'] = 'thinkphp';
$data['score'] = 100;
$user->data($data, true, ['name','score']);

表示​​只设置​​data数组的name和score数据。

  • 注意:data方法会清空调用前设置的数据

以追加数据的方式赋值:

$user = new User();
$user->group_id = 1;
$data['name'] = 'thinkphp';
$data['score'] = 100;
$user->appendData($data);

可以通过传入​​第二个参数​​​ true 来使用修改器 ,比如:​​appendData($data,true)​

严格区分字段大小写

默认情况下,你的​​模型数据名称​​​和​​数据表字段​​应该保持严格一致,也就是说区分大小写。

$user = User::find(1);
echo $user->create_time; // 正确
echo $user->createTime;

严格区分字段大小写的情况下,如果你的数据表字段是大写,模型获取的时候也必须使用大写。

如果你希望在​​获取模型数据​​​的时候​​不区分大小写​​​(前提是数据表的字段命名必须规范,即小写+下划线),
可以设置模型的strict属性。

<?php
namespace app\model;

use think\Model;

class User extends Model
{
// 模型数据不区分大小写
protected $strict = false,
}

你现在可以使用

$user = User::find(1);
// 下面两种方式都有效
echo $user->createTime;
echo $user->create_time;

模型数据转驼峰

​V6.0.4+版本​​​开始,可以设置​​convertNameToCamel属性​​​使得模型数据返回驼峰方式命名
(前提也是数据表的字段命名必须规范,即小写+下划线)。

<?php
namespace app\model;

use think\Model;

class User extends Model
{
// 数据转换为驼峰命名
protected $convertNameToCamel = true,
}

然后在模型输出的时候可以直接使用驼峰命名的方式获取。

$user = User::find(1);
$data = $user->toArray();
echo $data['createTime']; // 正确
echo $user['create_time'];

新增

模型数据的新增和数据库的新增数据有所区别,

数据库的新增只是单纯的写入给定的数据,

而模型的数据写入会包含​​修改器、自动完成以及模型事件​​等环节.

添加一条数据

第一种是实例化模型对象后赋值并保存:

$user           = new User;
$user->name = 'thinkphp';
$user->email = 'thinkphp@qq.com';
$user->save();

​save方法​​​成功会​​返回true​​​,并且只有当​​before_insert事件​​​返回false的时候返回false,
一旦有错误就会​​​抛出异常​​​。所以​​无需判断返回类型​​。

也可以​​直接传入数据​​​到​​save方法​​批量赋值:

$user = new User;
$user->save([
'name' => 'thinkphp',
'email' => 'thinkphp@qq.com'
]);

默认只会​​写入数据表已有的字段​​过滤非数据表字段的数据,如果你通过外部提交赋值给模型,并且希望指定某些字段写入,可以使用:

$user = new User;
// post数组中只有name和email字段会写入
$user->allowField(['name','email'])->save($_POST);

最佳 是​​模型数据赋值之前​​就进行数据过滤,例如:

$user = new User;
// 过滤post数组中的非数据表字段数据
$data = Request::only(['name','email']);
$user->save($data);

save方法​​新增数据​​​返回的是​​写入的记录数​​​(通常是1),而​​不是自增主键值​​。

  • Replace写入
    save方法可以支持replace写入。
$user           = new User;
$user->name = 'thinkphp';
$user->email = 'thinkphp@qq.com';
$user->replace()->save();

获取自增ID

如果要获取新增数据的自增ID,可以使用下面的方式:

$user           = new User;
$user->name = 'thinkphp';
$user->email = 'thinkphp@qq.com';
$user->save();
// 获取自增ID
echo $user->id;

这里其实是​​获取模型的主键​​,如果你的主键不是id,而是user_id的话,其实获取自增ID就变成这样:

$user           = new User;
$user->name = 'thinkphp';
$user->email = 'thinkphp@qq.com';
$user->save();
// 获取自增ID
echo $user->user_id;

不要在同一个实例里面​​多次新增数据​​​,如果确实需要多次新增,可以使用后面的​​静态方法​​处理。

批量增加数据

支持批量新增,可以使用:

$user = new User;
$list = [
['name'=>'thinkphp','email'=>'thinkphp@qq.com'],
['name'=>'onethink','email'=>'onethink@qq.com']
];
$user->saveAll($list);

​saveAll方法​​​新增数据返回的是包含新增模型(带自增ID)的​​数据集对象​​。

saveAll方法新增数据默认会自动​​识别数据​​​是需要​​新增还是更新​​​操作,当数据中存在​​主键​​的时候会认为是更新操作。

静态方法

还可以直接​​静态调用create方法​​创建并写入:

$user = User::create([
'name' => 'thinkphp',
'email' => 'thinkphp@qq.com'
]);
echo $user->name;
echo $user->email;
echo $user->id;

和save方法不同的是,create方法返回的是​​当前模型​​​的​​对象实例​​。

create方法默认会​​过滤不是数据表的字段信息​​​,可以在​​第二个参数​​​可以传入​​允许写入的字段列表​​,例如:

// 只允许写入name和email字段的数据
$user = User::create([
'name' => 'thinkphp',
'email' => 'thinkphp@qq.com'
], ['name', 'email']);
echo $user->name;
echo $user->email;
echo $user->id;

支持replace操作,使用下面的方法:

$user = User::create([
'name' => 'thinkphp',
'email' => 'thinkphp@qq.com'
], ['name','email'], true);
  • 新增数据的最佳实践原则:使用​​create方法新增数据​​​,使用​​saveAll​​批量新增数据。

更新

更新操作同样也会经过修改器、自动完成以及模型事件等处理,​​并不等同于数据库的数据更新​​​.
而且更新方法和新增方法使用的是同一个方法,通常系统会​​​自动判断​​需要新增还是更新数据。

查找并更新

取出数据后,​​更改字段内容后​​​使用​​save方法​​更新数据。这种方式是最佳的更新方式。

$user = User::find(1);
$user->name = 'thinkphp';
$user->email = 'thinkphp@qq.com';
$user->save();

对于复杂的查询条件,也可以使用​​查询构造器​​来查询数据并更新.

$user = User::where('status',1)
->where('name','liuchen')
->find();
$user->name = 'thinkphp';
$user->email = 'thinkphp@qq.com';
$user->save();

save方法更新数据,只会更新变化的数据,对于​​没有变化的数据​​是不会进行重新更新的。

需要​​强制更新数据​​,可以使用下面的方法:

$user = User::find(1);
$user->name = 'thinkphp';
$user->email = 'thinkphp@qq.com';
$user->force()->save();

无论你的修改后的数据是否和之前一样都会强制更新该字段的值。

要​​执行SQL函数​​更新,可以使用下面的方法

$user = User::find(1);
$user->name = 'thinkphp';
$user->email = 'thinkphp@qq.com';
$user->score = Db::raw('score+1');
$user->save();

批量更新数据

可以使用​​saveAll方法​​​批量更新数据,只需要在​​批量更新的数据​​​中​​包含主键​​即可,例如:

$user = new User;
$list = [
['id'=>1, 'name'=>'thinkphp', 'email'=>'thinkphp@qq.com'],
['id'=>2, 'name'=>'onethink', 'email'=>'onethink@qq.com']
];
$user->saveAll($list);

批量更新方法返回的是一个​​数据集对象​​。

  • 批量更新仅能根据主键值进行更新,其它情况请自行处理。

直接更新(静态方法)

使用模型的​​静态update方法​​更新:

User::update(['name' => 'thinkphp'], ['id' => 1]);

模型的update方法返回​​模型的对象实例​

如果你的​​第一个参数​​​中包含​​主键数据​​,可以无需传入第二个参数(更新条件)

User::update(['name' => 'thinkphp', 'id' => 1]);

如果你需要只允许更新​​指定字段​​,可以使用

User::update(['name' => 'thinkphp', 'email' => 'thinkphp@qq.com'], ['id' => 1], ['name']);

上面的代码只会更新name字段的数据。

自动识别

我们已经看到,模型的新增和更新方法都是save方法,系统有一套​​默认的规则​​来识别当前的数据需要更新还是新增。

​实例化模型后​​​调用save方法表示新增;
​​​查询数据后​​​调用save方法表示更新;
不要在一个模型实例里面做多次更新,会导致部分重复数据不再更新,
正确的方式应该是​​​先查询后更新​​​或者使用​​模型类的update方法​​更新。

不要调用save方法进行​​多次数据写入​​。

  • 最佳实践
    更新的最佳实践原则是:

如果​​需要使用模型事件​​​,那么就先查询后更新,如果​​不需要使用事件或者不查询直接更新​​​,
直接使用静态的Update方法进行条件更新,
如非必要,尽量不要使用批量更新。

删除

模型的删除和数据库的删除方法区别在于,模型的删除会​​包含模型的事件处理​​。

删除当前模型

删除模型数据,可以在查询后调用delete方法。

$user = User::find(1);
$user->delete();

delete方法返回​​布尔值​

根据主键删除

或者直接调用静态方法(根据主键删除)

User::destroy(1);
// 支持批量删除多个数据
User::destroy([1,2,3]);

当​​destroy方法​​​传入空值(包括空字符串和空数组)的时候不会做任何的数据删除操作,但​​传入0​​则是有效的

条件删除

还支持使用​​闭包删除​​,例如:

User::destroy(function($query){
$query->where('id','>',10);
});

或者通过​​数据库类的查询条件​​删除

User::where('id','>',10)->delete();

直接调用数据库的​​delete方法​​的话无法调用模型事件。

  • 最佳实践
    删除的最佳实践原则是:
    如果​​​删除当前模型​​​数据,用delete方法,
    如果需要​​​直接删除数据​​,使用destroy静态方法。

查询

模型查询和数据库查询方法的区别主要在于,

模型中的查询的数据在获取的时候会经过​​获取器​​​的处理,以及更加​​对象化的获取方式​​。

模型查询除了使用自身的查询方法外,一样可以使用​​数据库的查询构造器​​​,返回的都是​​模型对象实例​​​。
但如果​​​直接调用查询对象的方法​​,IDE可能无法完成自动提示。

获取单个数据

获取单个数据的方法包括:

// 取出主键为1的数据
$user = User::find(1);
echo $user->name;

// 使用查询构造器查询满足条件的数据
$user = User::where('name', 'thinkphp')->find();
echo $user->name;

模型使用find方法查询,如果数据不存在返回​​Null​​​,否则返回​​当前模型的对象实例​​​。
如果希望查询数据不存在则返回一个​​​空模型​​,可以使用。

$user = User::findOrEmpty(1);

你可以用​​isEmpty方法​​来判断当前是否为一个空模型。

$user = User::where('name', 'thinkphp')->findOrEmpty();
if (!$user->isEmpty()) {
echo $user->name;
}

如果你是在模型内部获取数据,请不要使用​​$this->name的方式​​​来获取数据,请使用​​$this->getAttr('name') ​​替代。

获取多个数据

取出多个数据:

// 根据主键获取多个数据
$list = User::select([1,2,3]);
// 对数据集进行遍历操作
foreach($list as $key=>$user){
echo $user->name;
}

要更多的查询支持,一样可以使用​​查询构造器​​:

// 使用查询构造器查询
$list = User::where('status', 1)->limit(3)->order('id', 'asc')->select();
foreach($list as $key=>$user){
echo $user->name;
}

查询构造器方式的查询可以支持更多的​​连贯操作​​​,包括​​排序、数量限制​​等。

自定义数据集对象

模型的​​select方法​​​返回的是一个​​包含多个模型实例​​​的​​数据集对象​​​(默认为\think\model\Collection),
支持在​​​模型中​​​单独设置​​查询数据集​​​的​​返回对象的名称​​,例如:

<?php
namespace app\index\model;

use think\Model;

class User extends Model
{
// 设置返回数据集的对象名
protected $resultSetType = '\app\common\Collection';
}

​resultSetType属性​​用于设置自定义的数据集使用的类名,该类应当继承系统的think\model\Collection类。

使用查询构造器

在模型中仍然可以调用​​数据库的链式操作和查询方法​​,可以充分利用数据库的查询构造器的优势。

例如:

User::where('id',10)->find();
User::where('status',1)->order('id desc')->select();
User::where('status',1)->limit(10)->select();

使用查询构造器直接使用静态方法调用即可,无需先实例化模型。

获取某个字段或者某个列的值

// 获取某个用户的积分
User::where('id',10)->value('score');
// 获取某个列的所有值
User::where('status',1)->column('name');
// 以id为索引
User::where('status',1)->column('name','id');

​value和column方法​​​返回的​​不再是一个模型对象实例​​​,而是纯粹的值或者某个列的​​数组​​。

动态查询

支持数据库的动态查询方法,例如:

// 根据name字段查询用户
$user = User::getByName('thinkphp');

// 根据email字段查询用户
$user = User::getByEmail('thinkphp@qq.com');

聚合查询

同样在模型中也可以调用数据库的聚合方法查询,例如:

User::count();
User::where('status','>',0)->count();
User::where('status',1)->avg('score');
User::max('score');

注意,如果你的字段不是数字类型,是使用max/min的时候,需要加上第二个参数。

User::max('name', false);

数据分批处理

模型也可以支持对返回的数据分批处理,这在处理大量数据的时候非常有用,例如:

User::chunk(100, function ($users) {
foreach($users as $user){
// 处理user模型对象
}
});

使用游标查询

模型也可以使用数据库的cursor方法进行游标查询,返回生成器对象

foreach(User::where('status', 1)->cursor() as $user){
echo $user->name;
}

user变量是一个​​模型对象实例​​。

  • 最佳实践
    模型查询的最佳实践原则是:
    在​​​模型外部​​​使用静态方法进行查询,
    ​​​内部使用​​​动态方法查询,包括使用​​数据库的查询构造器​​。