依據 GDPR、個資法等法規,IP 位址屬於個人資料。在日誌、顯示、匯出資料時,應遮罩部分位址以降低識別風險,同時保留大致地理定位能力。
<?php
/**
* 遮罩 IPv4 位址最後一段
* 192.168.1.100 -> 192.168.1.*
* 10.0.0.1 -> 10.0.0.*
*/
function maskIpv4(string $ip): string
{
// 驗證合法 IPv4
if (!filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4)) {
return 'Invalid IP';
}
$parts = explode('.', $ip);
$parts[3] = '*';
return implode('.', $parts);
}
/** 更通用:遮罩最後 N 段 */
function maskIpv4Flexible(string $ip, int $maskOctets = 1): string
{
if (!filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4)) {
return 'Invalid IP';
}
$parts = explode('.', $ip);
$len = count($parts);
for ($i = 1; $i <= min($maskOctets, $len); $i++) {
$parts[$len - $i] = '*';
}
return implode('.', $parts);
}
// 測試
echo maskIpv4('192.168.1.100'); // 192.168.1.*
echo maskIpv4Flexible('10.20.30.40', 2); // 10.20.*.*
IPv6 位址 128 位元,常見遮罩前 64 位元(網路前綴)或最後 64 位元(介面識別碼)。
<?php
/**
* 遮罩 IPv6 位址:保留前綴長度,其餘遮罩為 0
* 2001:db8::1234:5678:9abc:def0 /64 -> 2001:db8::/64
*/
function maskIpv6(string $ip, int $prefixLength = 64): string
{
if (!filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6)) {
return 'Invalid IPv6';
}
// 使用 inet_pton 轉為二進位字串操作
$binary = inet_pton($ip);
if ($binary === false) return 'Invalid IPv6';
$bytes = strlen($binary); // 16 bytes
$fullBits = $bytes * 8; // 128 bits
if ($prefixLength < 0 || $prefixLength > $fullBits) {
$prefixLength = $fullBits;
}
// 遮罩後綴位元
for ($i = $prefixLength; $i < $fullBits; $i++) {
$byteIndex = $i >> 3;
$bitIndex = 7 - ($i & 7);
$binary[$byteIndex] = chr(ord($binary[$byteIndex]) & ~(1 << $bitIndex));
}
return inet_ntop($binary) . "/{$prefixLength}";
}
// 測試
echo maskIpv6('2001:0db8:85a3:0000:0000:8a2e:0370:7334'); // 2001:db8:85a3::/64
echo maskIpv6('::1', 128); // ::1/128 (不遮罩)
<?php
function maskIp(string $ip, int $ipv4MaskOctets = 1, int $ipv6Prefix = 64): string
{
if (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4)) {
return maskIpv4Flexible($ip, $ipv4MaskOctets);
}
if (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6)) {
return maskIpv6($ip, $ipv6Prefix);
}
return 'Invalid IP';
}
// 使用範例:記錄存取日誌
function logAccess(string $ip, string $url): void
{
$masked = maskIp($ip);
$line = date('c') . "\t{$masked}\t{$url}\n";
file_put_contents(__DIR__ . '/logs/access.log', $line, FILE_APPEND | LOCK_EX);
}
| 場景 | 建議遮罩程度 | 備註 |
|---|---|---|
| 公開評論區顯示 IP | IPv4 最後 1 段 / IPv6 /64 | 平衡防濫用與隱私 |
| 後台管理介面 | 完整 IP(限授權人員) | 需存取控制、稽核軌跡 |
| 資料分析/大數據 | IPv4 /24 (前三段) / IPv6 /48 | 保留地理統計精度 |
| 日誌長期保存 | 完整遮罩或雜湊 | 配合保存期限政策 |
| 錯誤回報/除錯資訊 | 遮罩後傳送 | 避免敏感資料外洩 |
IP 遮罩是隱私保護的基礎實務。PHP 內建 `filter_var`、`inet_pton/ntop` 提供可靠解析基礎,封裝成可複用函式庫,即可在專案中統一套用,滿足法規與安全需求。