不可靠，不推荐。Guzzle 依赖外部服务可用性、DNS、网络及 TLS 证书，且返回的是出口公网 IP，非本机网卡 IP；正确方式应优先用 net_get_interfaces() 获取本地 IPv4，失败再 fallback 到可信外部 API 并严格校验响应。
用 Guzzle 获取本机公网 IP 是否可靠？
不稳定，不推荐。Guzzle 是 HTTP 客户端，它本身不“获取”本机 IP，只是发请求去第三方服务（如 https://api.ipify.org）查返回的 IP。这个过程依赖外部服务可用性、DNS 解析、网络连通性、TLS 证书有效性，任何一个环节失败都会导致获取失败。
更关键的是：它返回的是「出口公网 IP」，不是 PHP 所在机器的「本机网卡 IP」（如 192.168.1.100 或 127.0.0.1），二者语义完全不同。如果你要绑定监听、写日志来源、做内网校验，拿错 IP 会导致逻辑错误。
PHP 本机 IP 应该用 $_SERVER['SERVER_ADDR'] 还是 gethostbyname(gethostname())？
取决于你要什么：
-
$_SERVER['SERVER_ADDR']：Web 服务器（如 Nginx/Apache）监听的 IP，适用于 CGI/FPM 场景；但若 Nginx 反向代理了 PHP-FPM，且没配fastcgi_param SERVER_ADDR $server_addr，它可能返回127.0.0.1或空值 -
gethostbyname(gethostname())：查本机 hostname 对应的首个 IPv4 地址，简单但不可靠——/etc/hosts里如果把 hostname 映射到127.0.0.1，就永远拿不到真实网卡 IP - 真正稳妥的做法是遍历网卡：用
net_get_interfaces()（PHP 8.1+）或执行系统命令ip -4 addr show/ifconfig并解析输出
Guzzle 请求外部 IP 时常见的异常和处理方式
即使你明确只要公网 IP（比如用于调试或上报），用 Guzzle 也必须覆盖这些异常：
立即学习“PHP免费学习笔记（深入）”；
-
GuzzleHttp\Exception\ConnectException：DNS 失败、目标不可达、超时。需设timeout和connect_timeout，并 fallback 到备用地址（如换用https://icanhazip.com） -
GuzzleHttp\Exception\RequestException：HTTP 状态码非 2xx（如 503 服务不可用）。不能只靠try/catch，要检查$e->getResponse()->getStatusCode() - SSL 错误：
cURL error 60表示 CA 证书缺失。生产环境绝不能设verify => false，应确保系统 ca-certificates 包已更新，或指定正确路径如verify => '/etc/ssl/certs/ca-certificates.crt' - 空响应或非 IP 内容：第三方接口可能返回 HTML（维护页）、JSON（
{"ip":"x.x.x.x"}）、甚至带空格的字符串，务必 trim + 正则校验/^\d{1,3}(\.\d{1,3}){3}$/
一个带 fallback 的最小可行实现
以下代码优先尝试本地网卡，失败再查外部服务，且每个环节都加兜底：
// PHP 8.1+
function getLocalIp(): ?string
{
$interfaces = net_get_interfaces();
foreach ($interfaces as $name => $iface) {
if (isset($iface['ipv4']) && !str_starts_with($iface['ipv4'], '127.')) {
return $iface['ipv4'];
}
}
return null;
}
// fallback to external API
function getPublicIp(): string
{
$local = getLocalIp();
if ($local !== null) {
return $local;
}
$clients = [
new GuzzleHttp\Client(['timeout' => 3, 'verify' => true]),
new GuzzleHttp\Client(['timeout' => 3, 'verify' => true]),
];
$urls = ['https://api.ipify.org', 'https://icanhazip.com'];
foreach ($urls as $i => $url) {
try {
$res = $clients[$i]->get($url);
$ip = trim((string)$res->getBody());
if (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4)) {
return $ip;
}
} catch (Exception $e) {
continue;
}
}
return '0.0.0.0'; // 最终兜底，不抛异常
}
注意：net_get_interfaces() 在容器或某些精简 Linux 发行版中可能不可用；getPublicIp() 返回的是“当前出口 IP”，它可能因运营商 NAT、多线路切换而变化，不能用于长期身份标识。
