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

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

use think\Container;
use think\Db;
use think\exception\HttpException;
use think\exception\HttpResponseException;
use think\facade\Cache;
use think\facade\Config;
use think\facade\Cookie;
use think\facade\Debug;
use think\facade\Env;
use think\facade\Hook;
use think\facade\Lang;
use think\facade\Log;
use think\facade\Request;
use think\facade\Route;
use think\facade\Session;
use think\facade\Url;
use think\Response;
use think\route\RuleItem;

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('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 app()->action($url, $vars, $layer, $appendSuffix);
 }
}

if (!function_exists('app')) {
 /**
 * 快速获取容器中的实例 支持依赖注入
 * @param string $name 类名或标识 默认获取当前应用实例
 * @param array $args 参数
 * @param bool $newInstance 是否每次创建新的实例
 * @return mixed|\think\App
 */
 function app($name = 'think\App', $args = [], $newInstance = false)
 {
 return Container::get($name, $args, $newInstance);
 }
}

if (!function_exists('behavior')) {
 /**
 * 执行某个行为(run方法) 支持依赖注入
 * @param mixed $behavior 行为类名或者别名
 * @param mixed $args 参数
 * @return mixed
 */
 function behavior($behavior, $args = null)
 {
 return Hook::exec($behavior, $args);
 }
}

if (!function_exists('bind')) {
 /**
 * 绑定一个类到容器
 * @access public
 * @param string $abstract 类标识、接口
 * @param mixed $concrete 要绑定的类、闭包或者实例
 * @return Container
 */
 function bind($abstract, $concrete = null)
 {
 return Container::getInstance()->bindTo($abstract, $concrete);
 }
}

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 0 === strpos($name, '?') ? Cache::has(substr($name, 1)) : 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('call')) {
 /**
 * 调用反射执行callable 支持依赖注入
 * @param mixed $callable 支持闭包等callable写法
 * @param array $args 参数
 * @return mixed
 */
 function call($callable, $args = [])
 {
 return Container::getInstance()->invoke($callable, $args);
 }
}

if (!function_exists('class_basename')) {
 /**
 * 获取类名(不包含命名空间)
 *
 * @param string|object $class
 * @return string
 */
 function class_basename($class)
 {
 $class = is_object($class) ? get_class($class) : $class;
 return basename(str_replace('\\', '/', $class));
 }
}

if (!function_exists('class_uses_recursive')) {
 /**
 *获取一个类里所有用到的trait,包括父类的
 *
 * @param $class
 * @return array
 */
 function class_uses_recursive($class)
 {
 if (is_object($class)) {
 $class = get_class($class);
 }

 $results = [];
 $classes = array_merge([$class => $class], class_parents($class));
 foreach ($classes as $class) {
 $results += trait_uses_recursive($class);
 }

 return array_unique($results);
 }
}

if (!function_exists('config')) {
 /**
 * 获取和设置配置参数
 * @param string|array $name 参数名
 * @param mixed $value 参数值
 * @return mixed
 */
 function config($name = '', $value = null)
 {
 if (is_null($value) && is_string($name)) {
 if ('.' == substr($name, -1)) {
 return Config::pull(substr($name, 0, -1));
 }

 return 0 === strpos($name, '?') ? Config::has(substr($name, 1)) : Config::get($name);
 } else {
 return Config::set($name, $value);
 }
 }
}

if (!function_exists('container')) {
 /**
 * 获取容器对象实例
 * @return Container
 */
 function container()
 {
 return Container::getInstance();
 }
}

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

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);
 }
 }
}

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('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);
 } else {
 return 'm' == $dec ? Debug::getRangeMem($start, $end) : Debug::getRangeTime($start, $end, $dec);
 }
 }
}

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('env')) {
 /**
 * 获取环境变量值
 * @access public
 * @param string $name 环境变量名(支持二级 .号分割)
 * @param string $default 默认值
 * @return mixed
 */
 function env($name = null, $default = null)
 {
 return Env::get($name, $default);
 }
}

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('halt')) {
 /**
 * 调试变量并且中断输出
 * @param mixed $var 调试变量或者信息
 */
 function halt($var)
 {
 dump($var);

 throw new HttpResponseException(new Response);
 }
}

if (!function_exists('input')) {
 /**
 * 获取输入数据 支持默认值和过滤
 * @param string $key 获取的变量名
 * @param mixed $default 默认值
 * @param string $filter 过滤方法
 * @return mixed
 */
 function input($key = '', $default = null, $filter = '')
 {
 if (0 === strpos($key, '?')) {
 $key = substr($key, 1);
 $has = true;
 }

 if ($pos = strpos($key, '.')) {
 // 指定参数来源
 $method = substr($key, 0, $pos);
 if (in_array($method, ['get', 'post', 'put', 'patch', 'delete', 'route', '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);
 } else {
 return request()->$method($key, $default, $filter);
 }
 }
}

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);
 }
}

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);
 }
}

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);
 }
}

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 app()->model($name, $layer, $appendSuffix);
 }
}

if (!function_exists('parse_name')) {
 /**
 * 字符串命名风格转换
 * type 0 将Java风格转换为C的风格 1 将C风格转换为Java的风格
 * @param string $name 字符串
 * @param integer $type 转换类型
 * @param bool $ucfirst 首字母是否大写(驼峰规则)
 * @return string
 */
 function parse_name($name, $type = 0, $ucfirst = true)
 {
 if ($type) {
 $name = preg_replace_callback('/_([a-zA-Z])/', function ($match) {
 return strtoupper($match[1]);
 }, $name);

 return $ucfirst ? ucfirst($name) : lcfirst($name);
 } else {
 return strtolower(trim(preg_replace("/[A-Z]/", "_\\0", $name), "_"));
 }
 }
}

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('request')) {
 /**
 * 获取当前Request对象实例
 * @return Request
 */
 function request()
 {
 return app('request');
 }
}

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('route')) {
 /**
 * 路由注册
 * @param string $rule 路由规则
 * @param mixed $route 路由地址
 * @param array $option 路由参数
 * @param array $pattern 变量规则
 * @return RuleItem
 */
 function route($rule, $route, $option = [], $pattern = [])
 {
 return Route::rule($rule, $route, '*', $option, $pattern);
 }
}

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);
 }
 }
}

if (!function_exists('token')) {
 /**
 * 生成表单令牌
 * @param string $name 令牌名称
 * @param mixed $type 令牌生成方法
 * @return string
 */
 function token($name = '__token__', $type = 'md5')
 {
 $token = Request::token($name, $type);

 return '<input type="hidden" name="' . $name . '" value="' . $token . '" />';
 }
}

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

if (!function_exists('trait_uses_recursive')) {
 /**
 * 获取一个trait里所有引用到的trait
 *
 * @param string $trait
 * @return array
 */
 function trait_uses_recursive($trait)
 {
 $traits = class_uses($trait);
 foreach ($traits as $trait) {
 $traits += trait_uses_recursive($trait);
 }

 return $traits;
 }
}

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

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

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

if (!function_exists('widget')) {
 /**
 * 渲染输出Widget
 * @param string $name Widget名称
 * @param array $data 传入的参数
 * @return mixed
 */
 function widget($name, $data = [])
 {
 return app()->action($name, $data, 'widget');
 }
}

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);
 }
}