首页
所有分类
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 相关文章推荐
phpmyadmin的#1251问题
Nov 25 PHP
浅析PHP水印技术
Feb 14 PHP
Optimizer与Debugger兼容性问题的解决方法
Dec 01 PHP
php 攻击方法之谈php+mysql注射语句构造
Oct 30 PHP
Zend Guard使用指南及问题处理
Jan 07 PHP
php压缩和解压缩字符串的方法
Mar 14 PHP
Yii清理缓存的方法
Jan 06 PHP
Yii2中事务的使用实例代码详解
Sep 07 PHP
php函数mkdir实现递归创建层级目录
Oct 27 PHP
Yii框架数据模型的验证规则rules()被执行的方法
Dec 02 PHP
Yii2 批量插入、更新数据实例
Mar 15 PHP
浅谈laravel5.5 belongsToMany自身的正确用法
Oct 17 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
webpack(1) cudnn(1) Git(3) 脚本(1) 热力图(1) dict(1) RTX 3050 ti(1) 字符画(1) cudn(1) callback(1)
You might like
PHP数组交集的优化代码分析
2011/03/06 PHP
PHP 杂谈《重构-改善既有代码的设计》之四 简化条件表达式
2012/04/09 PHP
探讨GDFONTPATH能否被winxp下的php支持
2013/06/21 PHP
PHP中IP地址与整型数字互相转换详解
2014/08/20 PHP
php中getservbyport与getservbyname函数用法实例
2014/11/18 PHP
php上传文件并存储到mysql数据库的方法
2015/03/16 PHP
Laravel学习教程之View模块详解
2017/09/18 PHP
LNMP部署laravel以及xhprof安装使用教程
2017/09/14 PHP
javascript 硬盘序列号+其它硬件信息
2008/12/23 Javascript
用js判断页面刷新或关闭的方法(onbeforeunload与onunload事件)
2012/06/22 Javascript
关于scrollLeft,scrollTop的浏览器兼容性测试
2013/03/19 Javascript
from 表单提交返回值用post或者是get方法实现
2013/08/21 Javascript
jQuery的:parent选择器定义和用法
2014/07/01 Javascript
js 将图片连接转换成base64格式的简单实例
2016/08/10 Javascript
JavaScript中自带的 reduce()方法使用示例详解
2016/08/10 Javascript
微信小程序 flex实现导航实例详解
2017/04/26 Javascript
解析Angular 2+ 样式绑定方式
2018/01/15 Javascript
使用vue-router为每个路由配置各自的title
2018/07/30 Javascript
新手必须知的Node.js 4个JavaScript基本概念
2018/09/16 Javascript
基于ant design日期控件使用_仅月份的操作
2020/10/27 Javascript
python正则表达式match和search用法实例
2015/03/26 Python
Python3.x版本中新的字符串格式化方法
2015/04/24 Python
Python中的字符串查找操作方法总结
2016/06/27 Python
Python实现输出程序执行进度百分比的方法
2017/09/16 Python
Python2和Python3中print的用法示例总结
2017/10/25 Python
Centos 升级到python3后pip 无法使用的解决方法
2018/06/12 Python
利用Python绘制Jazz网络图的例子
2019/11/21 Python
使用Rasterio读取栅格数据的实例讲解
2019/11/26 Python
python如何通过pyqt5实现进度条
2020/01/20 Python
python 装饰器重要在哪
2021/02/14 Python
CSS3中的transform属性进行2D和3D变换的基本用法
2016/05/12 HTML / CSS
css3的focus-within选择器的使用
2020/05/11 HTML / CSS
电台编导求职信
2014/05/06 职场文书
辩护词格式
2015/05/22 职场文书
2015年小学教师培训工作总结
2015/07/21 职场文书
Linux中文件的基本属性介绍
2022/06/01 Servers