首页 > 编程 > PHP > 正文

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

2020-03-22 17:14:13
字体:
来源:转载
供稿:网友
  • <?php// +----------------------------------------------------------------------// | ThinkPHP [ WE CAN DO IT JUST THINK IT ]// +----------------------------------------------------------------------// | Copyright (c) 2006-2014 http://thinkVeVb.com All rights reserved.// +----------------------------------------------------------------------// | Licensed ( http://www.apache.org/licenses/LICENSE-2.0 )// +----------------------------------------------------------------------// | Author: liu21st <liu21st@gmail.com>// +----------------------------------------------------------------------namespace Think;/** * ThinkPHP 控制器基类 抽象类 */abstract html' target='_blank'>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'); // 别名控制了
    PHP编程

    郑重声明:本文版权归原作者所有,转载文章仅为传播更多信息之目的,如作者信息标记有误,请第一时间联系我们修改或删除,多谢。

  • 发表评论 共有条评论
    用户名: 密码:
    验证码: 匿名发表