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

<?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 控制器基类 抽象类
 */
abstract class Controller {

    /**
     * 视图实例对象
     * @var view
     * @access protected
     * 里面的 东西了 开始
     */
    protected $view     =  null; // 这里 开始 记录 控制器 里面的  需要视图显示

    /**
     * 控制器参数
     * @var config
     * @access protected
     */
    protected $config   =   array();  // 配置文件 控制器 参数

   /**
     * 架构函数 取得模板对象实例
     * @access public
     */
    public function __construct() { // 居然还有 控制器
        Hook::listen(‘action_begin‘,$this->config); // 这里 监听标签,其实是没有的, Hook 写一些 怎么的特殊控制
        //实例化视图类
        $this->view     = Think::instance(‘Think\View‘); // 搞了半天,是控制器类 初始化的 视图类
        //控制器初始化
        if(method_exists($this,‘_initialize‘)) // 原来是这样的呢, 这个函数,弄了半天就是这样的
            $this->_initialize();
    }

    /**
     * 模板显示 调用内置的模板引擎显示方法,
     * @access protected
     * @param string $templateFile 指定要调用的模板文件
     * 默认为空 由系统自动定位模板文件
     * @param string $charset 输出编码
     * @param string $contentType 输出类型
     * @param string $content 输出内容
     * @param string $prefix 模板缓存前缀
     * @return void
     */
    protected function display($templateFile=‘‘,$charset=‘‘,$contentType=‘‘,$content=‘‘,$prefix=‘‘) {
        $this->view->display($templateFile,$charset,$contentType,$content,$prefix);
    }// 执行了 显示吧

    /**
     * 输出内容文本可以包括Html 并支持内容解析
     * @access protected
     * @param string $content 输出内容
     * @param string $charset 模板输出字符集
     * @param string $contentType 输出类型
     * @param string $prefix 模板缓存前缀
     * @return mixed
     */
    protected function show($content,$charset=‘‘,$contentType=‘‘,$prefix=‘‘) {
        $this->view->display(‘‘,$charset,$contentType,$content,$prefix);
    }// 显示了 里面的 文字了。好像默认给了一普通的模版

    /**
     *  获取输出页面内容
     * 调用内置的模板引擎fetch方法,
     * @access protected
     * @param string $templateFile 指定要调用的模板文件
     * 默认为空 由系统自动定位模板文件
     * @param string $content 模板输出内容
     * @param string $prefix 模板缓存前缀*
     * @return string
     */
    protected function fetch($templateFile=‘‘,$content=‘‘,$prefix=‘‘) {
        return $this->view->fetch($templateFile,$content,$prefix);
    }// 另外一种 输出

    /**
     *  创建静态页面
     * @access protected
     * @htmlfile 生成的静态文件名称
     * @htmlpath 生成的静态文件路径
     * @param string $templateFile 指定要调用的模板文件
     * 默认为空 由系统自动定位模板文件
     * @return string
     */
    protected function buildHtml($htmlfile=‘‘,$htmlpath=‘‘,$templateFile=‘‘) {
        $content    =   $this->fetch($templateFile);
        $htmlpath   =   !empty($htmlpath)?$htmlpath:HTML_PATH;
        $htmlfile   =   $htmlpath.$htmlfile.C(‘HTML_FILE_SUFFIX‘);
        Storage::put($htmlfile,$content,‘html‘);
        return $content;
    }// 生成 静态 文件,并且 还开始 返回数据了

    /**
     * 模板主题设置
     * @access protected
     * @param string $theme 模版主题
     * @return Action
     */
    protected function theme($theme){
        $this->view->theme($theme);
        return $this;
    }// 主题调用

    /**
     * 模板变量赋值
     * @access protected
     * @param mixed $name 要显示的模板变量
     * @param mixed $value 变量的值
     * @return Action
     */
    protected function assign($name,$value=‘‘) {
        $this->view->assign($name,$value);
        return $this;
    }// 这里的 就是 可以 走向了

    public function __set($name,$value) {
        $this->assign($name,$value);
    } // 这个 没怎么弄过了

    /**
     * 取得模板显示变量的值
     * @access protected
     * @param string $name 模板显示变量
     * @return mixed
     */
    public function get($name=‘‘) {
        return $this->view->get($name);
    } // 获取

    public function __get($name) {
        return $this->get($name);
    }// 获取

    /**
     * 检测模板变量的值
     * @access public
     * @param string $name 名称
     * @return boolean
     */
    public function __isset($name) {
        return $this->get($name);
    } // 同上的 都是 view 的封装了

    /**
     * 魔术方法 有不存在的操作的时候执行
     * @access public
     * @param string $method 方法名
     * @param array $args 参数
     * @return mixed
     */
    public function __call($method,$args) {
        if( 0 === strcasecmp($method,ACTION_NAME.C(‘ACTION_SUFFIX‘))) {
            if(method_exists($this,‘_empty‘)) {
                // 如果定义了_empty操作 则调用
                $this->_empty($method,$args); // 执行了 对应的 文件
            }elseif(file_exists_case($this->view->parseTemplate())){
                // 检查是否存在默认模版 如果有直接输出模版
                $this->display();
            }else{
                E(L(‘_ERROR_ACTION_‘).‘:‘.ACTION_NAME);
            }
        }else{
            E(__CLASS__.‘:‘.$method.L(‘_METHOD_NOT_EXIST_‘));
            return;
        }
    }// 其实 我不太喜欢这个标签了

    /**
     * 操作错误跳转的快捷方法
     * @access protected
     * @param string $message 错误信息
     * @param string $jumpUrl 页面跳转地址
     * @param mixed $ajax 是否为Ajax方式 当数字时指定跳转时间
     * @return void
     */
    protected function error($message=‘‘,$jumpUrl=‘‘,$ajax=false) {
        $this->dispatchJump($message,0,$jumpUrl,$ajax);
    }// 这里的 就是转换了

    /**
     * 操作成功跳转的快捷方法
     * @access protected
     * @param string $message 提示信息
     * @param string $jumpUrl 页面跳转地址
     * @param mixed $ajax 是否为Ajax方式 当数字时指定跳转时间
     * @return void
     */
    protected function success($message=‘‘,$jumpUrl=‘‘,$ajax=false) {
        $this->dispatchJump($message,1,$jumpUrl,$ajax);
    }// 同上

    /**
     * Ajax方式返回数据到客户端
     * @access protected
     * @param mixed $data 要返回的数据
     * @param String $type AJAX返回数据格式
     * @param int $json_option 传递给json_encode的option参数
     * @return void
     */
    protected function ajaxReturn($data,$type=‘‘,$json_option=0) {
        if(empty($type)) $type  =   C(‘DEFAULT_AJAX_RETURN‘); // ‘DEFAULT_AJAX_RETURN‘   =>  ‘JSON‘,  // 默认AJAX 数据返回格式,可选JSON XML ...
        switch (strtoupper($type)){
            case ‘JSON‘ :
                // 返回JSON数据格式到客户端 包含状态信息
                header(‘Content-Type:application/json; charset=utf-8‘);
                exit(json_encode($data,$json_option)); // 数据就是这样编码的,牛叉啊
            case ‘XML‘  :
                // 返回xml格式数据
                header(‘Content-Type:text/xml; charset=utf-8‘);
                exit(xml_encode($data)); // 发现你了, xml_encode 里面的
            case ‘JSONP‘: // 貌似用来跨域的
                // 返回JSON数据格式到客户端 包含状态信息
                header(‘Content-Type:application/json; charset=utf-8‘);
                $handler  =   isset($_GET[C(‘VAR_JSONP_HANDLER‘)]) ? $_GET[C(‘VAR_JSONP_HANDLER‘)] : C(‘DEFAULT_JSONP_HANDLER‘);
                exit($handler.‘(‘.json_encode($data,$json_option).‘);‘);   // 加了一个状态信息
            case ‘EVAL‘ :
                // 返回可执行的js脚本
                header(‘Content-Type:text/html; charset=utf-8‘);
                exit($data);   // 执行结果
            default     :
                // 用于扩展其他返回格式数据
                Hook::listen(‘ajax_return‘,$data);
        }
    } // 这里,原来在这里

    /**
     * Action跳转(URL重定向) 支持指定模块和延时跳转
     * @access protected
     * @param string $url 跳转的URL表达式
     * @param array $params 其它URL参数
     * @param integer $delay 延时跳转的时间 单位为秒
     * @param string $msg 跳转提示信息
     * @return void
     */
    protected function redirect($url,$params=array(),$delay=0,$msg=‘‘) {
        $url    =   U($url,$params);
        redirect($url,$delay,$msg);
    }// 直接跳转了

    /**
     * 默认跳转操作 支持错误导向和正确跳转
     * 调用模板显示 默认为public目录下面的success页面
     * 提示页面为可配置 支持模板标签
     * @param string $message 提示信息
     * @param Boolean $status 状态
     * @param string $jumpUrl 页面跳转地址
     * @param mixed $ajax 是否为Ajax方式 当数字时指定跳转时间
     * @access private
     * @return void
     */
    private function dispatchJump($message,$status=1,$jumpUrl=‘‘,$ajax=false) {
        if(true === $ajax || IS_AJAX) {// AJAX提交
            $data           =   is_array($ajax)?$ajax:array(); // 最后 那个
            $data[‘info‘]   =   $message;
            $data[‘status‘] =   $status;
            $data[‘url‘]    =   $jumpUrl;
            $this->ajaxReturn($data);
        }// 如果 IS_AJAX 里面 的那些 是否可以
        if(is_int($ajax)) $this->assign(‘waitSecond‘,$ajax);
        if(!empty($jumpUrl)) $this->assign(‘jumpUrl‘,$jumpUrl);
        // 提示标题
        $this->assign(‘msgTitle‘,$status? L(‘_OPERATION_SUCCESS_‘) : L(‘_OPERATION_FAIL_‘));
        //如果设置了关闭窗口,则提示完毕后自动关闭窗口
        if($this->get(‘closeWin‘))    $this->assign(‘jumpUrl‘,‘javascript:window.close();‘);
        $this->assign(‘status‘,$status);   // 状态
        //保证输出不受静态缓存影响
        C(‘HTML_CACHE_ON‘,false);
        if($status) { //发送成功信息
            $this->assign(‘message‘,$message);// 提示信息
            // 成功操作后默认停留1秒
            if(!isset($this->waitSecond))    $this->assign(‘waitSecond‘,‘1‘);
            // 默认操作成功自动返回操作前页面
            if(!isset($this->jumpUrl)) $this->assign("jumpUrl",$_SERVER["HTTP_REFERER"]);
            $this->display(C(‘TMPL_ACTION_SUCCESS‘));
        }else{
            $this->assign(‘error‘,$message);// 提示信息
            //发生错误时候默认停留3秒
            if(!isset($this->waitSecond))    $this->assign(‘waitSecond‘,‘3‘);
            // 默认发生错误的话自动返回上页
            if(!isset($this->jumpUrl)) $this->assign(‘jumpUrl‘,"javascript:history.back(-1);");
            $this->display(C(‘TMPL_ACTION_ERROR‘));
            // 中止执行  避免出错后继续执行
            exit ;
        }
    }// 进行跳转了

   /**
     * 析构方法
     * @access public
     */
    public function __destruct() {
        // 执行后续操作
        Hook::listen(‘action_end‘);
    }// 解析了
}
// 设置控制器别名 便于升级
class_alias(‘Think\Controller‘,‘Think\Action‘); // 别名控制了
时间: 2024-08-05 20:43:46

[李景山php]thinkphp核心源码注释|Controller.class.php的相关文章

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

<?php // +---------------------------------------------------------------------- // | ThinkPHP [ WE CAN DO IT JUST THINK IT ] // +---------------------------------------------------------------------- // | Copyright (c) 2006-2014 http://thinkphp.cn A

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

<?php // +---------------------------------------------------------------------- // | ThinkPHP [ WE CAN DO IT JUST THINK IT ] // +---------------------------------------------------------------------- // | Copyright (c) 2006-2014 http://thinkphp.cn A

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

<?php // +---------------------------------------------------------------------- // | ThinkPHP [ WE CAN DO IT JUST THINK IT ] // +---------------------------------------------------------------------- // | Copyright (c) 2006-2014 http://thinkphp.cn A

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

<?php // +---------------------------------------------------------------------- // | ThinkPHP [ WE CAN DO IT JUST THINK IT ] // +---------------------------------------------------------------------- // | Copyright (c) 2006-2014 http://thinkphp.cn A

1 手写ArrayList核心源码

手写ArrayList核心源码 ArrayList是Java中常用的数据结构,不光有ArrayList,还有LinkedList,HashMap,LinkedHashMap,HashSet,Queue,PriorityQueue等等,我们将手写这些常用的数据结构的核心源码,用尽量少的代码来揭示核心原理. 下面我们来手写ArrayList的核心源码 首先我们定义一个QArrayList,不要问为什么叫QArrayList,因为我之前写过Qt,仅此而已.源码 public class<T> QAr

Backbone事件机制核心源码(仅包含Events、Model模块)

一.应用场景 为了改善酷版139邮箱的代码结构,引入backbone的事件机制,按照MVC的分层思想搭建酷版云邮局的代码框架.力求在保持酷版轻量级的基础上提高代码的可维护性. 二.遗留问题 1.backbone的升级问题,新的特性无法引入 2.backbone中的潜在BUG,若官方已修复则无法同步更新 解决办法: 关注backbone官网的更新记录. http://github.com/documentcloud/backbone/ 三.核心源码 /** * @裁剪版backbone,仅包含Ev

1小时手写SpringMVC T5大牛带你解读Spring核心源码(附详细视频教程)

SpringMVC简介 SpringMVC是当前最优秀的MVC框架,自从Spring 2.5版本发布后,由于支持注解配置,易用性有了大幅度的提高.Spring 3.0更加完善,实现了对Struts 2的超越.现在越来越多的开发团队选择了Spring MVC. Spring为展现层提供的基于MVC设计理念的优秀的Web框架,是目前最主流的MVC框架之一 Spring3.0后全面超越Struts2,成为最优秀的MVC框架 Spring MVC通过一套MVC注解,让POJO成为处理请求的控制器,而无须

TreeMap核心源码实现解析

TreeMap实现了SotredMap接口,它是有序的集合.而且是一个红黑树结构,每个key-value都作为一个红黑树的节点.如果在调用TreeMap的构造函数时没有指定比较器,则根据key执行自然排序,如果指定了比较器则按照比较器来进行排序. 一.数据结构 1.继承关系 public class TreeMap<K,V> extends AbstractMap<K,V> implements NavigableMap<K,V>, Cloneable, java.io

java并发之线程池Executor 核心源码解析

1.什么是线程池 定义:线程池是指管理一组同构工作线程的资源池 组成部分: 线程管理器(ThreadPool):用于创建并管理线程池.包括创建线程池,销毁线程池,添加新任务 工作线程(PoolWorker):线程池中的线程 任务接口(Task):每个任务必须实现的接口,一共工作线程调度任务的执行 任务队列:用于存放没有处理的任务,提供一种缓冲机制 2.为什么要使用线程池 通过重用现有的线程而不是创建新线程,从而减少了线程创建 和 销毁过程中的巨大开销 当请求到达时,工作线程已经存在,不用再等待线