[李景山php]每天TP5-20161221|thinkphp5-jump.php

<?php

/**
 * 用法：
 * load_trait(‘controller/Jump‘);
 * class index
 * {
 *     use \traits\controller\Jump;
 *     public function index(){
 *         $this->error();
 *         $this->redirect();
 *     }
 * }
 */
namespace traits\controller;

use think\Config;
use think\exception\HttpResponseException;
use think\Request;
use think\Response;
use think\response\Redirect;
use think\Url;
use think\View as ViewTemplate;

trait Jump
{// 跳转 包块 ，一个包块
    /**
     * 操作成功跳转的快捷方法
     * @access protected
     * @param mixed     $msg 提示信息
     * @param string    $url 跳转的URL地址
     * @param mixed     $data 返回的数据
     * @param integer   $wait 跳转等待时间
     * @param array     $header 发送的Header信息
     * @return void
     */
    protected function success($msg = ‘‘, $url = null, $data = ‘‘, $wait = 3, array $header = [])
    {// 成功跳转
        $code = 1;// 标志位
        if (is_numeric($msg)) {// 如果发送的信息是数字，应该会有一些特殊的函数，根据输入参数的不同的 类型，选择不同的执行方案，貌似越来越流行了
            $code = $msg;// 把数字 赋值给编码
            $msg  = ‘‘;// 清空消息
        }
        if (is_null($url) && isset($_SERVER["HTTP_REFERER"])) {// 如果需要跳转的地址留空，并且拥有 来路信息
            $url = $_SERVER["HTTP_REFERER"];// 跳转的地址 就是返回地址
        } elseif (‘‘ !== $url) {// 如果 指定的跳转地址
            $url = preg_match(‘/^(https?:|\/)/‘, $url) ? $url : Url::build($url);// 如果指定了 http: 则不在解析，否则，重建标准的http信息
        }
        $result = [// 返回结果集
            ‘code‘ => $code,// 编码
            ‘msg‘  => $msg,//信息
            ‘data‘ => $data,// 返回的数据
            ‘url‘  => $url,// url 地址
            ‘wait‘ => $wait,// 等待时间
        ];

        $type = $this->getResponseType();// 获取返回类型 就是 ajax 返回，还是 普通的返回
        if (‘html‘ == strtolower($type)) {//如果是普通的 html 方式返回
            $result = ViewTemplate::instance(Config::get(‘template‘), Config::get(‘view_replace_str‘))
                ->fetch(Config::get(‘dispatch_success_tmpl‘), $result);// 传入返回结果参数，生成对应的 Html 页面
        }
        $response = Response::create($result, $type)->header($header);// 返回信息 根据 这些 结果字符串，类型，头信息返回
        throw new HttpResponseException($response);// 抛出异常 【返回处理信息】
    }

    /**
     * 操作错误跳转的快捷方法
     * @access protected
     * @param mixed     $msg 提示信息
     * @param string    $url 跳转的URL地址
     * @param mixed     $data 返回的数据
     * @param integer   $wait 跳转等待时间
     * @param array     $header 发送的Header信息
     * @return void
     */
    protected function error($msg = ‘‘, $url = null, $data = ‘‘, $wait = 3, array $header = [])
    {// 错误处理
        $code = 0;
        if (is_numeric($msg)) {
            $code = $msg;
            $msg  = ‘‘;
        }// 如果是数字
        if (is_null($url)) {// 如果为空 用js 返回上一步
            $url = ‘javascript:history.back(-1);‘;
        } elseif (‘‘ !== $url) {
            $url = preg_match(‘/^(https?:|\/)/‘, $url) ? $url : Url::build($url);
        }// 处理 url 类型
        $result = [
            ‘code‘ => $code,
            ‘msg‘  => $msg,
            ‘data‘ => $data,
            ‘url‘  => $url,
            ‘wait‘ => $wait,
        ];// 输入的结果参数 $result_inupt

        $type = $this->getResponseType();// 同样的返回处理方案
        if (‘html‘ == strtolower($type)) {
            $result = ViewTemplate::instance(Config::get(‘template‘), Config::get(‘view_replace_str‘))
                ->fetch(Config::get(‘dispatch_error_tmpl‘), $result);
        }
        $response = Response::create($result, $type)->header($header);
        throw new HttpResponseException($response);
    }

    /**
     * 返回封装后的API数据到客户端
     * @access protected
     * @param mixed     $data 要返回的数据
     * @param integer   $code 返回的code
     * @param mixed     $msg 提示信息
     * @param string    $type 返回数据格式
     * @param array     $header 发送的Header信息
     * @return void
     */
    protected function result($data, $code = 0, $msg = ‘‘, $type = ‘‘, array $header = [])
    {// 对array 类型的数据 进行 返回结果封装
        $result = [
            ‘code‘ => $code,
            ‘msg‘  => $msg,
            ‘time‘ => $_SERVER[‘REQUEST_TIME‘],
            ‘data‘ => $data,
        ];
        $type     = $type ?: $this->getResponseType();
        $response = Response::create($result, $type)->header($header);// 创建返回 封装
        throw new HttpResponseException($response);
    }

    /**
     * URL重定向
     * @access protected
     * @param string         $url 跳转的URL表达式
     * @param array|integer  $params 其它URL参数
     * @param integer        $code http code
     * @return void
     */
    protected function redirect($url, $params = [], $code = 302)
    {// 重定向， url 参数 code 网页编码 如 502 什么的
        $response = new Redirect($url);// 返回url 结果集合
        if (is_integer($params)) {// 数字 处理，也就是，可以 转入参数
            $code   = $params;// 很累赘的处理方案
            $params = [];
        }
        $response->code($code)->params($params);//处理对应的 code 跟 返回
        throw new HttpResponseException($response);// 抛出返回异常，然后执行异常，这个牛叉，安逸，这样通过异常强大的中断能力，老刘，不错，不错啊
    }

    /**
     * 获取当前的response 输出类型
     * @access protected
     * @return string
     */
    protected function getResponseType()
    {// 返回 返回类型
        $isAjax = Request::instance()->isAjax();// 看是否是 ajax
        return $isAjax ? Config::get(‘default_ajax_return‘) : Config::get(‘default_return_type‘);
    }// 返回 返回类型配置
}
// 这个部分值得学习的两个地方：
/**
 * 第一：通过对 某一个参数的传入类型的判读，如$params 判读，将 传入参数的 意义进行转义，从 params 编程了 code
 * 第二：利用 php 异常中断的 强大机制，执行 跳转输出
 * 第三：配置项的获取
 *
 * thinkphp5 的自动加载的原则是，给了一个类名，按照这个文件名，找遍所有的目录，加载成功为止
 */