<?php
declare(strict_types=1);
* +----------------------------------------------------------------------
* | ThinkAdmin Plugin for ThinkAdmin
* +----------------------------------------------------------------------
* | 版权所有 2014~2026 ThinkAdmin [ thinkadmin.top ]
* +----------------------------------------------------------------------
* | 官方网站: https://thinkadmin.top
* +----------------------------------------------------------------------
* | 开源协议 ( https://mit-license.org )
* | 免责声明 ( https://thinkadmin.top/disclaimer )
* | 会员特权 ( https://thinkadmin.top/vip-introduce )
* +----------------------------------------------------------------------
* | gitee 代码仓库：https://gitee.com/zoujingli/ThinkAdmin
* | github 代码仓库：https://github.com/zoujingli/ThinkAdmin
* +----------------------------------------------------------------------
*/
use think\admin\Exception;
use think\admin\extend\CodeExtend;
use think\admin\extend\HttpExtend;
use think\admin\Helper;
use think\admin\helper\QueryHelper;
use think\admin\helper\TokenHelper;
use think\admin\helper\ValidateHelper;
use think\admin\Library;
use think\admin\service\AdminService;
use think\admin\service\QueueService;
use think\admin\service\RuntimeService;
use think\admin\service\SystemService;
use think\admin\Storage;
use think\db\BaseQuery;
use think\db\Query;
use think\helper\Str;
use think\Model;
if (!function_exists('p')) {
* 打印输出数据到文件.
* @param mixed $data 输出的数据
* @param bool $new 强制替换文件
* @param ?string $file 保存文件名称
* @return false|int
*/
function p($data, bool $new = false, ?string $file = null)
{
return SystemService::putDebug($data, $new, $file);
}
}
if (!function_exists('m')) {
* 动态创建模型对象
* @param string $name 模型名称
* @param array $data 初始数据
* @param string $conn 指定连接
*/
function m(string $name, array $data = [], string $conn = ''): Model
{
return Helper::buildModel($name, $data, $conn);
}
}
if (!function_exists('auth')) {
* 访问权限检查.
*/
function auth(?string $node): bool
{
return AdminService::check($node);
}
}
if (!function_exists('admuri')) {
* 生成后台 URL 地址
* @param string $url 路由地址
* @param array $vars PATH 变量
* @param bool|string $suffix 后缀
* @param bool|string $domain 域名
*/
function admuri(string $url = '', array $vars = [], $suffix = true, $domain = false): string
{
return sysuri('admin/index/index', [], $suffix, $domain) . '#' . url($url, $vars)->build();
}
}
if (!function_exists('_vali')) {
* 快捷输入并验证（ 支持 规则 # 别名 ）.
* @param array $rules 验证规则（ 验证信息数组 ）
* @param array|string $type 输入方式 ( post. 或 get. )
* @param null|callable $callable 异常处理操作
*/
function _vali(array $rules, $type = '', ?callable $callable = null): array
{
return ValidateHelper::instance()->init($rules, $type, $callable);
}
}
if (!function_exists('_query')) {
* 快捷查询逻辑器.
* @param BaseQuery|Model|string $dbQuery
* @param null|array|string $input
*/
function _query($dbQuery, $input = null): QueryHelper
{
return QueryHelper::instance()->init($dbQuery, $input);
}
}
if (!function_exists('sysvar')) {
* 读写单次请求的内存缓存.
* @param null|string $name 数据名称
* @param null|mixed $value 数据内容
* @return null|array|mixed 返回内容
*/
function sysvar(?string $name = null, $value = null)
{
static $swap = [];
if ($name === '' && $value === '') {
return $swap = [];
}
if (is_null($value)) {
return is_null($name) ? $swap : ($swap[$name] ?? null);
}
return $swap[$name] = $value;
}
}
if (!function_exists('sysuri')) {
* 生成最短 URL 地址
* @param string $url 路由地址
* @param array $vars PATH 变量
* @param bool|string $suffix 后缀
* @param bool|string $domain 域名
*/
function sysuri(string $url = '', array $vars = [], $suffix = true, $domain = false): string
{
if (preg_match('#^(https?://|\|/|@)#', $url)) {
return Library::$sapp->route->buildUrl($url, $vars)->suffix($suffix)->domain($domain)->build();
}
if (count($attr = $url === '' ? [] : explode('/', rtrim($url, '/'))) < 3) {
$map = [Library::$sapp->http->getName(), Library::$sapp->request->controller(), Library::$sapp->request->action(true)];
while (count($attr) < 3) {
array_unshift($attr, $map[2 - count($attr)] ?? 'index');
}
}
$attr[1] = Str::snake($attr[1]);
[$rcf, $tmp] = [Library::$sapp->config->get('route', []), uniqid('think_admin_replace_temp_vars_')];
$map = [Str::lower($rcf['default_app'] ?? ''), Str::snake($rcf['default_controller'] ?? ''), Str::lower($rcf['default_action'] ?? '')];
for ($idx = count($attr) - 1; $idx >= 0; --$idx) {
if ($attr[$idx] == ($map[$idx] ?: 'index')) {
$attr[$idx] = $tmp;
} else {
break;
}
}
$url = Library::$sapp->route->buildUrl(join('/', $attr), $vars)->suffix($suffix)->domain($domain)->build();
$ext = is_string($suffix) ? $suffix : ($rcf['url_html_suffix'] ?? 'html');
$new = preg_replace("#/{$tmp}(\\.{$ext})?#", '', $old = parse_url($url, PHP_URL_PATH) ?: '', -1, $count);
$count > 0 && $suffix && $new && $ext !== '' && $new !== Library::$sapp->request->baseUrl() && $new .= ".{$ext}";
return str_replace($old, $new ?: '/', $url);
}
}
if (!function_exists('encode')) {
* 加密 UTF8 字符串.
*/
function encode(string $content): string
{
[$chars, $length] = ['', strlen($string = CodeExtend::text2utf8($content))];
for ($i = 0; $i < $length; ++$i) {
$chars .= str_pad(base_convert(strval(ord($string[$i])), 10, 36), 2, '0', 0);
}
return $chars;
}
}
if (!function_exists('decode')) {
* 解密 UTF8 字符串.
*/
function decode(string $content): string
{
$chars = '';
foreach (str_split($content, 2) as $char) {
$chars .= chr(intval(base_convert($char, 36, 10)));
}
return CodeExtend::text2utf8($chars);
}
}
if (!function_exists('str2arr')) {
* 字符串转数组.
* @param string $text 待转内容
* @param string $separ 分隔字符
* @param ?array $allow 限定规则
*/
function str2arr(string $text, string $separ = ',', ?array $allow = null): array
{
$items = [];
foreach (explode($separ, trim($text, $separ)) as $item) {
$item = trim($item);
if ($item !== '' && (!is_array($allow) || in_array($item, $allow, true))) {
$items[] = $item;
}
}
return $items;
}
}
if (!function_exists('arr2str')) {
* 数组转字符串.
* @param array $data 待转数组
* @param string $separ 分隔字符
* @param ?array $allow 限定规则
*/
function arr2str(array $data, string $separ = ',', ?array $allow = null): string
{
foreach ($data as $key => $item) {
$item = is_string($item) ? trim($item) : $item;
if ($item === '' || (is_array($allow) && !in_array($item, $allow, true))) {
unset($data[$key]);
} else {
$data[$key] = $item;
}
}
return $separ . join($separ, $data) . $separ;
}
}
if (!function_exists('isDebug')) {
* 调试模式运行.
*/
function isDebug(): bool
{
return RuntimeService::isDebug();
}
}
if (!function_exists('isOnline')) {
* 产品模式运行.
*/
function isOnline(): bool
{
return RuntimeService::isOnline();
}
}
if (!function_exists('sysconf')) {
* 获取或配置系统参数.
* @param string $name 参数名称
* @param mixed $value 参数内容
* @return mixed
* @throws Exception
*/
function sysconf(string $name = '', $value = null)
{
if (is_null($value) && is_string($name)) {
return SystemService::get($name);
}
return SystemService::set($name, $value);
}
}
if (!function_exists('sysdata')) {
* JSON 数据读取与存储.
* @param string $name 数据名称
* @param mixed $value 数据内容
* @return mixed
* @throws Exception
*/
function sysdata(string $name, $value = null)
{
if (is_null($value)) {
return SystemService::getData($name);
}
return SystemService::setData($name, $value);
}
}
if (!function_exists('syspath')) {
* 获取文件绝对路径.
* @param string $name 文件路径
* @param ?string $root 程序根路径
*/
function syspath(string $name = '', ?string $root = null): string
{
if (is_null($root)) {
$root = Library::$sapp->getRootPath();
}
$attr = ['/' => DIRECTORY_SEPARATOR, '\\' => DIRECTORY_SEPARATOR];
return rtrim($root, '\/') . DIRECTORY_SEPARATOR . ltrim(strtr($name, $attr), '\/');
}
}
if (!function_exists('sysoplog')) {
* 写入系统日志.
* @param string $action 日志行为
* @param string $content 日志内容
*/
function sysoplog(string $action, string $content): bool
{
return SystemService::setOplog($action, $content);
}
}
if (!function_exists('systoken')) {
* 生成 CSRF-TOKEN 参数.
*/
function systoken(): string
{
return TokenHelper::token();
}
}
if (!function_exists('sysqueue')) {
* 注册异步处理任务
* @param string $title 任务名称
* @param string $command 执行内容
* @param int $later 延时执行时间
* @param array $data 任务附加数据
* @param int $rscript 任务类型(0单例,1多例)
* @param int $loops 循环等待时间
* @throws Exception
*/
function sysqueue(string $title, string $command, int $later = 0, array $data = [], int $rscript = 1, int $loops = 0): string
{
return QueueService::register($title, $command, $later, $data, $rscript, $loops)->code;
}
}
if (!function_exists('enbase64url')) {
* Base64安全URL编码
*/
function enbase64url(string $string): string
{
return CodeExtend::enSafe64($string);
}
}
if (!function_exists('debase64url')) {
* Base64安全URL解码
*/
function debase64url(string $string): string
{
return CodeExtend::deSafe64($string);
}
}
if (!function_exists('xss_safe')) {
* 文本内容XSS过滤.
*/
function xss_safe(string $text): string
{
$rules = ['#<script.*?<\/script>#is' => '', '#(\s)on(\w+=\S)#i' => '$1οn$2'];
return preg_replace(array_keys($rules), array_values($rules), trim($text));
}
}
if (!function_exists('http_get')) {
* 以 get 模拟网络请求
* @param string $url HTTP请求URL地址
* @param array|string $query GET请求参数
* @param array $options CURL参数
* @return bool|string
*/
function http_get(string $url, $query = [], array $options = [])
{
return HttpExtend::get($url, $query, $options);
}
}
if (!function_exists('http_post')) {
* 以 post 模拟网络请求
* @param string $url HTTP请求URL地址
* @param array|string $data POST请求数据
* @param array $options CURL参数
* @return bool|string
*/
function http_post(string $url, $data, array $options = [])
{
return HttpExtend::post($url, $data, $options);
}
}
if (!function_exists('data_save')) {
* 数据增量保存.
* @param Model|Query|string $dbQuery
* @param array $data 需要保存或更新的数据
* @param string $key 条件主键限制
* @param mixed $where 其它的where条件
* @return bool|int
* @throws Exception
*/
function data_save($dbQuery, array $data, string $key = 'id', $where = [])
{
return SystemService::save($dbQuery, $data, $key, $where);
}
}
if (!function_exists('down_file')) {
* 下载远程文件到本地.
* @param string $source 远程文件地址
* @param bool $force 是否强制重新下载
* @param int $expire 强制本地存储时间
*/
function down_file(string $source, bool $force = false, int $expire = 0): string
{
return Storage::down($source, $force, $expire)['url'] ?? $source;
}
}
if (!function_exists('trace_file')) {
* 输出异常数据到文件.
* @param Throwable $exception 支持 Exception 与 Error（PHP 7+）
*/
function trace_file(Throwable $exception): bool
{
$path = Library::$sapp->getRuntimePath() . 'trace';
if (!is_dir($path)) {
mkdir($path, 0777, true);
}
$name = substr($exception->getFile(), strlen(syspath()));
$file = $path . DIRECTORY_SEPARATOR . date('Ymd_His_') . strtr($name, ['/' => '.', '\\' => '.']);
$json = json_encode($exception instanceof Exception ? $exception->getData() : [], 64 | 128 | 256);
$class = get_class($exception);
return file_put_contents(
$file,
"[CODE] {$exception->getCode()}" . PHP_EOL
. "[INFO] {$exception->getMessage()}" . PHP_EOL
. ($exception instanceof Exception ? "[DATA] {$json}" . PHP_EOL : '')
. "[FILE] {$class} in {$name} line {$exception->getLine()}" . PHP_EOL
. '[TIME] ' . date('Y-m-d H:i:s') . PHP_EOL . PHP_EOL
. '[TRACE]' . PHP_EOL . $exception->getTraceAsString()
) !== false;
}
}
if (!function_exists('format_bytes')) {
* 文件字节单位转换.
* @param int|string $size
*/
function format_bytes($size): string
{
if (is_numeric($size)) {
$units = ['B', 'KB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'];
for ($i = 0; $size >= 1024 && $i < 4; ++$i) {
$size /= 1024;
}
return round($size, 2) . ' ' . $units[$i];
}
return $size;
}
}
if (!function_exists('format_datetime')) {
* 日期格式标准输出.
* @param int|string $datetime 输入日期
* @param string $format 输出格式
*/
function format_datetime($datetime, string $format = 'Y年m月d日 H:i:s'): string
{
if (empty($datetime)) {
return '-';
}
if (is_numeric($datetime)) {
return date(lang($format), intval($datetime));
}
if ($timestamp = strtotime((string)$datetime)) {
return date(lang($format), $timestamp);
}
return (string)$datetime;
}
}
