首页
所有分类
TAGS
文字工具 EMOJI BIBLE
编程 PHP

ThinkPHP模型详解

Posted in PHP onJuly 27, 2015

模型定义，默认情况下，ThinkPHP的模型类是位于/Home/Model/目录之下，模型类通常需要继承系统的\Think\Model类或其子类，下面是一个Home\Model\UserModel类的定义：

文件命名遵守UserModel.class.php的方式，跟控制器的命名一样

<?php
namespace Home\Model;

use Think\Model;

class UserModel extends Model {
}

模型类的作用大多数情况是操作数据表的，如果按照系统的规范来命名模型类的话，大多数情况下是可以自动对应数据表，但你可以根据自己的需求来定制自己的数据表设置和操作。

首先我们需要在配置文件设置我们的数据库连接信息：

'DB_TYPE'        => 'mysql',   
  'DB_HOST'        => 'localhost', 
  'DB_NAME'        => 'database',  
  'DB_USER'        => 'username',   
  'DB_PWD'        => 'password',  
  'DB_PORT'        => '3306',

这些配置信息还是在/Home/Conf/config.php文件里设置。

指定数据表前缀

指定标前缀，我们在第一课的配置项已经指定，以下的文字表示你可以灵活配置你的数据表。

protected $tablePrefix = 'top_';

如果数据库的表没有表前缀，使用空字符串代替

protected $tablePrefix = '';

指定数据表，此处的指定的数据表的不需要添加表前缀：

protected $tableName = 'user';

举个例子说，比如说你的数据库中有一个没有表前缀的，名为users的数据表，可以用以下的两种方法在模型中进行下面的定义：

第一，直接根据系统的规范来命名模型类来命名模型，比如说就命名为UsersModel那么只需要在这个类里面加上下面的设置就可以了：

protected $tablePrefix = '';

ThinkPHP系统就会自动定位到users表了。

第二种情况时，如果你的模型类没有按照系统规范来命名，比如说不小心命名为UserModel，这种情况下可以同时指定表前缀和表明，比如：

protected $tablePrefix = '';

protected $tableName = 'users';

或者你直接指定trueTableName:

protected $trueTableName = 'users';

既然模型通常是用来操作数据表，那么我们来看看模型的基本CURD:

注：为了方便演示，我们在UserController中定义一个testDemo()方法用于演示

public function testDemo()
  {

  }

以下的代码将会一段一段在这个方法里演示，你可以通过访问http://localhost:8999/index.php/Home/User/testDemo来看到实际效果。

添加纪录

$user = M('User');
$data['username'] = 'ThinkPHP';
$data['email'] = 'ThinkPHP@gmail.com';
$user->create($data);
$record = $user->add();
dump($record);

add()返回的是插入数据的id,对于不存在的表字段，add()方法会自动过滤。

读取纪录

在ThinkPHP中读取数据的方式很多，通常分为读取数据、读取数据集和读取字段值

$user = M('User');

$record = $user->where('username="ThinkPHP"')->find();

dump($record);

读取字段值

$user = M('User');

$record = $user->where('id=3')->getField('username');

dump($record);

默认情况下，当只有一个字段的时候，返回满足条件的数据表中的该字段的第一行的值.如果getField()传入多个字段，返回值将是一个关联数组：

$user = M('User');

$record = $user->getField('username,email');
dump($record);

这个数组总是以传入的第一个第一个字段为键值的。如果修改为：

$user = M('User');

$record = $user->getField('email,username');

dump($record);

将上面的两次代码分别放到testDemo()，你就会看到不一样的结果集。

用save()方法更新数据

$user = M('User');

$data['username'] = 'ThinkPHPSave';
$data['email'] = 'ThinkPHPSave@outlook.com';

$record = $user->where('id=3')->save($data);

dump($record);

这里的$record返回的事1，表示成功更改。

当然，你也可以这样：

$user = M('User');

$user->username = 'ThinkPHP';
$user->email = 'ThinkPHP@outlook.com';

$record = $user->where('id=3')->save();

dump($record);

日常开发的时候经常会遇到一些只更新某些字段的情况，可以通过下面的方式来实现：

$user = M("User"); 
$record = $user->where('id=4')->setField('username','ThinkPHPChangeName');

dump($record);

同时更新多个字段，可以将数据以数组的形式传给setField()方法：

$user = M('User');
$data = array('username'=>'ThinkPHPChangeArray','email'=>'ThinkPHP@array.com');
$record = $user-> where('id=6')->setField($data);
dump($record);

ThinkPHP删除数据使用delete方法，例如:

$user = M('User');
$record = $user->where('id=3')->delete();
dump($record);

或者你可以直接使用：

$record = $user->delete('1,2,5');
dump($record);

这样就达到了删除主键1,2,5这三条纪录了。

ActiveRecords

ThinkPHP实现了ActiveRecords模式的ORM模型，采用了非标准的ORM模型：表映射到类，记录映射到对象。以下实例将使用ActiveRecords重现对数据表的CURD，看看ActiveRecords给我们带来了什么好处。

$user = M("User");

$user->username = 'ThinkPHPWithActive';
$user->email = 'ThinkPHPActive@gmail.com';

$record = $user->add();

dump($record);

读取纪录

AR最大的特点可能就是它的查询模式了，模式简单易用，因为更多情况下面查询条件都是以主键或者某个关键的字段。这种类型的查询，ThinkPHP有着很好的支持。

比如说获取主键为2的用户信息：

$user = M("User");

$record = $user->find(2);

dump($record);

直接不用where()查询了，简单友好吧。再比如：

$user = M("User");

$record = $user->getByUsername("jelly");

dump($record);

如果是查询多条纪录，使用以下方式：

$user = M("User");

$record = $user->select('1,3,8');

dump($record);

更新记录

$user = M("User");
$user->find(21);
$user->username = 'TOPThinkChangeWithAR';
$record = $user->save();

dump($record);

删除记录

删除单条纪录

$user = M("User");

$record = $user->delete(8);

dump($record);

删除多条纪录

$user = M("User");

$record = $user->delete('15,16');

dump($record);

// todo: 这里的自动验证和关联模型 调试不出来。

自动完成

自动完成是ThinkPHP提供用来完成数据自动处理和过滤的方法，当使用create()方法创建数据对象的时候会触发自动完成数机制。

因此，在ThinkPHP鼓励使用create()方法来创建数据对象，因为这是一种更加安全的方式，直接通过add()或者save()方法实现数据写入无法出发自动完成机制。

自动完成通常用来完成默认字段写入(比如添加时间戳)，安全字段过滤(比如加密密码)以及业务逻辑的自动处理等。可以通过模型类里面通过$_auto属性定义处理规则。下面演示如何自动完成添加时间戳：

在UserModel中，声明自动完成的定义数组$_auto ：

protected $_auto = array (
    array('created_at','date("Y-m-d H:i:s", time())',3,'function'),
    array('updated_at','date("Y-m-d H:i:s", time())',3,'function'),
  );

还有一种是理由auto()方法动态设置自动完成的机制，可以到官方文档去看看

设置完成之后，我们在testDemo()方法中创建一条用户数据：

$user = D('User');
$data['username'] = "ThinkPHP";
$data['email'] = "ThinkPHP@gmail.com";
$user->create($data);
$record = $user->add();
dump($record);

测试，如果返回纪录的id值，说明用户纪录创建成功。要验证数据是否自动完成，你可以直接使用：

$user = D('User');
$record = $user->find(id);
dump($record);

自动验证

自动验证是ThinkPHP模型层提供的一种数据验证方法，可以在使用create()创建数据对象的时候自动进行数据验证。

数据验证可以进行数据类型、业务规则、安全判断等方面的验证操作。

通常用于表单验证

数据验证有两种方式：

静态方式：在模型类里面通过$_validate属性定义验证规则。

动态方式：使用模型类的validate()方法动态创建自动验证规则。

无论是什么方式，验证规则的定义是统一的规则，定义格式为：

array(
     array(验证字段1,验证规则,错误提示,[验证条件,附加规则,验证时间]),
     array(验证字段2,验证规则,错误提示,[验证条件,附加规则,验证时间]),
     ......
);
下面以$_validate静态方式举例如何使用自动验证：

在UserController中创建register()方法，对，几乎每一个Web应用都需要实现用户注册这一步。

public function register()
  {
    $this->display();
  }

对，就是这么简单，这个方法只是将相应的视图文件渲染出来。所以接下来我们创建对应的视图文件，也就是：./Application/Home/View/User/register.html

<extend name="Index/base" />
<block name="main" >
<form method="post" action="__URL__/registerValidate">
  <div class="form-group">
    <label for="exampleInputName">Name</label>
    <input type="text" name="username" class="form-control" id="exampleInputName" placeholder="Name">
  </div>
  <div class="form-group">
    <label for="exampleInputEmail">Email</label>
    <input type="email" name="email" class="form-control" id="exampleInputEmail" placeholder="Email">
  </div>

  <button type="submit" class="btn btn-default">Submit</button>
</form>
</block>

上面就是一些HTML代码和一点模板的知识，对于模板，我们后续会讲到，但不管怎样，现在我们访问
http://localhost:8999/Home/User/register，就可以看到我们的注册表单页面了。

注意到form表单中，action="__URL__/registerValidate"，这表示提交到当前的控制器的registerValidate()方法处理，所以我们在UserController中增加registerValidate()方法：

public function registerValidate()
  {
    $data['username'] = $_POST['username'];
    $data['email'] = $_POST['email'];

    $user = D("User");

    if ( !$user->create($data) ) {
      exit($user->getError());
    }
    //todo: validation passes, add data to database and redirect somewhere

    echo 'validation passes';

  }

这里的if ( !$user->create($data) )会触发自动验证并判断验证是否通过验证。你可以尝试在表单里填写不同的数据来进行测试，也可以修改一下验证规则，更多规则可以到官网查看：

http://document.thinkphp.cn/manual_3_2.html#auto_validate

关联模型

通常我们所说的关联关系包括下面三种：

一对一关联 ：ONE_TO_ONE，包括HAS_ONE 和 BELONGS_TO
一对多关联 ：ONE_TO_MANY，包括HAS_MANY 和 BELONGS_TO
多对多关联 ：MANY_TO_MANY

关联定义

ThinkPHP可以很轻松的完成数据表的关联CURD操作，目前支持的关联关系包括下面四种：
HAS_ONE、BELONGS_TO、HAS_MANY和MANY_TO_MANY。
一个模型根据业务模型的复杂程度可以同时定义多个关联，不受限制，所有的关联定义都统一在模型类的 $_link 成员变量里面定义，并且可以支持动态定义。要支持关联操作，模型类必须继承Think\Model\RelationModel类，关联定义的格式类似于：

namespace Home\Model;
use Think\Model\RelationModel;
class UserModel extends RelationModel{
   protected $_link = array(
    '关联' => array(
      '关联属性1' => '定义',
      '关联属性N' => '定义',
    ),
   );
}

关于关联属性的定义和值，你可以到官方文档仔细查看，我们下面也会给出一些最常用的。

在我们的讲解例子中，会采用HAS_MANY和BELONGS_TO来演示，对于其他的几个关系模型，可以参考官方文档举一反三。

首先我们知道数据库里面有两张表，用户表和文章表，并且我们也为其创建了不同的模型(UserModel ArticelModel)。

现在我们仔细来想想他们之间的对应关系：一个用户可以拥有多篇文章，而每一篇文章都属于某个特定的用户。所以我们可以分别为这两种关系添加关联模型：

在UserModel中：

protected $_link = array(
    'Article' => self::HAS_MANY
  );

在ArticleModel中：

protected $_link = array(
    'User' => self::BELONGS_TO
  );

以上者两种都是最简洁的模型关联声明。因为在最开始设计数据库的时候，我们遵守了ThinkPHP的官方的规范：

外键的默认规则是当前数据对象名称_id，例如：UserModel对应的可能是表think_user，那么think_user表的外键默认为user_id，如果你的外键不是user_id，而是其他自定义的字段如：user_identify，那么就必须在定义关联的时候定义 foreign_key 。如下：

在UserModel中：

protected $_link = array(
    'mapping_type' => self::HAS_MANY,
    'class_name'  => 'Article',
    'foreign_key'  => 'user_identify',
  );

更多自定义的关联模型参数可以到官网查看。

有了以上的定义之后，我们就可以在检索用户数据的同时将属于他的文章也一起检索出来，使用relation()。

同样是在testDemo()这个方法中：

$user = D('User');
$record = $user->relation(true)->find(4);
dump($record);

访问熟悉的http://localhost:8999/Home/User/testDemo，你将会看到神奇的结果。

以上所述就是本文的全部内容了，希望大家能够喜欢。

ThinkPHP模型详解

- Author -

hebedich

声明：登载此文出于传递更多信息之目的，并不意味着赞同其观点或证实其描述。

PHP 相关文章推荐
一个更简单的无限级分类菜单代码
Jan 16 PHP
收集的DedeCMS一些使用经验
Mar 17 PHP
PHP 面向对象 PHP5 中的常量
May 05 PHP
php simplexmlElement操作xml的命名空间实现代码
Jan 04 PHP
php学习笔记 类的声明与对象实例化
Jun 13 PHP
学习php设计模式 php实现策略模式(strategy)
Dec 07 PHP
WordPress中访客登陆实现邮件提醒的PHP脚本实例分享
Dec 14 PHP
WordPress后台中实现图片上传功能的实例讲解
Jan 11 PHP
PHP+MySQL统计该库中每个表的记录数并按递减顺序排列的方法
Feb 15 PHP
深入理解PHP JSON数组与对象
Jul 19 PHP
php的4种常用运行方式详解
Dec 22 PHP
用PHP的反射实现委托模式的讲解
Mar 22 PHP
ThinkPHP控制器详解
Jul 27 #PHP
ThinkPHP路由详解
Jul 27 #PHP
ThinkPHP安装和设置
Jul 27 #PHP
教你在PHPStorm中配置Xdebug
Jul 27 #PHP
关于PHP开发的9条建议
Jul 27 #PHP
Laravel 中获取上一篇和下一篇数据
Jul 27 #PHP
php实现将Session写入数据库
Jul 26 #PHP
数调机(1) 灵敏度(1) 电路(15) AM(1) 频偏(1) 频率(1) 高放电路(1) 发烧友(1) 鉴频器(1) 实习报告(1)
You might like
博士208HAF收音机实习报告
2021/03/02 无线电
php数组函数序列 之shuffle()和array_rand() 随机函数使用介绍
2011/10/29 PHP
php多线程并发实现方法
2016/09/30 PHP
Laravel定时任务的每秒执行代码
2019/10/22 PHP
JavaScript编程中window的location与history对象详解
2015/10/26 Javascript
JS实现队列与堆栈的方法
2016/04/21 Javascript
Listloading.js移动端上拉下拉刷新组件
2016/08/04 Javascript
js获取浏览器和屏幕的各种宽度高度
2017/02/22 Javascript
Angularjs修改密码的实例代码
2017/05/26 Javascript
javascript获取图片的top N主色值方法详解
2018/01/26 Javascript
vue实现弹框遮罩点击其他区域弹框关闭及v-if与v-show的区别介绍
2018/09/29 Javascript
vue 右键菜单插件 简单、可扩展、样式自定义的右键菜单
2018/11/29 Javascript
ES6基础之数组和对象的拓展实例详解
2019/08/22 Javascript
使用layui监听器监听select下拉框,事件绑定不成功的解决方法
2019/09/28 Javascript
node使用request请求的方法
2019/12/20 Javascript
详解js中的原型，原型对象，原型链
2020/07/16 Javascript
详解Python中映射类型（字典）操作符的概念和使用
2015/08/19 Python
Anaconda入门使用总结
2018/04/05 Python
Python使用try except处理程序异常的三种常用方法分析
2018/09/05 Python
使用 Python 实现微信群友统计器的思路详解
2018/09/26 Python
django 捕获异常和日志系统过程详解
2019/07/18 Python
pytorch方法测试——激活函数(ReLU)详解
2020/01/15 Python
浅析两列自适应布局的3种思路
2016/05/03 HTML / CSS
详解css position 5种不同的值的用法
2019/07/30 HTML / CSS
一张图片能隐含千言万语之隐藏你的程序代码
2012/12/13 HTML / CSS
TUMI马来西亚官方网站：国际领先的高品质商旅箱包品牌
2018/04/26 全球购物
Bath & Body Works阿联酋：在线购买沐浴和身体用品
2021/02/27 全球购物
新闻专业个人自我评价
2013/09/21 职场文书
公司同意接收函
2014/01/13 职场文书
计算机维护专业推荐信
2014/02/27 职场文书
喷漆工的岗位职责
2014/03/17 职场文书
创优争先心得体会
2014/09/11 职场文书
民政局办理协议离婚（范本）
2014/10/25 职场文书
优秀党员推荐材料
2014/12/18 职场文书
pyqt5打包成exe可执行文件的方法
2021/05/14 Python
SQL实现LeetCode(180.连续的数字)
2021/08/04 MySQL