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,你将会看到神奇的结果。

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

PHP 相关文章推荐
Win2003下APACHE+PHP5+MYSQL4+PHPMYADMIN 的简易安装配置
Nov 18 PHP
PHP为表单获取的URL 地址预设 http 字符串函数代码
May 26 PHP
PHP基础学习之流程控制的实现分析
Apr 28 PHP
探讨如何把session存入数据库
Jun 07 PHP
php检测网页是否被百度收录的函数代码
Oct 09 PHP
PHP获取指定函数定义在哪个文件中以及其所在的行号实例
May 08 PHP
ThinkPHP模板自定义标签使用方法
Jun 26 PHP
用 Composer构建自己的 PHP 框架之构建路由
Oct 30 PHP
Yii框架获取当前controlle和action对应id的方法
Dec 03 PHP
php实现登录tplink WR882N获取IP和重启的方法
Jul 20 PHP
CI框架使用composer安装的依赖包步骤与方法分析
Nov 21 PHP
Laravel数据库读写分离配置的方法
Oct 13 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
You might like
一些php技巧与注意事项分析
2011/02/03 PHP
基于php常用正则表达式的整理汇总
2013/06/08 PHP
PHP Session机制简介及用法
2014/08/19 PHP
php数组操作之键名比较与差集、交集赋值的方法
2014/11/10 PHP
超强的IE背景图片闪烁(抖动)的解决办法
2007/09/09 Javascript
jQuery EasyUI NumberBox(数字框)的用法
2010/07/08 Javascript
在jQuery1.5中使用deferred对象 着放大镜看Promise
2011/03/12 Javascript
动态读取JSON解析键值对的方法
2014/06/03 Javascript
jquery实现超简洁的TAB选项卡效果代码
2015/08/28 Javascript
基于JQuery打造无缝滚动新闻步骤详解
2016/03/31 Javascript
JavaScript实现相册弹窗功能(zepto.js)
2016/06/21 Javascript
JS图片放大效果简单实现代码
2016/09/08 Javascript
javascript实现秒表计时器的制作方法
2017/02/16 Javascript
React Native如何消除启动时白屏的方法
2017/08/08 Javascript
angular.js4使用 RxJS 处理多个 Http 请求
2017/09/23 Javascript
webpack之devtool详解
2018/02/10 Javascript
js中apply()和call()的区别与用法实例分析
2018/08/14 Javascript
Angular2实现的秒表及改良版示例
2019/05/10 Javascript
[04:44]DOTA2英雄梦之声_第12期_矮人直升机
2014/06/21 DOTA
Python中数组,列表:冒号的灵活用法介绍(np数组,列表倒序)
2018/04/18 Python
python3 小数位的四舍五入(用两种方法解决round 遇5不进)
2019/04/11 Python
python用requests实现http请求代码实例
2019/10/31 Python
python用quad、dblquad实现一维二维积分的实例详解
2019/11/20 Python
Django-rest-framework中过滤器的定制实例
2020/04/01 Python
使paramiko库执行命令时在给定的时间强制退出功能的实现
2021/03/03 Python
利用CSS3的checked伪类实现OL的隐藏显示的方法
2010/12/18 HTML / CSS
Bjorn Borg官方网上商店:国际运动时尚品牌
2016/08/27 全球购物
马来西亚网上购物:Youbeli
2018/03/30 全球购物
韩国演唱会订票网站:StubHub韩国
2019/01/17 全球购物
Java基础面试题
2012/11/02 面试题
时尚休闲吧创业计划书
2014/01/25 职场文书
晚会主持词开场白
2014/03/17 职场文书
项目建议书模板
2014/05/12 职场文书
课外活动实习计划
2015/01/19 职场文书
导游词之山西祁县乔家大院
2019/10/14 职场文书
JS数组的常用方法整理
2021/03/31 Javascript