框架内置函数

框架默认有以下全局函数，可在系统的任意位置直接调用函数。

打印输出数据到文件

输出数据并保存到 Runtime 目录下面的文件。

参数：

$data（mixed）：要输出的数据。
$new（bool）：是否强制替换文件，默认为 false。
$file（string|null）：保存文件名称。如果为 null，则只输出数据而不保存到文件，默认为 null。

返回：（false|int）：如果保存成功，则返回保存到文件的字节数；如果保存失败，则返回 false。

p( $data, bool $new = false, ?string $file = null );

动态创建模型对象

创建指定模型对象并初始化数据。

参数：

$name（string）：模型名称。
$data（array）：初始数据，默认为空数组。
$conn（string）：指定连接，默认为空字符串。

返回： （\think\admin\Model）：返回创建的模型对象。

m( string $name, array $data=[], string $conn='' );

访问权限节点检查

检查用户是否具有指定节点的权限。

参数：

$node（?string）：节点名称，可选参数。

返回： （boolean）：如果用户具有指定节点的权限，则返回 true；否则返回 false。

// 参数 ?string $node
// 返回 boolean
auth(?string $node);

生成后台 URL 地址

快速生成后台可访问的 URI 地址，由 admin 入口及功能节点路径组成。

// 参数 string $url 路由地址
// 参数 array $vars PATH 变量
// 参数 boolean|string $suffix 后缀
// 参数 boolean|string $domain 域名
// 返回 string
admuri( string $url, array $vars, boolean|string $suffix, boolean|string $domain);

生成最短 URL 地址

生成最短可访问系统的 URL 地址，类似 ThinkPHP 带的 URL 地址。

// 参数 string $url 路由地址
// 参数 array $vars PATH 变量
// 参数 boolean|string $suffix 后缀
// 参数 boolean|string $domain 域名
// 返回 string
sysuri( string $url, array $vars, boolean|string $suffix, boolean|string $domain );

加密 UTF8 字符串

// 参数 string $content
// 返回 string
encode(string $content);

解密 UTF8 字符串

// 参数 string $content
// 返回 string
decode(string $content);

通用字符串转数组

// 参数 string $text 待转内容
// 参数 string $separ 分隔字符
// 参数 null|array $allow 限定规则
// 返回 array
str2arr(string $text, string $separ = ',', ?$allow=null);

通用数组转字符串

// 参数 string $data 待转数组
// 参数 string $separ 分隔字符
// 参数 null|array $allow 限定规则
// 返回 array
arr2str(array $data, string $separ = ',', ?$allow=null);

判断是否调试模式运行

isDebug()

判断是否产品模式运行

isOnline()

获取或配置系统参数

// 参数 string $name 参数名称
// 参数 mixed $value 参数内容
// 返回 mixed
sysconf(string $name, $value)

数据读取与存储

// JSON 数据读取与存储
// 参数 string $name 数据名称
// 参数 mixed $value 数据内容
// 返回 mixed
sysdata(string $name, $value)

获取文件绝对路径

// JSON 数据读取与存储
// 参数 string $name 数据名称
// 参数 mixed $value 数据内容
// 返回 mixed
syspath(string $name, ?string $root = null)

写入系统操作日志

// 参数 string $action 日志行为
// 参数 string $content 日志内容
// 返回 boolean
sysoplog(string $action, string $content)

生成 CSRF-TOKEN 参数

systoken();

注册异步处理任务

// 参数 string $title 任务名称
// 参数 string $command 执行内容
// 参数 integer $later 延时执行时间
// 参数 array $data 任务附加数据
// 参数 integer $rscript 任务类型(0单例,1多例)
// 参数 integer $loops 循环等待时间
// 返回 string
sysqueue(string $title, string $command，int $later=0, array $data=[], int $rscript=0, int $loops=0)

Base64 安全 URL 编码

// 参数 string $string
// 返回 string
enbase64url(string $string);

Base64 安全 URL 解码

// 参数 string $string
// 返回 string
debase64url(string $string);

文本内容XSS过滤

// 参数 string $text
// 返回 string
xss_safe(string $text);

以 get 模拟网络请求

// 参数 string $url HTTP请求URL地址
// 参数 array|string $query GET请求参数
// 参数 array $options CURL参数
// 返回 boolean|string
http_get(string $url, $query = [], array $options = []);

以 post 模拟网络请求

// 参数 string $url HTTP请求URL地址
// 参数 array|string $data POST请求数据
// 参数 array $options CURL参数
// 返回 boolean|string
http_post(string $url, $data = [], array $options = []);

数据增量保存

// 参数 Model|Query|string $dbQuery
// 参数 array $data 需要保存或更新的数据
// 参数 string $key 条件主键限制
// 参数 mixed $where 其它的where条件
// 返回 boolean|integer
data_save($dbQuery, array $data = [], string $key='id', $where = []);

下载远程文件到本地

// 参数 string $source 远程文件地址
// 参数 boolean $force 是否强制重新下载
// 参数 integer $expire 强制本地存储时间
// 返回 string
down_file(string $source, bool $force = false, int $expre = 0);

输出异常数据到文件

// 参数 \Exception $exception
// 返回 boolean
trace_file(\Exception $exception)

文件字节单位转换

// 参数 string|integer $size 字节
// 返回 string
format_bytes($size);

日期格式标准输出

// 参数 int|string $datetime 输入日期
// 参数 string $format 输出格式
// 返回 string
format_datetime($datetime, string $format = "Y年m月d日 H:i:s");