ThinkPHP 模型

模型定义：

    namespace Home\Model;
    use Think\Model;

    class UserModel extends Model {


    }


*模型类的命名规则是除去表前缀的数据表名称，采用驼峰法命名，并且首字母大写，然后加上模型层的名称

模型名	约定对应数据表（假设数据库的前缀定义是 think_）
UserModel	think_user
UserTypeModel	think_user_type

数据表定义:

属性	说明
tablePrefix	定义模型对应数据表的前缀，如果未定义则获取配置文件中的DB_PREFIX参数
tableName	不包含表前缀的数据表名称，一般情况下默认和模型名称相同，只有当你的表名和当前的模型类的名称不同的时候才需要定义。
trueTableName	包含前缀的数据表名称，也就是数据库中的实际表名，该名称无需设置，只有当上面的规则都不适用的情况或者特殊情况下才需要设置。
dbName	定义模型当前对应的数据库名称，只有当你当前的模型类对应的数据库名称和配置文件不同的时候才需要定义。

 eg:

    namespace Home\Model;
    use Think\Model;
    class CategoryModel extends Model {

        protected $tableName = 'categories'; //操作数据表名称


                protected  $tablePrefix  =   'top_' ;  //表前缀

              protected  $trueTableName  =   'top_categories' ;//操作数据表完整表名

                protected  $dbName  =   'top' ;  //  对数据库进行定义

    }

模型实例化

直接实例化：Model(['模型名'],['数据表前缀'],['数据库连接信息']);

参数	描述
模型名	模型的名称 和数据表前缀一起配合用于自动识别数据表名称
数据表前缀	当前数据表前缀 和模型名一起配合用于自动识别数据表名称
数据库连接信息	当前数据表的数据库连接信息 如果没有则获取配置文件中的

D方法实例化：自动检测模型类，如果存在自定义的模型类，则实例化自定义模型类，如果不存在，则会实例化系统的\Think\Model基类，同时对于已实例化过的模型，不会重复去实例化。




    //D方法还可以支持跨模块调用，需要使用：

    //实例化Admin模块的User模型
    D('Admin/User');
    //实例化Extend扩展命名空间下的Info模型
    D('Extend://Editor/Info');

M方法实例化模型:仅仅是对数据表进行基本的CURD操作的话，使用M方法实例化的话，由于不需要加载具体的模型类，所以性能会更高, 并且M方法也可以支持跨库操作。

    // 使用M方法实例化
    $User = M('User');
    // 和用法 $User = new \Think\Model('User'); 等效
    // 执行其他的数据操作
    $User->select();

实例化控模块：

    //实例化空模型
    $Model = new Model();
    //或者使用M快捷方法是等效的
    $Model = M();
    //进行原生的SQL查询
    $Model->query('SELECT * FROM think_user WHERE status = 1');

字段定义

获取当前操作表的字段信息：

    $User = M('User');
    $fields = $User->getDbFields();

如果不希望依赖字段缓存或者想提高性能，也可以在模型类里面手动定义数据表字段的名称，可以避免IO加载的效率开销，例如：

                 
                 
namespace Home\Model; 			
use Think\Model; 																	
class UserModel extends Model { 			
protected $fields = array('id', 'username', 'email', 'age','_pk'=>'id'); 			
} 

_pk表示定义当前数据表的主键名。

连贯操作

系统支持的连贯操作方法有：

连贯操作	作用	支持的参数类型
where*	用于查询或者更新条件的定义	字符串、数组和对象
table	用于定义要操作的数据表名称	字符串和数组
alias	用于给当前数据表定义别名	字符串
data	用于新增或者更新数据之前的数据对象赋值	数组和对象
field	用于定义要查询的字段（支持字段排除）	字符串和数组
order	用于对结果排序	字符串和数组
limit	用于限制查询结果数量	字符串和数字
page	用于查询分页（内部会转换成limit）	字符串和数字
group	用于对查询的group支持	字符串
having	用于对查询的having支持	字符串
join*	用于对查询的join支持	字符串和数组
union*	用于对查询的union支持	字符串、数组和对象
distinct	用于查询的distinct支持	布尔值
lock	用于数据库的锁机制	布尔值
cache	用于查询缓存	支持多个参数
relation	用于关联查询（需要关联模型支持）	字符串
result	用于返回数据转换	字符串
validate	用于数据自动验证	数组
auto	用于数据自动完成	数组
filter	用于数据过滤	字符串
scope*	用于命名范围	字符串、数组
bind*	用于数据绑定操作	数组或多个参数
token	用于令牌验证	布尔值
comment	用于SQL注释	字符串

ActiveRecord

创建数据：

                    
                    
$User = M("User"); // 实例化User对象 							
// 然后直接给数据对象赋值 						
$User->name = 'ThinkPHP'; 						
$User->email = 'ThinkPHP@gmail.com'; 						
// 把数据对象添加到数据库 							
$User->add(); 

如果使用了create方法创建数据对象的话，仍然可以在创建完成后进行赋值

                    
                    
$User = D("User"); 						
$User->create(); // 创建User数据对象，默认通过表单提交的数据进行创建 						
// 增加或者更改其中的属性 						
$User->status = 1; 						
$User->create_time = time(); 						
// 把数据对象添加到数据库 						
$User->add();  

查询记录：

                    
                    
$User = M("User"); // 实例化User对象 					
// 查找id为8的用户数据 						
$User->where('id=8')->find(); 

用AR模式的话可以直接写成：

                    
                    
$User->find(8); 

如果要根据某个字段查询，例如查询姓名为ThinkPHP的可以用：

                    
                    
$User = M("User"); // 实例化User对象 										
$User->getByName("ThinkPHP"); 
														

如果要查询数据集，可以直接使用：

                    
                    
// 查找主键为1、3、8的多个数据 											
$userList = $User->select('1,3,8');  

更新记录

在完成查询后，可以直接修改数据对象然后保存到数据库。

                    
                    
$User->find(1); // 查找主键为1的数据 						
$User->name = 'TOPThink'; // 修改数据对象 						
$User->save(); // 保存当前数据对象 
													

上面这种方式仅仅是示例，不代表保存操作之前一定要先查询。因为下面的方式其实是等效的：

                    
                    
$User->id = 1; 							
$User->name = 'TOPThink'; // 修改数据对象 							

                      
                      

                       
                       $User->save(); // 保存当前数据对象 
														
                      
                      
如只更新个别字段，可使用setField方法：
	setField方法支持多字段更新，传入数组即可
	对于统计字段的更新，系统提供 setInc（field,数字） 和 setDec（field,数字） 方法
	$User = M( 'User' );
	$User->where( 'id=6' )->setIcn( 'score', 5 ); //score加5								        $User->where( 'id=7' )->setDec( 'score',4 ); //score减4

删除记录

可以删除当前查询的数据对象

                    
                    
$User->find(2); 						
$User->delete(); // 删除当前的数据对象 

或者直接根据主键进行删除

                    
                    
$User->delete(8); // 删除主键为8的数据							
$User->delete('5,6'); // 删除主键为5、6的多个数据 

delete方法的返回值是删除的记录数，如果返回值是false则表示SQL出错，返回值如果为0表示没有删除任何数据。

删除所有的记录: $User->where('1')->delete();

事务回滚案例

    $m =D( 'YourModel' ); //或者是M();

    $m2 =D( 'YouModel2' );

    $m ->startTrans(); //在第一个模型里启用就可以了，或者第二个也行

    $result = $m ->where( '删除条件' )-> delete ();

    $result2 =m2->where( '删除条件' )-> delete ();

    if ( $result   &&  $result2 ){

        $m ->commit(); //成功则提交

    } else {

        $m ->rollback(); //不成功，则回滚

    }

数据操作状态

create方法的第二个参数可以指定创建数据的操作状态，默认情况下是自动判断是写入还是更新操作。

系统内置的数据操作包括Model::MODEL_INSERT（或者1）和Model::MODEL_UPDATE（或者2），当没有指定的时候，系统根据数据源是否包含主键数据来自动判断，如果存在主键数据，就当成Model::MODEL_UPDATE操作。

连贯操作

在create方法之前调用field方法，则表示只允许创建指定的字段数据，其他非法字段将会被过滤：

    $data['name'] = 'thinkphp';
    $data['email'] = 'thinkphp@gmail.com';
    $data['status'] = 1;
    $data['test'] = 'test';
    $User = M('User');
    $data = $User->field('name,email')->create($data);
    dump($data);

字段内容过滤： filter方法可以对数据的值进行过滤处理

    $data['name'] = '<b>thinkphp</b>';
    $data['email'] = 'thinkphp@gmail.com';
    $User = M('User');
    $User->data($data)->filter('strip_tags')->add();

Mysql的特殊操作

批量插入数据和替换操作

                             
                             
// 批量添加数据 
$dataList[] = array('name'=>'thinkphp','email'=>'thinkphp@gamil.com'); 	
$dataList[] = array('name'=>'onethink','email'=>'onethink@gamil.com'); 	

                               
                               

                                
                                $User->addAll($dataList); 

                               
                               

同时在数据插入时允许更新操作:

                             
                             
add($data='',$options=array(),$replace=false) 

其中add方法增加$replace参数(是否添加数据时允许覆盖)，true表示覆盖，默认为false