[李景山php]thinkphp核心源码注释|Model.class.php

最新推荐文章于 2021-03-21 01:51:49 发布
VIP文章 最新推荐文章于 2021-03-21 01:51:49 发布
阅读量1.4k 收藏 1
点赞数
分类专栏： php
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/lijingshan34/article/details/51965065
版权 
<?php
// +----------------------------------------------------------------------
// | ThinkPHP [ WE CAN DO IT JUST THINK IT ]
// +----------------------------------------------------------------------
// | Copyright (c) 2006-2014 http://thinkphp.cn All rights reserved.
// +----------------------------------------------------------------------
// | Licensed ( http://www.apache.org/licenses/LICENSE-2.0 )
// +----------------------------------------------------------------------
// | Author: liu21st <[email protected]>
// +----------------------------------------------------------------------
namespace Think;
/**
 * ThinkPHP Model模型类
 * 实现了ORM和ActiveRecords模式
 */
class Model {
    
    // 操作状态
    const MODEL_INSERT          =   1;      //  插入模型数据
    const MODEL_UPDATE          =   2;      //  更新模型数据
    const MODEL_BOTH            =   3;      //  包含上面两种方式
    const MUST_VALIDATE         =   1;      // 必须验证
    const EXISTS_VALIDATE       =   0;      // 表单存在字段则验证
    const VALUE_VALIDATE        =   2;      // 表单值不为空则验证
    // 开始的 变量 定义
    // 据说 const 比 那里的 define 里面 效果要好一些， 貌似在 class里面只能用 const 定义的。

    // 当前数据库操作对象
    protected $db               =   null; // 这里要 获取 数据库操作对象
    // 数据库对象池
    private   $_db             =   array(); // 操作对象池  估计是给到分布式 连接使用的
    // 主键名称
    protected $pk               =   'id'; // 就是这里，给定了默认的 那个。
    // 主键是否自动增长
    protected $autoinc          =   false;    // 默认 是否 会自动 增长
    // 数据表前缀
    protected $tablePrefix      =   null;// 数据库表前缀，然而这个基本上都被自己重新定义了
    // 模型名称
    protected $name             =   ''; // 模型的开始
    // 数据库名称
    protected $dbName           =   '';// 数据库 名称了
    //数据库配置
    protected $connection       =   '';// 数据库 配置
    // 数据表名（不包含表前缀）
    protected $tableName        =   ''; // 数据表
    // 实际数据表名（包含表前缀）
    protected $trueTableName    =   '';// 组合后表名
    // 最近错误信息
    protected $error            =   '';// 错误信息
    // 字段信息
    protected $fields           =   array();// 可以获取到字段信息
    // 数据信息
    protected $data             =   array(); // 产生出来的 数据
    // 查询表达式参数
    protected $options          =   array();// 参数 开始
    protected $_validate        =   array();  // 自动验证定义
    protected $_auto            =   array();  // 自动完成定义
    protected $_map             =   array();  // 字段映射定义  用到的不多
    protected $_scope           =   array();  // 命名范围定义  这里没怎么用到
    // 是否自动检测数据表字段信息
    protected $autoCheckFields  =   true; // 是否开启自己的自动检测
    // 是否批处理验证
    protected $patchValidate    =   false;// 是否处理验证
    // 链操作方法列表
    protected $methods          =   array('strict','order','alias','having','group','lock','distinct','auto','filter','validate','result','token','index','force');
    // 链式操作的 白名单
    // 第一阶段： 代码 变量 常量 定义
    // 总结：到了最后的这个，发现了 其实在类里面，也是先准备一个 各种数据的，开始。





















    /**
     * 得到当前的数据对象名称
     * @access public
     * @return string
     */
    public function getModelName() {
    
        if(empty($this->name)){
            // 继承 自己的 get_class($this)
            $name = substr(get_class($this),0,-strlen(C('DEFAULT_M_LAYER'))); //    'DEFAULT_M_LAYER'       =>  'Model', // 默认的模型层名称
            if ( $pos = strrpos($name,'\\') ) {
   //有命名空间
                $this->name = substr($name,$pos+1);// 获取其 对象
            }else{
                $this->name = $name;
            }
        }
        return $this->name;
    }
    // 回调方法 初始化模型
    protected function _initialize() {
    }
    /**
     * 切换当前的数据库连接
     * @access public
     * @param integer $linkNum  连接序号
     * @param mixed $config  数据库连接信息
     * @param boolean $force 强制重新连接
     * @return Model
     * $this->db(0,empty($this->connection)?$connection:$this->connection,true);
     */
    public function db($linkNum='',$config='',$force=false) {
    
        if('' === $linkNum && $this->db) {
            return $this->db;
        }// 这种就是返回 当前的 数据库了，普通的调用是没有的

        if(!isset($this->_db[$linkNum]) || $force ) { // 如果没有当前序号的连接， 或者可以强制 重启连接
            // 创建一个新的实例
            if(!empty($config) && is_string($config) && false === strpos($config,'/')) { // 支持读取配置参数
                $config  =  C($config);
            }// 重新 配置 $config
            $this->_db[$linkNum]            =    Db::getInstance($config); // 返回数据库 的连接
            // 获取个 数据库的 实例化
        }elseif(NULL === $config){ // 如果配置为空的
            $this->_db[$linkNum]->close(); // 关闭数据库连接
            unset($this->_db[$linkNum]);
            return ;
        }
        // 进行数据库连接 的实例化

        // 切换数据库连接
        $this->db   =    $this->_db[$linkNum];
        $this->_after_db(); // 钩子函数
        // 字段检测
        if(!empty($this->name) && $this->autoCheckFields)    $this->_checkTableInfo();
        // 开始了 那里的 检测表
        return $this;
    }
    // 数据库切换后回调方法
    protected function _after_db() {
    }
    /**
     * 自动检测数据表信息
     * @access protected
     * @return void
     */
    protected function _checkTableInfo() {
    
        // 如果不是Model类 自动记录数据表信息
        // 只在第一次执行记录
        if(empty($this->fields)) { // 没有记录开始
            // 如果数据表字段没有定义则自动获取
            if(C('DB_FIELDS_CACHE')) { // 'DB_FIELDS_CACHE'       =>  true,        // 启用字段缓存
                $db   =  $this->dbName?:C('DB_NAME'); // 'DB_NAME'               =>  '',          // 数据库名
                $fields = F('_fields/'.strtolower($db.'.'.$this->tablePrefix.$this->name));// 读取其缓存 数值
                // 快速文件数据读取和保存 针对简单类型数据 字符串、数组
                if($fields) {
                    $this->fields   =   $fields;
                    if(!empty($fields['_pk'])){
                        $this->pk       =   $fields['_pk'];
                    }
                    return ;
                }// 更新 当前的 存储
            }
            // 每次都会读取数据表信息
            $this->flush(); // 刷新一下 缓存
        }
    }
    /**
     * 获取字段信息并缓存
     * @access public
     * @return void
     */
    public function flush() {
    
        // 缓存不存在则查询数据表信息
        $this->db->setModel($this->name);
        $fields =   $this->db->getFields($this->getTableName());
        if(!$fields) { // 无法获取字段信息
            return false;
        }
        $this->fields   =   array_keys($fields);
        unset($this->fields['_pk']);
        foreach ($fields as $key=>$val){
            // 记录字段类型
            $type[$key]     =   $val['type'];
            if($val['primary']) {
                // 增加复合主键支持
                if (isset($this->fields['_pk']) && $this->fields['_pk'] != null) {
                    if (is_string($this->fields['_pk'])) {
                        $this->pk   =   array($this->fields['_pk']);
                        $this->fields['_pk']   =   $this->pk;
                    }
                    $this->pk[]   =   $key;
                    $this->fields['_pk'][]   =   $key;
                } else {
                    $this->pk   =   $key;
                    $this->fields['_pk']   =   $key;
                }
                if($val['autoinc']) $this->autoinc   =   true;
            }
        }
        // 记录字段类型信息
        $this->fields['_type'] =  $type;

        // 2008-3-7 增加缓存开关控制
        if(C('DB_FIELDS_CACHE')){
            // 永久缓存数据表信息
            $db   =  $this->dbName?:C('DB_NAME');
            F('_fields/'.strtolower($db.'.'.$this->tablePrefix.$this->name),$this->fields);
        }
    }// 就是 刷新个字段呗。
    /**
     * 架构函数
     * 取得DB类的实例对象 字段检查
     * @access public
     * @param string $name 模型名称
     * @param string $tablePrefix 表前缀
     * @param mixed $connection 数据库连接信息
     */
    public function __construct($name='',$tablePrefix='',$connection='') {
    
        // 其实 我们经常使用的 M();这里的 应该就是实例化这里的
        // 模型初始化
        $this->_initialize(); // 是空的。 此处没有任何代码，留出了很多代码接口，
        // 获取模型名称 M()
        if(!empty($name)) {
            if(strpos($name,'.')) { // 支持 数据库名.模型名的 定义
                list($this->dbName,$this->name) = explode('.',$name); // 应该是 数据库名   数据表名
            }else{
                $this->name   =  $name;
            }
        }elseif(empty($this->name)){
            $this->name =   $this->getModelName();
        }
        // 产生 两个
        // $this->name  这个其实是数据表 名字
        // $this->dbName  数据库名称

        // 设置表前缀
        if(is_null($tablePrefix)) {
   // 前缀为Null表示没有前缀
            $this->tablePrefix = '';
        }elseif('' != $tablePrefix) {
            $this->tablePrefix = $tablePrefix;
        }elseif(!isset($this->tablePrefix)){ // 实际中，会执行这个
            $this->tablePrefix = C('DB_PREFIX');// 这个才是
        }
        // 这里的代码执行了
        // 数据库初始化操作
        // 获取数据库操作对象
        // 当前模型有独立的数据库连接信息
        $this->db(0,empty($this->connection)?$connection:$this->connection,true); // 进行连接 操作。
        //切换当前的数据库连接
    }
    // 总结：你一个函数 折腾出这么多事情来，呵呵

























    /**
     * 设置数据对象的值
     * @access public
     * @param string $name 名称
     * @param mixed $value 值
     * @return void
     */
    public function __set($name,$value) {
    
        // 设置数据对象属性
        $this->data[$name]  =   $value;
    }// 普通 默认设置

    /**
     * 获取数据对象的值
     * @access public
     * @param string $name 名称
     * @return mixed
     */
    public function __get($name) {
    
        return isset($this->data[$name])?$this->data[$name]:null;
    }// 普通 默认设置

    /**
     * 检测数据对象的值
     * @access public
     * @param string $name 名称
     * @return boolean
     */
    public function __isset($name) {
    
        return isset($this->data[$name]);
    }// 普通 默认设置

    /**
     * 销毁数据对象的值
     * @access public
     * @param string $name 名称
     * @return void
     */
    public function __unset($name) {
    
        unset($this->data[$name]);
    }// 普通 默认设置

    /**
     * 利用__call方法实现一些特殊的Model方法
     * @access public
     * @param string $method 方法名称
     * @param array $args 调用参数
     * @return mixed
     */
    public function __call($method,$args) {
    
        if(in_array(strtolower($method),$this->methods,true)) { // 链式 操作里面的代码
            // 连贯操作的实现
            $this->options[strtolower($method)] =   $args[0];
            return $this;
        }elseif(in_array(strtolower($method),array('count','sum','min','max','avg'),true)){ // 统计代码
            // 统计查询的实现
            $field =  isset($args[0])?$args[0]:'*';
            return $this->getField(strtoupper($method).'('.$field.') AS tp_'.$method);
        }elseif(strtolower(substr($method,0,5))=='getby') { // 特殊的一个调用
            // 根据某个字段获取记录
            $field   =   parse_name(substr($method,5));
            $where[$field] =  $args[0];
            return $this->where($where)->find();
        }elseif(strtolower(substr($method,0,10))=='getfieldby')  {
   // 这个可以
            // 根据某个字段获取记录的某个值
            $name   =   parse_name(substr($method,10));
            $where[$name] =$args[0];
            return $this->where($where)->getField($args[1]);
        }elseif(isset($this->_scope[$method])){
   // 命名范围的单独调用支持
            return $this->scope($method,$args[0]);
        }else{
            E(__CLASS__.':'.$method.L('_METHOD_NOT_EXIST_'));
            return;
        }
    }// 普通 默认设置
    // 符合标准 就执行

    /**
     * 数据类型检测
     * @access protected
     * @param mixed $data 数据
     * @param string $key 字段名
     * @return void
     */
    protected function _parseType(&$data,$key) {
    
        if(!isset($this->options['bind'][':'.$key]) && isset($this->fields['_type'][$key])){
            $fieldType = strtolower($this->fields['_type'][$key]);
            if(false !== strpos($fieldType,'enum')){
                // 支持ENUM类型优先检测
            }elseif(false === strpos($fieldType,'bigint') && false !== strpos($fieldType,'int')) {
                $data[$key]   =  intval($data[$key]);
            }elseif(false !== strpos($fieldType,'float') || false !== strpos($fieldType,'double')){
                $data[$key]   =  floatval($data[$key]);
            }elseif(false !== strpos($fieldType,'bool')){
                $data[$key]   =  (bool)$data[$key];
            }
        }
    }// 数据类型的 数据转换
    /**
     * 对保存到数据库的数据进行处理
     * @access protected
     * @param mixed $data 要操作的数据
     * @return boolean
     */
     protected function _facade($data) {
    

        // 检查数据字段合法性
        if(!empty($this->fields)) {
            if(!empty($this->options['field'])) {
                $fields =   $this->options['field'];
                unset($this->options['field']);
                if(is_string($fields)) {
                    $fields =   explode(',',$fields);
                }    
            }else{
                $fields =   $this->fields;
            }        
            foreach ($data as $key=>$val){
                if(!in_array($key,$fields,true)){
                    if(!empty($this->options['strict'])){
                        E(L('_DATA_TYPE_INVALID_').':['.$key.'=>'.$val.']');
                    }
                    unset($data[$key]);
                }elseif(is_scalar($val)) {
                    // 字段类型检查 和 强制转换
                    $this->_parseType($data,$key); // 是转换数据类型
                }
            }
        }

        // 安全过滤
        if(!empty($this->options['filter'])) {
            $data = array_map($this->options['filter'],$data); // 数据跑起来了
            unset($this->options['filter']);
        }
        $this->_before_write($data);
        return $data;
     }//总结，就是对数据的 处理
    // 各种数据 处理




























    // 写入数据前的回调方法 包括新增和更新
    protected function _before_write(&$data) {
    }
    // 插入数据前的回调方法
    protected function _before_insert(&$data,$op
最低0.47元/天 解锁文章
李景山-编程者
关注
  • 0
    点赞
  • 踩
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
model.class.php模块,thinkphp源码讲解——Model.class.php
weixin_34093995的博客
04-01 161
M()函数，在thinkphp中主要的作用是实例化模型。源码：function M($name='', $tablePrefix='',$connection='') {static $_model = array();//定义一个静态变量数组，if(strpos($name,':')) {//检测是否存在':',来判断是否指定基础模型list($class,$name) = explode(':...
model注释php,基于thinkphp的模型文件自动注释生成器
weixin_29752389的博客
03-10 703
thinkphp 一个模型对应一个数据表，所以数据表里面字段也是模型的一些属性，但是因为php是动态语言，模型里面的属性并不能直观的看到，出了数据表里面的字段以外的属性，模型其实还包含了通过getXXXAttr方法定义的属性，还有关联关系定义的属性比如hasOne，hasMany等等。虽然thinkphp支持了通过访问数组的形式访问模型的属性，但是还是不直观，另一个是不知道模型属性的字段含义，如果...
生成php文件,PHP文件生成模块
weixin_30703633的博客
03-10 159
/** 描 述 ： 把数据写入文件*/namespace Model\Backend;class FilePutModel{/* 关闭自动连接数据库 */protected $autoCheckFields = false;private $m_DirName; //目录地址private $m_FileName; //文件名称private $m_Suffis; /...
thinkphp源码讲解——Model.class.php
An丶的博客
09-30 1329
M()函数，在thinkphp中主要的作用是实例化模型。源码： function M($name='', $tablePrefix='',$connection='') { static $_model = array();//定义一个静态变量数组， if(strpos($name,':')) {//检测是否存在':',来判断是否指定基础模型 list($class,$name) = ex
php aes class,AesModel.class.php
weixin_32999397的博客
03-21 104
/*** php，java，Aes加密解密，* @author **/namespace wei\Model;use Think\Model;class AesModel extends Model {protected $autoCheckFields =false;private $iv = "################";//密钥偏移量IV，可自定义private $encryptK...
ThinkPHP笔记
之路风雨
03-03 955
作者: 溪水清澈 类文件都是以.class.php为后缀 在调试模式下面，即使在Windows平台也会严格检查大小写 类名和文件名一致 数据表和字段采用小写加下划线方式命名 行为: 到底是什么? 行为可以说是一个中间接口, 行为中保存了行为的名字, 和这个名字相对应的操作, 当准备执行这个行为的时候, 举例如下: class Behavior { static $callStatic
Web开发 | ThinkPHP 3.2.3 - 04.ThinkPHP与数据库2
JasonSen
04-09 323
1.聚合函数及having使用细节 $info = $goods -&gt; where() -&gt; field(字段) -&gt; select(); select()方法   1、返回一个二维数组信息   2、返回全部数据表信息   3、给该方法传递参数     1) select(20) 查询主键值等于30的记录信息     2) select(“20,21,22...
thinkphp 三大自动验证
weixin_33978016的博客
04-25 130
1 public function create($data='',$type='') { 2 // 如果没有传值默认取POST数据 3 if(empty($data)) { 4 $data = $_POST; 5 }elseif(is_object($data)){ 6 ...
thinkphp model 用法
水墨青花的博客
09-11 823
1.在Common/Model/下新建一个activitymodel.class.php,开头如图。 2.在控制器中的使用，如图： 3.实例化的时候要用表的名字
thinkphp5自动生成文档/注释代码自动生成api文档
廖圣平
11-23 6665
composer require weiwei/api-doc dev-master 安装之后，readme 有详细的使用说明
tp上mongo的配置
bingcool
09-02 2224
tp已经支持mongodb的数据库，下面是对mongo在tp上的配置和使用做一个详细的说明。 （1）tp3.2.2版本中的/think/Model/mongoModel.class.php的原来的类是存在bug的。我们需要在原来的类中添加一些代码，修复bug。 <?php // +---------------------------------------------------------
【thinkphp3.x】Model.class.php文件分析
PHP在线开发笔记
10-04 3114
// +---------------------------------------------------------------------- // | ThinkPHP [ WE CAN DO IT JUST THINK IT ] // +---------------------------------------------------------------------- //
thinkphp中自动验证function的用法
一只正在努力进化的程序猿
10-09 802
private $_db=&amp;quot;&amp;quot;; protected $pk = 'product_id'; protected $fields = array('name','pice','concrete','company','license','batch','spec','unit','dietime','cost','stock','usage','pro_com','pro_type','gif...
thinkphp3.2.2升级3.2.3后 Base table or view not found: 1146解决办法
200ok的专栏
06-08 7913
在没升级前如果thinkphp中没有对应的数据表，直接定义模型就可以了，用D方法实例化就可以了，不过最近tp升级到3.2.3后出现问题提示错误：SQLSTATE[42S02]: Base table or view not found: 1146 Table 'gudong365.gd_weixin' doesn't exist  我确实没有创建gd_weixin这张表，但是模型是这样定义的：We
thinkphp多数据库动态切换
步知道
10-22 4030
thinkphp作为国内使用广泛的PHP框架，功能很强大，数据库支持方面做的也很好，并支持mongo操作，我们的项目是配置了两台数据库，一主一从，读写分离，最近要做一个活动，要求读写都在一个库上，所以需要动态建立多个数据库连接，主连接跟活动数据库连接，配置方式如下 首先配置默认数据库，两台，一主一从，读写分离 配置信息在项目工程文件夹下的Conf/config.php 'DB_T
php 动态切换数据库,thinkphp多数据库动态切换
weixin_39714528的博客
03-17 215
thinkphp作为国内使用广泛的PHP框架，功能很强大，数据库支持方面做的也很好，并支持mongo操作，我们的项目是配置了两台数据库，一主一从，读写分离，最近要做一个活动，要求读写都在一个库上，所以需要动态建立多个数据库连接，主连接跟活动数据库连接，配置方式如下首先配置默认数据库，两台，一主一从，读写分离配置信息在项目工程文件夹下的Conf/config.php'DB_TYPE' ...
Elasticsearch 与 Thinkphp 增删改查操作
weixin_33953384的博客
05-27 731
2019独角兽企业重金招聘Python工程师标准>>> ...
Thinkphp新增字段无法插入到数据库问题
ruoke_的博客
06-17 8359
曾在使用Thinkphp框架开发过程中,因需求需要改动数据表,新增了几个字段. 调用 M(‘xxx’)->add($data) 插入值时，新增的字段数据总是插入不进去,每次都是默认的值,于是恍然—-缓存了…清空缓存 . 终于可以正常插入数据了. 原来TP在配置文件中如果没有关闭字段缓存设置,默认是开启的,只要一运行它就会将数据字段信息缓存到~Runtime/Data/_files 文件夹下,序

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值