日誌記錄、API 返回、前端展示、數據導出等場景需**隱藏敏感信息核心位**,兼顧可讀性與隱私合規 (GDPR、個信法)。
<?php
/**
* 敏感信息脫敏工具類
* 靜態方法、無狀態、可直接調用
*/
class Masker
{
/** 通用:保留首尾 N 位,中間用字符替換 */
public static function mask(string $str, int $prefixLen = 3, int $suffixLen = 3, string $maskChar = '*'): string
{
$len = mb_strlen($str, 'UTF-8');
if ($len <= $prefixLen + $suffixLen) {
return str_repeat($maskChar, $len); // 過短全遮罩
}
$prefix = mb_substr($str, 0, $prefixLen, 'UTF-8');
$suffix = mb_substr($str, -$suffixLen, null, 'UTF-8');
$middleLen = $len - $prefixLen - $suffixLen;
return $prefix . str_repeat($maskChar, $middleLen) . $suffix;
}
/** 用戶名/昵稱:首尾各保留 1 位 */
public static function username(string $name): string
{
return self::mask($name, 1, 1);
}
/** 身份證號:18 位保留前 6 (地址碼) 後 4 (校驗碼),15 位保留前 6 後 3 */
public static function idCard(string $id): string
{
$len = strlen($id);
if ($len === 18) {
return substr($id, 0, 6) . '********' . substr($id, -4);
}
if ($len === 15) {
return substr($id, 0, 6) . '******' . substr($id, -3);
}
return str_repeat('*', $len); // 非標準長度全遮罩
}
/** 手機號:保留前 3 後 4 (標準 11 位) */
public static function mobile(string $mobile): string
{
// 兼容 +86、空格、連字符
$clean = preg_replace('/\D/', '', $mobile);
if (strlen($clean) === 11 && $clean[0] === '1') {
return substr($clean, 0, 3) . '****' . substr($clean, -4);
}
return self::mask($clean, 3, 4);
}
/** 固話/400:保留區號 + 後 4 位 */
public static function phone(string $phone): string
{
$clean = preg_replace('/\D/', '', $phone);
// 010-12345678 / 400-888-8888
if (preg_match('/^0\d{2,3}(\d{7,8})$/', $clean, $m)) {
$area = substr($clean, 0, 3 + ($clean[3] !== '0' ? 1 : 0)); // 區號 3/4 位
return $area . '****' . substr($m[1], -4);
}
return self::mask($clean, 3, 4);
}
/** IPv4:最後一段遮罩 (192.168.1.XXX) */
public static function ipv4(string $ip): string
{
if (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4)) {
$parts = explode('.', $ip);
$parts[3] = 'xxx';
return implode('.', $parts);
}
return 'xxx.xxx.xxx.xxx';
}
/** IPv6:後 64 位遮罩 */
public static function ipv6(string $ip): string
{
if (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6)) {
// 簡化:壓縮後保留前 4 段
$parts = explode(':', $ip);
if (count($parts) >= 4) {
return implode(':', array_slice($parts, 0, 4)) . ':xxxx:xxxx:xxxx:xxxx';
}
}
return 'xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx';
}
/** 銀行卡:保留前 6 (BIN) 後 4 */
public static function bankCard(string $card): string
{
$clean = preg_replace('/\D/', '', $card);
$len = strlen($clean);
if ($len >= 10) {
return substr($clean, 0, 6) . str_repeat('*', $len - 10) . substr($clean, -4);
}
return str_repeat('*', $len);
}
/** Email:用戶名首字符 + ***** + @域名 */
public static function email(string $email): string
{
if (strpos($email, '@') !== false) {
[$local, $domain] = explode('@', $email, 2);
$maskedLocal = $local[0] . str_repeat('*', max(1, strlen($local) - 1));
return $maskedLocal . '@' . $domain;
}
return self::mask($email, 1, 0);
}
/** 車牌號:保留首位 (省份) 末位 */
public static function licensePlate(string $plate): string
{
$len = mb_strlen($plate, 'UTF-8');
if ($len >= 2) {
return mb_substr($plate, 0, 1, 'UTF-8') . str_repeat('*', $len - 2) . mb_substr($plate, -1, 1, 'UTF-8');
}
return str_repeat('*', $len);
}
/** 地址:保留省市區,街道門牌遮罩 */
public static function address(string $addr): string
{
// 簡單規則:保留前 8-12 字符 (通常含省市區)
$len = mb_strlen($addr, 'UTF-8');
$keep = min(12, max(6, (int)($len * 0.4)));
return mb_substr($addr, 0, $keep, 'UTF-8') . str_repeat('*', $len - $keep);
}
}
$testData = [
'username' => '張三豐',
'id_card' => '110101199003071234',
'mobile' => '13800138000',
'phone' => '010-88886666',
'ipv4' => '192.168.1.105',
'ipv6' => '2001:0db8:85a3:0000:0000:8a2e:0370:7334',
'bank_card' => '6225880123456789',
'email' => 'zhangsan@example.com',
'license_plate' => '京A12345',
'address' => '北京市朝陽區建國路88號SOHO現代城A座1001室',
];
foreach ($testData as $type => $value) {
$method = $type;
$masked = Masker::$method($value);
echo "[$type] $value -> $masked\n";
}
/* 輸出:
[username] 張三豐 -> 張*豐
[id_card] 110101199003071234 -> 110101********1234
[mobile] 13800138000 -> 138****8000
[phone] 010-88886666 -> 010****6666
[ipv4] 192.168.1.105 -> 192.168.1.xxx
[ipv6] 2001:0db8:85a3:0000:0000:8a2e:0370:7334 -> 2001:0db8:85a3:0000:xxxx:xxxx:xxxx:xxxx
[bank_card] 6225880123456789 -> 622588******6789
[email] zhangsan@example.com -> z*******@example.com
[license_plate] 京A12345 -> 京***45
[address] 北京市朝陽區建國路88號SOHO現代城A座1001室 -> 北京市朝陽區建國路*******
*/
/**
* 文本全量脫敏:正則匹配替換
* 適用:日誌文件、導出報表、郵件內容清洗
*/
function maskAllSensitive(string $text): string
{
$patterns = [
// 身份證 18/15 位
'/\b\d{17}[\dXx]\b/' => fn($m) => substr($m[0], 0, 6) . '********' . substr($m[0], -4),
'/\b\d{15}\b/' => fn($m) => substr($m[0], 0, 6) . '******' . substr($m[0], -3),
// 手機號 (含 +86、空格、連字符)
'/(? fn($m) => Masker::mobile($m[0]),
// 銀行卡 10-19 位
'/\b\d{10,19}\b/' => fn($m) => Masker::bankCard($m[0]),
// Email
'/\b[\w.+-]+@[\w-]+\.[\w.-]+\b/' => fn($m) => Masker::email($m[0]),
// IPv4
'/\b(?:\d{1,3}\.){3}\d{1,3}\b/' => fn($m) => Masker::ipv4($m[0]),
];
foreach ($patterns as $pattern => $replacer) {
$text = preg_replace_callback($pattern, $replacer, $text);
}
return $text;
}
// 測試
$log = "用戶張三(身份證:110101199003071234,手機:13800138000)登錄自 192.168.1.105";
echo maskAllSensitive($log);
// 用戶張*(身份證:110101********1234,手機:138****8000)登錄自 192.168.1.xxx
| 原則 | 落地要求 |
|---|---|
| 最小化 | 只脫敏必要字段,業務必要時可見全量 (內部權限控制) |
| 不可逆 | 脫敏為單向遮罩,**不可還原** (非加密) |
| 一致性 | 同一用戶同一字段多次脫敏結果一致 (如需關聯分析用一致性 Hash) |
| 日誌分級 | DEBUG 級別可見脫敏,ERROR 級別嚴禁明文敏感信息 |
| 異構同步 | 數據倉庫/離線分析庫同步脫敏規則,避免明文流出 |
<!-- Vue 組件示例 -->
{{ maskedValue }}