ThinkPHP01：数据库和模型

• 一、开启调试模式
• 二、配置文件
• 三、URL解析
• 四、数据库
• 五、模型
• • 1. 定义模型
  • 2. 使用模型
  • • ① 查询记录
    • ② 新增记录
    • ③ 删除记录
    • ④ 更新记录
  • 3. 字段设置
  • 4. 模型获取器
  • 5. 模型修改器
  • 6. 模型查询范围
  • 7. 模型数据集
  • 8. 模型的自动时间戳
  • 9. 模型的只读字段
  • 10. 模型类型和转换
  • 11. 模型软删除
• 六、关联模型
• • 1. 关联模型定义
  • 2. 一对一关联查询
  • 3. 一对多关联查询
  • 4. 关联预载入
  • 5. 关联统计和输出
  • 6. 多对多关联查询
• 七、操作JSON
• • 1. 数据库JSON
  • 2. 模型JSON
• 八、事件
• • 1. 数据库事件
  • 2. 模型事件

一、开启调试模式

• 根目录会自带一个.example.env文件。把.example删掉即可开启调试模式。
• 在.env中设置APP_DEBUG = true
• 调试模式下，在页面右下角会出现Trace调试小图标。

二、配置文件

• 配置文件有两种形式：.env用于本地开发测试；config用于部署上线。
• 本地测试时，.env优先于config。部署上线时，.env会被自动忽略。
• 获取配置：

  public function config() {    echo "env配置：" . env("database.hostname");    echo "
  ";    echo "config配置：" . config("database.connections.mysql.hostname");}

三、URL解析

• ThinkPHP 默认单应用模式。

class Test {    // 控制器默认操作, http://localhost:8000/test    public function index() {        return "index";    }    // http://localhost:8000/test/hello    public function hello() {        return "hello";    }    // http://localhost:8000/test/hello1?value=world    public function hello1($value = "") {        return "hello, ". $value;    }}

• 修改默认的控制器文件目录，在config下的route.php中配置。

四、数据库

• 查询整个表，当有前缀时使用 name(“member”)

use think\facade\Db;class DataTest {    public function index() {        $dbs = Db::table('member')->select();        return json($dbs);    }}

• 单数据查询，find() 没有数据返回 null，findOrFail() 没有数据抛出异常, findOrEmpty() 没有数据返回空数组。

public function index2() {    // 查询id为1    $dbs = Db::table('member')->where('id',1)->find();    // 查看sql语句    return Db::getLastSql();    return json($dbs);}

• 数据集查询，select() 返回所有数据，selectOrFail() 没有数据抛出异常，toArray()将select() 后的数据集转化为刷组。
• 其他查询，value() 返回某个字段，column() 返回某个字段的多个值，如果数据量过大使用chunk() 分批处理数据，或游标查询cursor()。
• 同一个对象实例第二次查询会保留第一次查询的值，使用 removeOption() 可以清理掉上一次查询保留的值。
• 新增数据，使用 insert() 返回影响行数，如果添加不存在的字段数据会抛出异常，如果强行新增不存在的字段使用 strick(false) 忽略异常，insertGetId() 获取插入的ID，insertAll() 插入多条数据，replace() 可以实现replace into，save() 可以判断是否新增或修改。

public function index3() {    $data = [        "name" => "k",        "age" => 12,        "email" => "@@@"    ];    return $this->memberTable->insert($data);}

• 修改数据，使用update()，修改时执行函数操作使用 exp()，自增自减某个字段使用 inc()/dec()，使用 raw() 可以实现前面的所有操作。
• 删除数据，使用delete()，默认根据主键删除。
• 查询表达式，有 where()、whereLike()、whereBetween()、whereIn()、whereNull()。
• 时间查询，有 where()、whereBetween()、whereBetweenTime()、whereTime()、whereYear()、whereMonth()、whereDay()、whereBetweenTimeField()。
• 聚合查询，count()、max()、min()、avg()、sum()。子查询，fetchSql()、buildSql()、where闭包。原生查询，query()、execute()。
• 链式查询，where()、whereRaw()、field()、fieldRaw()、withoutField()、alias()、limit()、page()、order()、orderRaw()、group()、having()。
• 快捷查询，whereColumn()、whereXXX() XXX代表字段名、getByXXX()、getFieldByXXX()、when()、withAttr()。
• 事务处理，transaction()、rollback()。

五、模型

1. 定义模型

• 定义语法，对应数据库中的member表，大驼峰命名。

  use think\Model;class Member extends Model {}

• 如果要在模型中指定模型名。

  use think\Model;class MemberModel extends Model {protected $name = 'member';}

• 默认主键是 id，主动设置主键

  use think\Model;class MemberModel extends Model {protected $pk = 'uid';}

• 类名默认对应表名，主动设置表

  use think\Model;class MemberModel extends Model {protected $table= 'member';}

• 模型初始化，自动调用。

  use think\Model;class MemberModel extends Model {protected static function init(){parent::init();}}

2. 使用模型

• 控制器中引入模型

  use \app\model\Member as MemberModel;

① 查询记录

• Db门面的查询功能，模型都支持。
• 所有记录

  use \app\model\Member as MemberModel;class Member {    public function index() {        $member = MemberModel::select();        $member = MemberModel::find(1);        return $member;    }}

• 单条记录

  public function index() {    $member = MemberModel::find(1);    return $member;}

② 新增记录

• 普通新增

  public function insert() {    // 新增方式1    $member = new MemberModel();    $member->name = "李白";    $member->age = 18;    $member->email = "@";    $member->save();    // 新增方式2    $member = new MemberModel();    $member->save([        'name' => "李黑",        'age' => 19,        'email' => "@"    ]);}

• 验证新增，设置允许写入的字段

  $member->allowField(['name', 'age'])->save([    'name' => "李黑",    'age' => 19,    'email' => "@"]);

• replace新增

  $member->replace()->save();

• 新增成功后，获取自增的ID

  $member->id;

• 批量新增

  $member = new MemberModel();$dataAll = [    [        'name' => "黑李",        'age' => 22,        'email' => "@"    ],    [        'name' => "白李",        'age' => 24,        'email' => "@"    ],];dump($member->saveAll($dataAll));

• 使用静态方法 create(新增数组, 允许写入的字段, 是否replace)，创建要新增的数据。

  $member = MemberModel::create([    'name' => "白李",    'age' => 24,    'email' => "@"], ['name', 'age'], true);echo $member->id;

③ 删除记录

• 删除单个，默认根据主键删除。

  public function delete() {    // 成员方法删除    $member = MemberModel::find(1);    $member->delete();    // 静态方法删除    MemberModel::destroy(2);}

• 批量删除

  MemberModel::destroy([3, 4, 5]);

• 通过闭包删除

  MemberModel::destroy(function ($query){$query->where("age", "<", 10);});

④ 更新记录

• 普通更新

  public function update() {    $member = MemberModel::find(8);    $member->name = "李四";    $member->age = 120;    $member->save();}

• 强制更新

  $member->force()->save();

• Db::raw() 执行SQL函数

  $member->age = Db::raw("age + 1");

• allowField() 限制更新的字段（限制不了raw）。

• saveAll() 批量更新，只能根据主键更新，返回被修改的数据集。

• 静态方法update(数据数组, 限定记录, 限定字段)

  MemberModel::update([    'name' => "占山",    'age' => 15], ['id' => 10], ['name']);

3. 字段设置

• 模型的数据字段对应表字段，默认严格区分大小写。

  class Member extends Model {// 是否严格区分大小写protected $strict = false;// 设置字段    protected $schema = [        "id" => 'int',        'name' => "string",        "age" => "int",        "email" => "string"    ];}

• $schema属性只对模型有效。如果需要Db类也有效，config/database.php 开启字段缓存。

  'fields_cache'    => true,

• 在模型中处理数据

  class Member extends Model {    public function getMemberName($id) {        $data = $this->find($id);        return $data->getAttr('name');    }}

4. 模型获取器

• 一个获取器对应模型中的一个特殊方法，该方法是public，方法名格式固定getXxxAttr()。

• 获取器的作用是对模型实例的数据做出自动处理。

  class Member extends Model {    // 获取器，获取数据时自动执行    public function getAgeAttr($value) {        if ($value < 18) {            return "未成年";        }else{            return "已成年";        }    }}

• 如果定义了获取器，并且需要获取原始值，使用getData()。

• 动态获取器withAttr()

  public function index6() {    $var = MemberModel::select()->withAttr("email", function ($value) {        return strtoupper($value);    });    return json($var);}

5. 模型修改器

• 修改器的作用是在新增、修改数据时对数据进行格式化、过滤等处理，方法名格式固定setXxxAttr()。

• 修改器只对模型操作有效，对Db类无效。

  class Member extends Model {    public function setEmailAttr($value) {        return strtoupper($value);    }}

6. 模型查询范围

• 在模型中封装一个查询或写入的方法，方便控制器调用。方法名格式scopeXxx。

  class Member extends Model {    public function scopeAdult($query) {        $query->where("age", ">=", 18)            ->field("id, name, age")            ->limit(3);    }}

• 调用只需要后缀，查询范围只支持find和select。

  use \app\model\Member as MemberModel;class Member {    public function index7() {        $select = MemberModel::adult()->select();        return json($select);    }}

• 全局查询范围，任何查询都需要加上这个范围。

  class Member extends Model {// 定义全局查询范围    protected $globalScope = ['status'];    public function scopeStatus($query) {        $query->where("status", 1);    }}

7. 模型数据集

• 数据集继承于collection类。
• 隐藏某个字段 hidden()，显示某个字段 visible()，添加获取器字段 append()，对字段进行函数处理 withAttr()。

8. 模型的自动时间戳

• 自动时间戳会自动写入create_time和update_time两个字段。默认值是int。

• 全局开启自动时间戳，在config/database.php中设置

  'auto_timestamp'  => true,

• 只想设置一个模型开启，在模型中设置

  protected $autoWriteTimestamp = true;

• 自定义新增和修改的时间戳

  protected $createTime = "create_at";protected $updateTime = "update_at";

• 不需要update_time

  protected $updateTime = false;

9. 模型的只读字段

• 只读字段只支持模型，不支持数据库方式。

• 只读字段在修改时无法被修改。

  protected $readonly = ['name','email'];

• 动态设置只读字段。

  $member->readonly(['name','email'])->save();

10. 模型类型和转换

• 类型转换会调用属性里的获取器等操作。

• 设置类型转换可以在获取数据前将类型转换成需要的类型。

  protected $type = ['name' => 'string','price' => 'float',"create_time" => "datetime:Y-m-d"];

• 当字段不再使用时，可以设置为废弃字段。

  protected $disuse = ['status', 'uid'];

11. 模型软删除

• 软删除不会物理删除记录，相当于全局查询范围。

• 在模型中设置软删除的功能。

  use think\model\concern\SoftDelete;class Member extends Model {    use SoftDelete;    protected $deleteTime = "delete_time";}

• 取消屏蔽软删除

  UserModel::withTrashed()->select();

• 显示被软删除的记录

  UserModel::onlyTrashed()->select();

• 还原软删除 restore()

  $user = UserModel::onlyTrashed()->find(300);$user->restore();

• 物理删除

  UserModel::onlyTrashed()->find(298)->force()->delete();

六、关联模型

1. 关联模型定义

• 关联模型是将表与表之间进行关联和具象化，更高效的操作数据。

• 主表关联附表（正向关联），hasOne(附表模型, 外键, 主键) 一对一关联，外键默认为主表名_id。

  class profile extends Model {}class Member extends Model {    public function profile() {        return $this->hasOne(Profile::class);    }}

• 附表关联主表（反向关联），belongsTo()

  class Profile extends Model {    public function member() {        return $this->belongsTo(Member::class, "user_id");    }}

• 调用模型

  use app\model\Member as MemberModel;class Grade {    public function index() {        $member = MemberModel::find(1);        return $member->profile->hobby;    }}

• 关联方式

  函数	说明
  hasOne	一对一
  belongsTo	一对一
  hasMany	一对多
  hasOneThrough	远程一对一
  hasManyThrough	远程一对多
  belongsToMany	多对多
  morphMany	多态一对多
  morphTo	多态

• 正反向关联

  说明	正向关联	反向关联
  一对一	hasOne	belongsTo
  一对多	hasMany	belongsTo
  多对多	belongsToMany	belongsToMany
  远程一对多	hasManyThrough	\
  多态一对一	morphOne	morphTo
  多态一对多	morphMany	morphTo

2. 一对一关联查询

• 一对一关联修改

  $member = MemberModel::find(1);$member ->profile->save(['hobby' => '吃饭']);

• 一对一关联新增

  $member = MemberModel::find(1);$member ->profile()->save(['hobby' => '吃饭']);

• 正向关联反向操作

  $member = MemberModel::hasWhere("prefile", ["id" => 2])->find();

3. 一对多关联查询

• has() 方法查询关联附表的主表内容。

  MemberModel::has("profile", ">=", 2)->select();

• together() 可以在删除主表内容时，同时删除附表关联的内容。

  $member = MemberModel::with('profile')->find(2);$member->together(['profile'])->delete();

• 新增和一对一关联新增相同。

4. 关联预载入

• 关联预载入可以减少查询次数提高性能，但不支持多次调用。

  $list = MemberModel::with(['profile'])->select([19, 20, 21]);foreach ($list as $member) {dump($member->profile);}

• 如果主表关联多个附表。

  $list = MemberModel::with(['profile', 'book'])->select([19, 20, 21]);foreach ($list as $member) {dump($member->profile.$member->book);}

• 延迟预载入

  $list = MemberModel::select([19, 20, 21]);$list->load(['profile']);foreach ($list as $member) {dump($member->profile);}

5. 关联统计和输出

• 统计主表在附表中有多少条记录，包括 withMax、withMin、withCount、withAvg等。

  public function index3() {    $list = MemberModel::withCount(['profile'])->select([1,2,3]);    foreach ($list as $member) {        echo $member->profile_count . '
  ';    }}

• 关联统计输出采用 关联方法_统计方法。

• hidden和visible控制隐藏和显示的字段，append添加额外字段。

  $list = MemberModel::withCount(['profile'])->select([1,2,3]);$list->hidden(['password', 'gender', 'profile.status']);

6. 多对多关联查询

• 多对多中间表模型类 Pivot。

• 在模型类中设置多对多关联，belongsToMany(关联模型, 中间表, 外键, 关联键)

  public function roles(){return $this->belongsToMany(Role::class, Access::class);}

• 使用

  // 获取用户$member = MemberModel::find(2);// 获取用户权限$roles = $member->roles;

• 新增，需要通过用户表新增到中间表关联。

  $member = MemberModel::find(2);$member->roles->save(Role::find(5));$member->roles->saveAll([1, 2, 3]);$member->roles->attach(5, ["detail" => "测试"]);

• 删除中间表数据

  $member = MemberModel::find(2);$member->detach(5);

七、操作JSON

1. 数据库JSON

• 在数据库中写入JSON，使用数组方式。用json()指定JSON字段。

  public function insert(){$data = ["name" => "张三","list" => ["nikeName" => "zs", "gender" => "女"]];return Db::name("user")->json(["list"])->insert($data);}

• 查询数据，需要转换JSON，也需要设置json()

  Db::name('user')->json(["list"])->find(15);

• 修改JSON字段

  $data["list"] = ["nikeName" => "zs", "gender" => "女"];Db::name("user")->json(['list']->where('id', 1)->update($data);$data["list->gender"] = "男";Db::name("user")->json(["lsit"])->where('id', 1)->update($data);

2. 模型JSON

• 在模型中设置JSON字段

  protected $json = ["list"];

• 模型中通过JSON的数据查询

  UserModel::where('list->name', "小红")->find();

• 更新数据

  $user = UserModel::find(1);$user->list->name = "小黑";$user->save();

八、事件

• 在执行增删改查的时候，可以触发一些事情来执行额外的操作。

1. 数据库事件

• 数据库事件只支持 find、select、update、delete、insert。
• 数据库实践方法为 Db::event('事件名', '执行函数')

• 在控制器端，事件一般写在初始化方法里（继承于 BaseController）。

  use app\BaseController;use think\facade\Db;class Member extends BaseController {    public function initialize() {        Db::event("before_select", function ($query) {            echo "执行了批量查询";        });                Db::event("after_update", function ($query) {            echo "修改被执行";        });    }}

2. 模型事件

• 模型支持的事件类型更丰富。

class Member extends Model {    protected static function onAfterRead($query){        echo "一条数据被查询";    }    protected static function onBeforeUpdate(Model $model) {        parent::onBeforeUpdate($model); // TODO: Change the autogenerated stub    }}

来源地址：https://blog.csdn.net/realoser/article/details/129532478