zhamao-robot/zhamao-framework
1
0
Fork 0
mirror of https://github.com/zhamao-robot/zhamao-framework.git synced 2026-07-23 00:25:35 +08:00
Code Issues Packages Projects Releases Wiki Activity

refactor global functions

Browse Source
This commit is contained in:
sunxyw
2022-03-21 20:08:09 +08:00
parent c364084cb2
commit 680e6a8c5f
1 changed files with 418 additions and 135 deletions
Download Patch File Download Diff File Expand all files Collapse all files

553
src/ZM/global_functions.php
View File

@@ -9,6 +9,7 @@ use Swoole\Coroutine\System;
use Swoole\WebSocket\Server; use Swoole\WebSocket\Server;
use Symfony\Component\VarDumper\VarDumper; use Symfony\Component\VarDumper\VarDumper;
use ZM\API\OneBotV11; use ZM\API\OneBotV11;
use ZM\API\ZMRobot;
use ZM\Config\ZMConfig; use ZM\Config\ZMConfig;
use ZM\ConnectionManager\ManagerGM; use ZM\ConnectionManager\ManagerGM;
use ZM\Console\Console; use ZM\Console\Console;
@@ -16,7 +17,6 @@ use ZM\Context\Context;
use ZM\Context\ContextInterface; use ZM\Context\ContextInterface;
use ZM\Event\EventManager; use ZM\Event\EventManager;
use ZM\Exception\RobotNotFoundException; use ZM\Exception\RobotNotFoundException;
use ZM\Exception\ZMException;
use ZM\Exception\ZMKnownException; use ZM\Exception\ZMKnownException;
use ZM\Framework; use ZM\Framework;
use ZM\Store\LightCacheInside; use ZM\Store\LightCacheInside;
@@ -24,14 +24,16 @@ use ZM\Store\ZMAtomic;
use ZM\Store\ZMBuf; use ZM\Store\ZMBuf;
use ZM\Utils\DataProvider; use ZM\Utils\DataProvider;
function getClassPath($class_name) /**
* 获取类路径
*/
function get_class_path(string $class_name): ?string
{ {
$dir = str_replace('\\', '/', $class_name); $dir = str_replace('\\', '/', $class_name);
$dir2 = DataProvider::getSourceRootDir() . '/src/' . $dir . '.php'; $dir = DataProvider::getSourceRootDir() . '/src/' . $dir . '.php';
// echo "@@@".$dir2.PHP_EOL; $dir = str_replace('\\', '/', $dir);
$dir2 = str_replace('\\', '/', $dir2); if (file_exists($dir)) {
if (file_exists($dir2)) { return $dir;
return $dir2;
} }
return null; return null;
} }
@@ -45,10 +47,10 @@ function _zm_env_check()
if (!extension_loaded('swoole')) { if (!extension_loaded('swoole')) {
exit(zm_internal_errcode('E00001') . "Can not find swoole extension.\n"); exit(zm_internal_errcode('E00001') . "Can not find swoole extension.\n");
} }
if (version_compare(SWOOLE_VERSION, '4.5.0') == -1) { if (version_compare(SWOOLE_VERSION, '4.5.0') === -1) {
exit(zm_internal_errcode('E00002') . 'You must install swoole version >= 4.5.0 !'); exit(zm_internal_errcode('E00002') . 'You must install swoole version >= 4.5.0 !');
} }
if (version_compare(PHP_VERSION, '7.2') == -1) { if (version_compare(PHP_VERSION, '7.2') === -1) {
exit(zm_internal_errcode('E00003') . 'PHP >= 7.2 required.'); exit(zm_internal_errcode('E00003') . 'PHP >= 7.2 required.');
} }
if (version_compare(SWOOLE_VERSION, '4.6.7') < 0 && !extension_loaded('pcntl')) { if (version_compare(SWOOLE_VERSION, '4.6.7') < 0 && !extension_loaded('pcntl')) {
@@ -58,21 +60,20 @@ function _zm_env_check()
} }
/** /**
* 使用自己定义的万（san）能分割函数 * 分割消息字符串
* @param $msg *
* @param bool $ban_comma * @param array $includes 需要进行切割的字符串，默认包含空格及制表符（\t)
*/ */
function explodeMsg($msg, $ban_comma = false): array function explode_msg(string $msg, array $includes = [' ', "\t"]): array
{ {
$msg = str_replace(' ', "\n", trim($msg)); $msg = trim($msg);
if (!$ban_comma) { foreach ($includes as $v) {
// $msg = str_replace("，", "\n", $msg); $msg = str_replace($v, "\n", $msg);
$msg = str_replace("\t", "\n", $msg);
} }
$msgs = explode("\n", $msg); $msg_seg = explode("\n", $msg);
$ls = []; $ls = [];
foreach ($msgs as $v) { foreach ($msg_seg as $v) {
if (trim($v) == '') { if (empty(trim($v))) {
continue; continue;
} }
$ls[] = trim($v); $ls[] = trim($v);
@@ -80,93 +81,99 @@ function explodeMsg($msg, $ban_comma = false): array
return $ls; return $ls;
} }
/** @noinspection PhpUnused */ /**
function unicode_decode($str) * 解码Unicode字符串
*/
function unicode_decode(string $str): ?string
{ {
return preg_replace_callback('/\\\\u([0-9a-f]{4})/i', function ($matches) { return preg_replace_callback('/\\\\u([0-9a-f]{4})/i', static function ($matches) {
return mb_convert_encoding(pack('H*', $matches[1]), 'UTF-8', 'UCS-2BE'); return mb_convert_encoding(pack('H*', $matches[1]), 'UTF-8', 'UCS-2BE');
}, $str); }, $str);
} }
function matchPattern($pattern, $context): bool /**
* 格式匹配
*/
function match_pattern(string $pattern, string $subject): bool
{ {
if (mb_substr($pattern, 0, 1) == '' && mb_substr($context, 0, 1) == '') { if (mb_strpos($pattern, '') === 0 && mb_strpos($subject, '') === 0) {
return true; return true;
} }
if (mb_substr($pattern, 0, 1) == '*' && mb_substr($pattern, 1, 1) != '' && mb_substr($context, 0, 1) == '') { if (mb_strpos($pattern, '*') === 0 && mb_substr($pattern, 1, 1) !== '' && mb_strpos($subject, '') === 0) {
return false; return false;
} }
if (mb_substr($pattern, 0, 1) == mb_substr($context, 0, 1)) { if (mb_strpos($pattern, mb_substr($subject, 0, 1)) === 0) {
return matchPattern(mb_substr($pattern, 1), mb_substr($context, 1)); return match_pattern(mb_substr($pattern, 1), mb_substr($subject, 1));
} }
if (mb_substr($pattern, 0, 1) == '*') { if (mb_strpos($pattern, '*') === 0) {
return matchPattern(mb_substr($pattern, 1), $context) || matchPattern($pattern, mb_substr($context, 1)); return match_pattern(mb_substr($pattern, 1), $subject) || match_pattern($pattern, mb_substr($subject, 1));
} }
return false; return false;
} }
function split_explode($del, $str, $divide_en = false): array function split_explode(string $del, string $string, bool $divide_en = false): array
{ {
$str = explode($del, $str); $str = explode($del, $string);
for ($i = 0; $i < mb_strlen($str[0]); ++$i) { for ($i = 0, $i_max = mb_strlen($str[0]); $i < $i_max; ++$i) {
if ( if (
is_numeric(mb_substr($str[0], $i, 1)) is_numeric(mb_substr($str[0], $i, 1))
&& ( && (
!is_numeric(mb_substr($str[0], $i - 1, 1)) !is_numeric(mb_substr($str[0], $i - 1, 1))
&& mb_substr($str[0], $i - 1, 1) != ' ' && mb_substr($str[0], $i - 1, 1) !== ' '
&& ctype_alpha(mb_substr($str[0], $i - 1, 1)) === false && ctype_alpha(mb_substr($str[0], $i - 1, 1)) === false
) )
) { ) {
$str[0] = mb_substr($str[0], 0, $i) . ' ' . mb_substr($str[0], $i); $str[0] = mb_substr($str[0], 0, $i) . ' ' . mb_substr($str[0], $i);
} elseif ( } elseif (
$divide_en $divide_en
&& mb_substr($str[0], $i - 1, 1) !== ' '
&& ctype_alnum(mb_substr($str[0], $i, 1)) && ctype_alnum(mb_substr($str[0], $i, 1))
&& !ctype_alnum(mb_substr($str[0], $i - 1, 1)) && !ctype_alnum(mb_substr($str[0], $i - 1, 1))
&& mb_substr($str[0], $i - 1, 1) != ' '
) { ) {
$str[0] = mb_substr($str[0], 0, $i) . ' ' . mb_substr($str[0], $i); $str[0] = mb_substr($str[0], 0, $i) . ' ' . mb_substr($str[0], $i);
} }
} }
$str = implode($del, $str); $str = implode($del, $str);
// echo $str."\n";
$ls = []; $ls = [];
foreach (explode($del, $str) as $v) { foreach (explode($del, $str) as $v) {
if (trim($v) == '') { if (empty(trim($v))) {
continue; continue;
} }
$ls[] = $v; $ls[] = $v;
} }
// var_dump($ls); return $ls ?: [''];
return $ls == [] ? [''] : $ls;
} }
function matchArgs($pattern, $context) /**
* 匹配参数
*
* @return array|false 成功时返回匹配到的参数数组，失败时返回false
*/
function match_args(string $pattern, string $subject)
{ {
$result = []; $result = [];
if (matchPattern($pattern, $context)) { if (match_pattern($pattern, $subject)) {
if (mb_strpos($pattern, '*') === false) { if (mb_strpos($pattern, '*') === false) {
return []; return [];
} }
$exp = explode('*', $pattern); $exp = explode('*', $pattern);
$i = 0; $i = 0;
foreach ($exp as $k => $v) { foreach ($exp as $k => $v) {
// echo "[MATCH$k] " . $v . PHP_EOL; if (empty($v) && $k === 0) {
if ($v == '' && $k == 0) {
continue; continue;
} }
if ($v == '' && $k == count($exp) - 1) { if (empty($v) && $k === count($exp) - 1) {
$context = $context . '^EOL'; $subject .= '^EOL';
$v = '^EOL'; $v = '^EOL';
} }
$cur_var = ''; $cur_var = '';
// echo mb_substr($context, $i) . "|" . $v . PHP_EOL;
$ori = $i; $ori = $i;
while (($a = mb_substr($context, $i, mb_strlen($v))) != $v && $a != '') { while (($a = mb_substr($subject, $i, mb_strlen($v))) !== $v && !empty($a)) {
$cur_var .= mb_substr($context, $i, 1); $cur_var .= mb_substr($subject, $i, 1);
++$i; ++$i;
} }
if ($i != $ori || $k == 1 || $k == count($exp) - 1) { if ($i !== $ori || $k === 1 || $k === count($exp) - 1) {
// echo $cur_var . PHP_EOL;
$result[] = $cur_var; $result[] = $cur_var;
} }
$i += mb_strlen($v); $i += mb_strlen($v);
@@ -176,30 +183,27 @@ function matchArgs($pattern, $context)
return false; return false;
} }
function connectIsQQ(): bool /**
* 判断当前连接类型是否为传入的$type
*
* @param string $type 连接类型
* @throws ZMKnownException
*/
function current_connection_is(string $type): bool
{ {
return ctx()->getConnection()->getName() == 'qq'; return ctx()->getConnection()->getName() === $type;
} }
function connectIsDefault(): bool /**
{ * 获取触发当前方法的注解
return ctx()->getConnection()->getName() == 'default'; */
} function get_annotations(): array
function connectIs($type): bool
{
return ctx()->getConnection()->getName() == $type;
}
function getAnnotations(): array
{ {
$s = debug_backtrace()[1]; $s = debug_backtrace()[1];
// echo json_encode($s, 128|256);
$list = []; $list = [];
foreach (EventManager::$events as $v) { foreach (EventManager::$events as $v) {
foreach ($v as $vs) { foreach ($v as $vs) {
// echo get_class($vs).": ".$vs->class." => ".$vs->method.PHP_EOL; if ($vs->class === $s['class'] && $vs->method === $s['function']) {
if ($vs->class == $s['class'] && $vs->method == $s['function']) {
$list[get_class($vs)][] = $vs; $list[get_class($vs)][] = $vs;
} }
} }
@@ -207,16 +211,19 @@ function getAnnotations(): array
return $list; return $list;
} }
function set_coroutine_params($array) /**
* 设置协程参数
*/
function set_coroutine_params(array $params): void
{ {
$cid = Co::getCid(); $cid = Co::getCid();
if ($cid == -1) { if ($cid === -1) {
exit(zm_internal_errcode('E00061') . 'Cannot set coroutine params at none coroutine mode.'); exit(zm_internal_errcode('E00061') . 'Cannot set coroutine params at none coroutine mode.');
} }
if (isset(Context::$context[$cid])) { if (isset(Context::$context[$cid])) {
Context::$context[$cid] = array_merge(Context::$context[$cid], $array); Context::$context[$cid] = array_merge(Context::$context[$cid], $params);
} else { } else {
Context::$context[$cid] = $array; Context::$context[$cid] = $params;
} }
foreach (Context::$context as $c => $v) { foreach (Context::$context as $c => $v) {
if (!Co::exists($c)) { if (!Co::exists($c)) {
@@ -226,6 +233,8 @@ function set_coroutine_params($array)
} }
/** /**
* 获取当前上下文
*
* @throws ZMKnownException * @throws ZMKnownException
*/ */
function context(): ContextInterface function context(): ContextInterface
@@ -234,6 +243,8 @@ function context(): ContextInterface
} }
/** /**
* 获取当前上下文
*
* @throws ZMKnownException * @throws ZMKnownException
*/ */
function ctx(): ContextInterface function ctx(): ContextInterface
@@ -244,8 +255,8 @@ function ctx(): ContextInterface
return ZMBuf::$context_class[$cid] ?? (ZMBuf::$context_class[$cid] = new $c_class($cid)); return ZMBuf::$context_class[$cid] ?? (ZMBuf::$context_class[$cid] = new $c_class($cid));
} }
Console::debug("未找到当前协程的上下文({$cid})，正在找父进程的上下文"); Console::debug("未找到当前协程的上下文({$cid})，正在找父进程的上下文");
while (($pcid = Co::getPcid($cid)) !== -1) { while (($parent_cid = Co::getPcid($cid)) !== -1) {
$cid = $pcid; $cid = $parent_cid;
if (isset(Context::$context[$cid])) { if (isset(Context::$context[$cid])) {
return ZMBuf::$context_class[$cid] ?? (ZMBuf::$context_class[$cid] = new $c_class($cid)); return ZMBuf::$context_class[$cid] ?? (ZMBuf::$context_class[$cid] = new $c_class($cid));
} }
@@ -253,49 +264,120 @@ function ctx(): ContextInterface
throw new ZMKnownException(zm_internal_errcode('E00072') . 'Unable to find context environment'); throw new ZMKnownException(zm_internal_errcode('E00072') . 'Unable to find context environment');
} }
function onebot_target_id_name($message_type): string /**
* 根据消息类型获取对应的OneBot目标名称
*
* @return string 如传入的消息类型不被支持，将默认返回`user_id`
*/
function get_onebot_target_id_name(string $message_type): string
{ {
return $message_type == 'group' ? 'group_id' : 'user_id'; switch ($message_type) {
} case 'group':
return 'group_id';
function zm_sleep($s = 1): bool case 'discuss':
{ return 'discuss_id';
if (Coroutine::getCid() != -1) { case 'private':
System::sleep($s); default:
} else { return 'user_id';
usleep($s * 1000 * 1000);
} }
return true;
} }
function zm_exec($cmd): array /**
* 协程休眠
*
* 与 {@link sleep()} 一致，只是增加了协程支持
*
* @since 2.7.3 此函数不再返回 true
*/
function zm_sleep(int $seconds = 1): void
{ {
return System::exec($cmd); if (Coroutine::getCid() !== -1) {
System::sleep($seconds);
} else {
usleep($seconds * 1000 * 1000);
}
} }
function zm_cid() /**
* 协程执行命令
*
* 与 {@link exec()} 一致，只是增加了协程支持
*
* @return array{code: int, signal: int, output: string}
*/
function zm_exec(string $command): array
{
return System::exec($command);
}
/**
* 获取当前协程ID
*
* 与 {@link Co::getCid()} 一致
*/
function zm_cid(): int
{ {
return Co::getCid(); return Co::getCid();
} }
/**
* 挂起当前协程
*
* 与 {@link Co::yield()} 一致
*/
function zm_yield() function zm_yield()
{ {
Co::yield(); Co::yield();
} }
/**
* 恢复并继续执行指定协程
*
* 与 {@link Co::resume()} 一致
*/
function zm_resume(int $cid) function zm_resume(int $cid)
{ {
Co::resume($cid); Co::resume($cid);
} }
function zm_timer_after($ms, callable $callable) /**
* 指定延迟后执行函数
*
* @param int $delay 延迟时间，单位毫秒ms
*/
function run_later(callable $runnable, int $delay)
{ {
Swoole\Timer::after($ms, function () use ($callable) { Swoole\Timer::after($delay, static function () use ($runnable) {
call_with_catch($callable); call_with_catch($runnable);
}); });
} }
function call_with_catch($callable) /**
* 重复在指定时间间隔后执行函数
*
* @param int $interval 间隔时间，单位毫秒ms
* @return false|int 定时器ID，失败返回false
*/
function run_repeating(callable $runnable, int $interval)
{
if (zm_cid() === -1) {
return go(static function () use ($interval, $runnable) {
Console::debug('Adding extra timer tick of ' . $interval . ' ms');
Swoole\Timer::tick($interval, static function () use ($runnable) {
call_with_catch($runnable);
});
});
}
return Swoole\Timer::tick($interval, static function () use ($runnable) {
call_with_catch($runnable);
});
}
/**
* 执行函数并记录异常
*/
function call_with_catch(callable $callable): void
{ {
try { try {
$callable(); $callable();
@@ -310,32 +392,19 @@ function call_with_catch($callable)
} }
} }
function zm_timer_tick($ms, callable $callable) /**
* 生成消息的哈希值
*/
function hash_message(array $message): string
{ {
if (zm_cid() === -1) { return md5($message['user_id'] . '^' . $message['self_id'] . '^' . $message['message_type'] . '^' . ($message[$message['message_type'] . '_id'] ?? $message['user_id']));
return go(function () use ($ms, $callable) {
Console::debug('Adding extra timer tick of ' . $ms . ' ms');
Swoole\Timer::tick($ms, function () use ($callable) {
call_with_catch($callable);
});
});
} else {
return Swoole\Timer::tick($ms, function () use ($callable) {
call_with_catch($callable);
});
}
}
function zm_go(callable $callable)
{
call_with_catch($callable);
}
function zm_data_hash($v): string
{
return md5($v['user_id'] . '^' . $v['self_id'] . '^' . $v['message_type'] . '^' . ($v[$v['message_type'] . '_id'] ?? $v['user_id']));
} }
/**
* 获取 Swoole Server 实例
*
* 与 {@link Framework::$server} 一致
*/
function server(): ?Server function server(): ?Server
{ {
return Framework::$server; return Framework::$server;
@@ -343,6 +412,7 @@ function server(): ?Server
/** /**
* 获取缓存当前框架pid的临时目录 * 获取缓存当前框架pid的临时目录
* @internal
*/ */
function _zm_pid_dir(): string function _zm_pid_dir(): string
{ {
@@ -354,18 +424,21 @@ function _zm_pid_dir(): string
} }
/** /**
* 获取 ZMRobot 实例
*
* 随机返回一个 ZMRobot 实例，效果等同于 {@link ZMRobot::getRandom()}。
*
* 在单机器人模式下，会直接返回该机器人实例。
* @throws RobotNotFoundException * @throws RobotNotFoundException
* @throws ZMException
* @return OneBotV11
*/ */
function bot() function bot(): ZMRobot
{ {
if (($conn = LightCacheInside::get('connect', 'conn_fd')) == -2) { if (($conn = LightCacheInside::get('connect', 'conn_fd')) === -2) {
return OneBotV11::getRandom(); return OneBotV11::getRandom();
} }
if ($conn != -1) { if ($conn !== -1) {
if (($obj = ManagerGM::get($conn)) !== null) { if (($obj = ManagerGM::get($conn)) !== null) {
return new OneBotV11($obj); return new ZMRobot($obj);
} }
throw new RobotNotFoundException('单机器人连接模式可能连接了多个机器人！'); throw new RobotNotFoundException('单机器人连接模式可能连接了多个机器人！');
} }
@@ -373,10 +446,9 @@ function bot()
} }
/** /**
* 获取同类型所有连接的文件描述符 ID * 获取指定连接类型的文件描述符ID
* @author 854854321
*/ */
function getAllFdByConnectType(string $type = 'default'): array function get_all_fd_of_type(string $type = 'default'): array
{ {
$fds = []; $fds = [];
foreach (ManagerGM::getAllByName($type) as $obj) { foreach (ManagerGM::getAllByName($type) as $obj) {
@@ -385,12 +457,20 @@ function getAllFdByConnectType(string $type = 'default'): array
return $fds; return $fds;
} }
function zm_atomic($name): ?Atomic /**
* 获取原子计数器
*
* 与 {@link ZMAtomic::get()} 一致
*/
function zm_atomic(string $name): ?Atomic
{ {
return ZMAtomic::get($name); return ZMAtomic::get($name);
} }
function uuidgen($uppercase = false): string /**
* 生成 UUID
*/
function uuidgen(bool $uppercase = false): string
{ {
try { try {
$data = random_bytes(16); $data = random_bytes(16);
@@ -403,11 +483,24 @@ function uuidgen($uppercase = false): string
vsprintf('%s%s-%s-%s-%s-%s%s%s', str_split(bin2hex($data), 4)); vsprintf('%s%s-%s-%s-%s-%s%s%s', str_split(bin2hex($data), 4));
} }
function working_dir() /**
* 获取框架运行的工作目录
*
* @example 例如你是从 /root/framework-starter/ 目录启动的框架，vendor/bin/start server，那么 working_dir() 返回的就是 /root/framework-starter。
*/
function working_dir(): string
{ {
return WORKING_DIR; return WORKING_DIR;
} }
/**
* 更漂亮地输出变量值
*
* 可替代 {@link var_dump()}
*
* @param mixed $var
* @return array|mixed 返回传入的变量，传入多个变量则会返回数组
*/
function zm_dump($var, ...$moreVars) function zm_dump($var, ...$moreVars)
{ {
VarDumper::dump($var); VarDumper::dump($var);
@@ -416,56 +509,246 @@ function zm_dump($var, ...$moreVars)
VarDumper::dump($v); VarDumper::dump($v);
} }
if (1 < func_num_args()) { if (func_num_args() > 1) {
return func_get_args(); return func_get_args();
} }
return $var; return $var;
} }
function zm_info($obj) /**
* 输出info日志
*
* 与 {@link Console::info()} 一致
*
* @param $obj
*/
function zm_info($obj): void
{ {
Console::info($obj); Console::info($obj);
} }
function zm_warning($obj) /**
* 输出warning日志
*
* 与 {@link Console::warning()} 一致
*
* @param $obj
*/
function zm_warning($obj): void
{ {
Console::warning($obj); Console::warning($obj);
} }
function zm_success($obj) /**
* 输出success日志
*
* 与 {@link Console::success()} 一致
*
* @param $obj
*/
function zm_success($obj): void
{ {
Console::success($obj); Console::success($obj);
} }
function zm_debug($obj) /**
* 输出debug日志
*
* 与 {@link Console::debug()} 一致
*
* @param $obj
*/
function zm_debug($obj): void
{ {
Console::debug($obj); Console::debug($obj);
} }
function zm_verbose($obj) /**
* 输出verbose日志
*
* 与 {@link Console::verbose()} 一致
*
* @param $obj
*/
function zm_verbose($obj): void
{ {
Console::verbose($obj); Console::verbose($obj);
} }
function zm_error($obj) /**
* 输出error日志
*
* 与 {@link Console::error()} 一致
*
* @param $obj
*/
function zm_error($obj): void
{ {
Console::error($obj); Console::error($obj);
} }
function zm_config($name, $key = null) /**
* 获取配置项
*
* 与 {@link ZMConfig::get()} 一致
*
* @return mixed
*/
function zm_config(string $name, ?string $key = null)
{ {
return ZMConfig::get($name, $key); return ZMConfig::get($name, $key);
} }
function quick_reply_closure($reply) /**
* 生成快速回复闭包
*
* @param $reply
*/
function quick_reply_closure($reply): Closure
{ {
return function () use ($reply) { return static function () use ($reply) {
return $reply; return $reply;
}; };
} }
/**
* 获取内部错误码
*
* @param $code
*/
function zm_internal_errcode($code): string function zm_internal_errcode($code): string
{ {
return "[ErrCode:{$code}] "; return "[ErrCode:{$code}] ";
} }
/**
* 以下为废弃的函数，将于未来移除
*/
/**
* @deprecated 已废弃，请使用 {@link get_all_fd_of_type()}
*/
function getAllFdByConnectType(string $type = 'default'): array
{
return get_all_fd_of_type($type);
}
/**
* @param mixed $class_name
* @deprecated 已废弃，请使用 {@link get_class_path()}
*/
function getClassPath($class_name): ?string
{
return get_class_path($class_name);
}
/**
* @param mixed $msg
* @param mixed $ban_comma
* @deprecated 已废弃，请使用 {@link explode_msg()}，参数有变
*/
function explodeMsg($msg, $ban_comma = false): array
{
if ($ban_comma) {
return explode_msg($msg, [' ']);
}
return explode_msg($msg);
}
/**
* @deprecated 已废弃，请使用 {@link current_connection_is()}
*/
function connectIsQQ(): bool
{
return current_connection_is('qq');
}
/**
* @deprecated 已废弃，请使用 {@link current_connection_is()}
*/
function connectIsDefault(): bool
{
return current_connection_is('default');
}
/**
* @param mixed $type
* @deprecated 已废弃，请使用 {@link current_connection_is()}
*/
function connectIs($type): bool
{
return current_connection_is($type);
}
/**
* @deprecated 已废弃，请使用 {@link get_annotations()}
*/
function getAnnotations(): array
{
return get_annotations();
}
/**
* @param mixed $pattern
* @param mixed $context
* @deprecated 已废弃，请使用 {@link match_args()}
*/
function matchArgs($pattern, $context)
{
return match_args($pattern, $context);
}
/**
* @param mixed $pattern
* @param mixed $context
* @deprecated 已废弃，请使用 {@link match_pattern()}
*/
function matchPattern($pattern, $context): bool
{
return match_pattern($pattern, $context);
}
/**
* @param mixed $message_type
* @deprecated 已废弃，请使用 {@link get_onebot_target_id_name()}
*/
function onebot_target_id_name(string $message_type): string
{
return get_onebot_target_id_name($message_type);
}
/**
* @param mixed $ms
* @deprecated 已废弃，请使用 {@link run_repeating()}
*/
function zm_timer_tick($ms, callable $callable)
{
return run_repeating($callable, $ms);
}
/**
* @deprecated 已废弃，请直接使用 {@link call_with_catch()}
*/
function zm_go(callable $callable)
{
call_with_catch($callable);
}
/**
* @param mixed $v
* @deprecated 已废弃，请使用 {@link hash_message()}
*/
function zm_data_hash($v): string
{
return hash_message($v);
}
/**
* @deprecated 已废弃，请使用 {@link run_later()}
*/
function zm_timer_after(int $ms, callable $callable)
{
run_later($callable, $ms);
}