php 8.6为spoofchecker增加了带文字方向的混淆检查。需要比较双向文字用户名与保留名称时,可按界面的ltr或rtl方向调用arebidiconfusable(),并用getbidiskeleton()生成同方向的比较骨架。这两项能力要求intl使用icu 74或更高版本;检测结果只用于名称审核,不能替代账号id、权限校验或数据库唯一约束。

官方说明分别列出方向感知检查和骨架生成方法,浏览器翻译视图。
先确定名称显示方向
下面假设管理后台的名称按从左到右显示,因此选择LTR。若产品使用RTL界面,必须按真实显示规则选择RTL;不能只看输入文字属于哪种语言就随意切换方向。保留名称来自服务端审核清单,不由请求方提供。
<?php
if (PHP_VERSION_ID < 80600 || !extension_loaded('intl')
|| !defined('INTL_ICU_VERSION') || version_compare(INTL_ICU_VERSION, '74', '<')
|| !method_exists('SpoofChecker', 'areBidiConfusable')) {
throw new RuntimeException('需要PHP 8.6及intl/ICU 74+');
}
$candidate = $argv[1] ?? '';
if ($candidate === '' || strlen($candidate) > 256
|| preg_match('//u', $candidate) !== 1) {
throw new InvalidArgumentException('请输入不超过256字节的UTF-8用户名');
}
$checker = new SpoofChecker();
$direction = SpoofChecker::LTR;
$review = false;
foreach (['admin', 'support'] as $reserved) {
$details = 0;
if ($checker->areBidiConfusable($direction, $candidate, $reserved, $details)) {
$review = true;
break;
}
}
$skeleton = $checker->getBidiSkeleton($direction, $candidate);
if ($skeleton === false) {
throw new RuntimeException('生成混淆比较骨架失败');
}
echo json_encode([
'needs_name_review' => $review,
'bidi_skeleton' => $skeleton,
], JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR), PHP_EOL;运行并检查输入边界
保存为check-name.php,用php check-name.php admin运行,再用自己的合法多语言样本、空输入和无效UTF-8测试。示例中的256是业务字节上限,不是字符数。areBidiConfusable的第四个参数用于接收检查信息,不能仅凭变量名把它当作数据库错误码;API异常应进入服务端错误处理,不按“无混淆”放行。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。

方向参数位于字符串之前,getSkeleton与getBidiSkeleton是不同接口。
把检测接入名称审核
真实注册流程还要处理标准化、允许字符、保留词和业务长度规则。若持久化骨架用于检索,需记录ICU版本并设计升级重算流程,因为不同Unicode数据版本可能改变结果。视觉相近与账号相同属于不同判断,不用骨架替换用户主键,也不宣称一次检查可以阻止全部仿冒。


















