PHP 获取客户端真实IP案例讲解（新手必看）

在PHP开发中，获取客户端真实IP几乎是绕不开的话题。不管是刚入门的新手，还是写了几年代码的老手，都难免在细节上栽跟头。这篇文章把获取客户端真实IP的知识点系统梳理一遍，并附上可以直接运行的示例。

第一步：认识获取客户端真实IP

给获取客户端真实IP相关的核心逻辑写单元测试，改动时才敢放手重构。

用获取客户端真实IP处理并发场景时要格外小心，确认它是否线程安全。

第二步：动手实现获取客户端真实IP

看代码更直观，获取客户端真实 IP：

<?php
function client_ip() {
    // 经过反向代理时，真实 IP 在 X-Forwarded-For 第一个值
    if (!empty($_SERVER['HTTP_X_FORWARDED_FOR'])) {
        $ips = explode(',', $_SERVER['HTTP_X_FORWARDED_FOR']);
        return trim($ips[0]);
    }
    return $_SERVER['REMOTE_ADDR'] ?? '0.0.0.0';
}
echo client_ip();

第三步：完善细节

1. 复杂问题拆成小问题逐个验证，比一次性调一大段效率高得多。
2. 权限不足导致的报错往往信息不明确，排查时别忘了检查文件和目录权限。
3. 时间相关的功能要考虑时区和夏令时，跨国项目尤其如此。
4. 遇到诡异问题试试最小化复现：把无关代码都删掉，问题往往立刻现形。

结语

希望读完本文后，获取客户端真实IP对你来说不再是一个模糊的概念。下次在代码里遇到它，你应该能会心一笑了。

遇见问题加 QQ23979811 协助处理