<?php
function getClientIp(): string
{
$headers = [
'HTTP_CF_CONNECTING_IP', // Cloudflare
'HTTP_CLIENT_IP', // 標準代理
'HTTP_X_FORWARDED_FOR', // 常見代理鏈 (可能包含多個 IP,取第一個)
'HTTP_X_REAL_IP', // Nginx proxy_set_header
'REMOTE_ADDR', // 直接連線
];
foreach ($headers as $header) {
$value = $_SERVER[$header] ?? '';
if ($value) {
// X-Forwarded-For 可能為 "client, proxy1, proxy2"
$ips = array_map('trim', explode(',', $value));
foreach ($ips as $ip) {
if (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_NO_PRIV_RANGE | FILTER_FLAG_NO_RES_RANGE)) {
return $ip;
}
}
}
}
return 'unknown';
}
?>
REMOTE_ADDR。FILTER_FLAG_NO_PRIV_RANGE | FILTER_FLAG_NO_RES_RANGE 排除 10.x、192.168.x、127.x 等內網 IP。filter_var 自動支援 IPv6 格式驗證。# Nginx
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
# Apache (mod_remoteip)
RemoteIPHeader X-Forwarded-For
RemoteIPInternalProxy 10.0.0.0/8 192.168.0.0/16
若伺服器前無可信代理/CDN,直接使用
$_SERVER['REMOTE_ADDR'],否則攻擊者可偽造X-Forwarded-For繞過 IP 限制。
VARBINARY(16) 存儲 inet_pton() 二進位,或 VARCHAR(45) 存字串(支援 IPv6)。