[李景山php]每天TP5-20161217|thinkphp5-helper.php-2

<?php
// +----------------------------------------------------------------------
// | ThinkPHP [ WE CAN DO IT JUST THINK ]
// +----------------------------------------------------------------------
// | Copyright (c) 2006~2016 http://thinkphp.cn All rights reserved.
// +----------------------------------------------------------------------
// | Licensed ( http://www.apache.org/licenses/LICENSE-2.0 )
// +----------------------------------------------------------------------
// | Author: liu21st <liu21st@gmail.com>
// +----------------------------------------------------------------------

//------------------------
// ThinkPHP 助手函数
//-------------------------

use think\Cache;// 加载 Cache 类型
use think\Config;// 加载配置文件类
use think\Cookie;// 加载 Cookie
use think\Db;// 加载 Db
use think\Debug;// 加载 Debug
use think\exception\HttpException;// 加载 异常
use think\exception\HttpResponseException;// 加载 异常
use think\Lang;// 加载 语言
use think\Loader;// 加载 加载文件
use think\Log;// 加载 日志
use think\Request;// 请求
use think\Response;// 回应
use think\Session;//Session
use think\Url;// Url
use think\View;// View

// 作为一个helper 使用了很多的 东西
// a new namespace 用法

if (!function_exists('load_trait')) {
/**
* 快速导入Traits PHP5.5以上无需调用
* @param string    $class trait库
* @param string    $ext 类库后缀
* @return boolean
*/
function load_trait($class, $ext = EXT)
{
return Loader::import($class, TRAIT_PATH, $ext);// a trap function about this loader class and this import function
}// 加载文件，按照 不同的 标准类型
}

if (!function_exists('exception')) {
/**
* 抛出异常处理
*
* @param string    $msg  异常消息
* @param integer   $code 异常代码 默认为0
* @param string    $exception 异常类
*
* @throws Exception
*/
function exception($msg, $code = 0, $exception = '')
{
$e = $exception ?: '\think\Exception';// 使用异常处理类
throw new $e($msg, $code);//抛出 新异常
}// 异常 出来
}

if (!function_exists('debug')) {
/**
* 记录时间（微秒）和内存使用情况
* @param string            $start 开始标签
* @param string            $end 结束标签
* @param integer|string    $dec 小数位 如果是m 表示统计内存占用
* @return mixed
*/
function debug($start, $end = '', $dec = 6)
{
if ('' == $end) {
Debug::remark($start);// Debug::
} else {
return 'm' == $dec ? Debug::getRangeMem($start, $end) : Debug::getRangeTime($start, $end, $dec);
}// 如果是 m 的话，则记录的是 getRangeMem
}
}

if (!function_exists('lang')) {
/**
* 获取语言变量值
* @param string    $name 语言变量名
* @param array     $vars 动态变量值
* @param string    $lang 语言
* @return mixed
*/
function lang($name, $vars = [], $lang = '')
{
return Lang::get($name, $vars, $lang);// 获取语言配置， 对类的二次封装
// 这个版本 对比 3的版本 发现了 更多功能隐藏在了 class 里面，更多的面向对象了
}
}

if (!function_exists('config')) {
/**
* 获取和设置配置参数
* @param string|array  $name 参数名
* @param mixed         $value 参数值
* @param string        $range 作用域
* @return mixed
*/
function config($name = '', $value = null, $range = '')
{
if (is_null($value) && is_string($name)) {
return 0 === strpos($name, '?') ? Config::has(substr($name, 1), $range) : Config::get($name, $range);
// 中国 第一 超强 配置，太牛叉了，不错 通过不同的配置项，让 自己的函数 具有更强的功能
} else {
return Config::set($name, $value, $range);// other 否则 去设置 对应的 文件
}
}
}

if (!function_exists('input')) {
/**
* 获取输入数据 支持默认值和过滤
* @param string    $key 获取的变量名
* @param mixed     $default 默认值
* @param string    $filter 过滤方法
* @return mixed
*/
function input($key = '', $default = null, $filter = null)
{
if (0 === strpos($key, '?')) {
$key = substr($key, 1);
$has = true;
}// 判读 时候 包含 这个 输入 input 好巴适，去掉了 更多 浮躁，更多的融入了这个代码
if ($pos = strpos($key, '.')) {// 如果有这些 比如 input('get.ok')
// 指定参数来源
$method = substr($key, 0, $pos);
if (in_array($method, ['get', 'post', 'put', 'patch', 'delete', 'param', 'request', 'session', 'cookie', 'server', 'env', 'path', 'file'])) {
$key = substr($key, $pos + 1);
} else {
$method = 'param';
}
// 当非明确来源的时候，显示通用的来源
} else {
// 默认为自动判断
$method = 'param';// 默认也是这个
}
if (isset($has)) {
return request()->has($key, $method, $default);// 如果是 ?get.ok 去判读是否有这个
} else {
return request()->$method($key, $default, $filter);// 否则返回数据
// 比如 request()->get('ok','123','htmlspechialchar');
}
}
}

// 2016-11-08
if (!function_exists('widget')) {
/**
* 渲染输出Widget
* @param string    $name Widget名称
* @param array     $data 传人的参数
* @return mixed
*/
function widget($name, $data = [])
{
return Loader::action($name, $data, 'widget');
}// 渲染函数封装
}

if (!function_exists('model')) {
/**
* 实例化Model
* @param string    $name Model名称
* @param string    $layer 业务层名称
* @param bool      $appendSuffix 是否添加类名后缀
* @return \think\Model
*/
function model($name = '', $layer = 'model', $appendSuffix = false)
{
return Loader::model($name, $layer, $appendSuffix);
}// 加载 model 层
}

if (!function_exists('validate')) {
/**
* 实例化验证器
* @param string    $name 验证器名称
* @param string    $layer 业务层名称
* @param bool      $appendSuffix 是否添加类名后缀
* @return \think\Validate
*/
function validate($name = '', $layer = 'validate', $appendSuffix = false)
{
return Loader::validate($name, $layer, $appendSuffix);
}// 加载 validate 测试
}

if (!function_exists('db')) {
/**
* 实例化数据库类
* @param string        $name 操作的数据表名称（不含前缀）
* @param array|string  $config 数据库配置参数
* @param bool          $force 是否强制重新连接
* @return \think\db\Query
*/
function db($name = '', $config = [], $force = true)
{
return Db::connect($config, $force)->name($name);
}// 数据库 连接， 看来 全面拥抱面向对象 了
}

if (!function_exists('controller')) {
/**
* 实例化控制器 格式：[模块/]控制器
* @param string    $name 资源地址
* @param string    $layer 控制层名称
* @param bool      $appendSuffix 是否添加类名后缀
* @return \think\Controller
*/
function controller($name, $layer = 'controller', $appendSuffix = false)
{
return Loader::controller($name, $layer, $appendSuffix);
}// 真的是全面面向对象了
}

if (!function_exists('action')) {
/**
* 调用模块的操作方法 参数格式 [模块/控制器/]操作
* @param string        $url 调用地址
* @param string|array  $vars 调用参数 支持字符串和数组
* @param string        $layer 要调用的控制层名称
* @param bool          $appendSuffix 是否添加类名后缀
* @return mixed
*/
function action($url, $vars = [], $layer = 'controller', $appendSuffix = false)
{
return Loader::action($url, $vars, $layer, $appendSuffix);
}// 加载了 action 方式
}

if (!function_exists('import')) {
/**
* 导入所需的类库 同java的Import 本函数有缓存功能
* @param string    $class 类库命名空间字符串
* @param string    $baseUrl 起始路径
* @param string    $ext 导入的文件扩展名
* @return boolean
*/
function import($class, $baseUrl = '', $ext = EXT)
{
return Loader::import($class, $baseUrl, $ext);
}// 包含 同时可以缓存，牛叉
}

if (!function_exists('vendor')) {
/**
* 快速导入第三方框架类库 所有第三方框架的类库文件统一放到 系统的Vendor目录下面
* @param string    $class 类库
* @param string    $ext 类库后缀
* @return boolean
*/
function vendor($class, $ext = EXT)
{
return Loader::import($class, VENDOR_PATH, $ext);
}// 快速导入 vendor 框架
}

if (!function_exists('dump')) {
/**
* 浏览器友好的变量输出
* @param mixed     $var 变量
* @param boolean   $echo 是否输出 默认为true 如果为false 则返回输出字符串
* @param string    $label 标签 默认为空
* @return void|string
*/
function dump($var, $echo = true, $label = null)
{
return Debug::dump($var, $echo, $label);
}// 友好变量输出
}

if (!function_exists('url')) {
/**
* Url生成
* @param string        $url 路由地址
* @param string|array  $value 变量
* @param bool|string   $suffix 前缀
* @param bool|string   $domain 域名
* @return string
*/
function url($url = '', $vars = '', $suffix = true, $domain = false)
{
return Url::build($url, $vars, $suffix, $domain);
}// 设置 url 参数
}

if (!function_exists('session')) {
/**
* Session管理
* @param string|array  $name session名称，如果为数组表示进行session设置
* @param mixed         $value session值
* @param string        $prefix 前缀
* @return mixed
*/
function session($name, $value = '', $prefix = null)
{
if (is_array($name)) {
// 初始化
Session::init($name);
} elseif (is_null($name)) {
// 清除
Session::clear($value);
} elseif ('' === $value) {
// 判断或获取
return 0 === strpos($name, '?') ? Session::has(substr($name, 1), $prefix) : Session::get($name, $prefix);
} elseif (is_null($value)) {
// 删除
return Session::delete($name, $prefix);
} else {
// 设置
return Session::set($name, $value, $prefix);
}
}// session 判断 进行 不同类的封装 及 调用
}

if (!function_exists('cookie')) {
/**
* Cookie管理
* @param string|array  $name cookie名称，如果为数组表示进行cookie设置
* @param mixed         $value cookie值
* @param mixed         $option 参数
* @return mixed
*/
function cookie($name, $value = '', $option = null)
{
if (is_array($name)) {
// 初始化
Cookie::init($name);
} elseif (is_null($name)) {
// 清除
Cookie::clear($value);
} elseif ('' === $value) {
// 获取
return 0 === strpos($name, '?') ? Cookie::has(substr($name, 1), $option) : Cookie::get($name);
} elseif (is_null($value)) {
// 删除
return Cookie::delete($name);
} else {
// 设置
return Cookie::set($name, $value, $option);
}
}// cookie 系列 调用
}

if (!function_exists('cache')) {
/**
* 缓存管理
* @param mixed     $name 缓存名称，如果为数组表示进行缓存设置
* @param mixed     $value 缓存值
* @param mixed     $options 缓存参数
* @param string    $tag 缓存标签
* @return mixed
*/
function cache($name, $value = '', $options = null, $tag = null)
{
if (is_array($options)) {
// 缓存操作的同时初始化
Cache::connect($options);
} elseif (is_array($name)) {
// 缓存初始化
return Cache::connect($name);
}
if ('' === $value) {
// 获取缓存
return Cache::get($name);
} elseif (is_null($value)) {
// 删除缓存
return Cache::rm($name);
} else {
// 缓存数据
if (is_array($options)) {
$expire = isset($options['expire']) ? $options['expire'] : null; //修复查询缓存无法设置过期时间
} else {
$expire = is_numeric($options) ? $options : null; //默认快捷缓存设置过期时间
}
if (is_null($tag)) {
return Cache::set($name, $value, $expire);
} else {
return Cache::tag($tag)->set($name, $value, $expire);
}
}
}// 缓存处理
}

if (!function_exists('trace')) {
/**
* 记录日志信息
* @param mixed     $log log信息 支持字符串和数组
* @param string    $level 日志级别
* @return void|array
*/
function trace($log = '[think]', $level = 'log')
{
if ('[think]' === $log) {
return Log::getLog();
} else {
Log::record($log, $level);
}
}// 执行 显示 调试记录
}

if (!function_exists('request')) {
/**
* 获取当前Request对象实例
* @return Request
*/
function request()
{
return Request::instance();
}// 请求
}

if (!function_exists('response')) {
/**
* 创建普通 Response 对象实例
* @param mixed      $data   输出数据
* @param int|string $code   状态码
* @param array      $header 头信息
* @param string     $type
* @return Response
*/
function response($data = [], $code = 200, $header = [], $type = 'html')
{
return Response::create($data, $type, $code, $header);
}// 返回对象创建
}

if (!function_exists('view')) {
/**
* 渲染模板输出
* @param string    $template 模板文件
* @param array     $vars 模板变量
* @param array     $replace 模板替换
* @param integer   $code 状态码
* @return \think\response\View
*/
function view($template = '', $vars = [], $replace = [], $code = 200)
{
return Response::create($template, 'view', $code)->replace($replace)->assign($vars);
}// view 模板渲染输出
}

if (!function_exists('json')) {
/**
* 获取\think\response\Json对象实例
* @param mixed   $data 返回的数据
* @param integer $code 状态码
* @param array   $header 头部
* @param array   $options 参数
* @return \think\response\Json
*/
function json($data = [], $code = 200, $header = [], $options = [])
{
return Response::create($data, 'json', $code, $header, $options);
}// json 格式的 输出
}

if (!function_exists('jsonp')) {
/**
* 获取\think\response\Jsonp对象实例
* @param mixed   $data    返回的数据
* @param integer $code    状态码
* @param array   $header 头部
* @param array   $options 参数
* @return \think\response\Jsonp
*/
function jsonp($data = [], $code = 200, $header = [], $options = [])
{
return Response::create($data, 'jsonp', $code, $header, $options);
}// jsonp 格式输出
}

if (!function_exists('xml')) {
/**
* 获取\think\response\Xml对象实例
* @param mixed   $data    返回的数据
* @param integer $code    状态码
* @param array   $header  头部
* @param array   $options 参数
* @return \think\response\Xml
*/
function xml($data = [], $code = 200, $header = [], $options = [])
{
return Response::create($data, 'xml', $code, $header, $options);
}//xml 格式输出
}

if (!function_exists('redirect')) {
/**
* 获取\think\response\Redirect对象实例
* @param mixed         $url 重定向地址 支持Url::build方法的地址
* @param array|integer $params 额外参数
* @param integer       $code 状态码
* @return \think\response\Redirect
*/
function redirect($url = [], $params = [], $code = 302)
{
if (is_integer($params)) {
$code   = $params;
$params = [];
}
return Response::create($url, 'redirect', $code)->params($params);
}// 直接 目录 跳转
}

if (!function_exists('abort')) {
/**
* 抛出HTTP异常
* @param integer|Response      $code 状态码 或者 Response对象实例
* @param string                $message 错误信息
* @param array                 $header 参数
*/
function abort($code, $message = null, $header = [])
{
if ($code instanceof Response) {
throw new HttpResponseException($code);
} else {
throw new HttpException($code, $message, null, $header);
}
}// 抛出 异常 错误
}

if (!function_exists('halt')) {
/**
* 调试变量并且中断输出
* @param mixed      $var 调试变量或者信息
*/
function halt($var)
{
dump($var);
throw new HttpResponseException(new Response);
}// 终止 错误
}

if (!function_exists('token')) {
/**
* 生成表单令牌
* @param string $name 令牌名称
* @param mixed  $type 令牌生成方法
* @return string
*/
function token($name = '__token__', $type = 'md5')
{
$token = Request::instance()->token($name, $type);
return '<input type="hidden" name="' . $name . '" value="' . $token . '" />';
}// 生成 tokene 验证令牌
}