萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 敏感信息脫敏:用戶名、身份證、手機號、IP、銀行卡通用掩碼函數庫

核心需求

日誌記錄、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

合規要點 (個信法 / GDPR)

原則落地要求
最小化只脫敏必要字段,業務必要時可見全量 (內部權限控制)
不可逆脫敏為單向遮罩,**不可還原** (非加密)
一致性同一用戶同一字段多次脫敏結果一致 (如需關聯分析用一致性 Hash)
日誌分級DEBUG 級別可見脫敏,ERROR 級別嚴禁明文敏感信息
異構同步數據倉庫/離線分析庫同步脫敏規則,避免明文流出

前端配合:顯示與複製分離

<!-- Vue 組件示例 -->


總結

  • Masker 類提供開箱即用的 10+ 類型脫敏方法,覆蓋 95% 業務場景
  • 正則批量脫敏適用於日誌、導出、郵件等非結構化文本清洗
  • 核心原則:保留業務識別特徵 (前綴/後綴/BIN/區號),核心隱私位全遮罩
  • 架構層面:脫敏應在**數據輸出邊界**統一處理 (API 響應攔截器、日誌格式化器、導出轉換器),而非業務代碼散落調用
copyright © 萬盛學電腦網 all rights reserved