WordPress中仅调用一次ip.php后在多主题文件输出访客地域变量

步骤1：将IP检测与GeoIP逻辑封装为可复用函数 #

打开你的WordPress主题functions.php文件，把以下代码添加进去——这会把原ip.php的逻辑封装成带缓存的函数，确保只执行一次GeoIP查询：

function get_visitor_country() {
    // 用static变量缓存查询结果，避免重复执行IP检测与数据库读取
    static $country = null;
    if ($country !== null) {
        return $country;
    }

    // 获取访客真实IP的内部函数
    function getUserIP() {
        if (isset($_SERVER["HTTP_CF_CONNECTING_IP"])) {
            $_SERVER['REMOTE_ADDR'] = $_SERVER["HTTP_CF_CONNECTING_IP"];
            $_SERVER['HTTP_CLIENT_IP'] = $_SERVER["HTTP_CF_CONNECTING_IP"];
        }
        $client  = @$_SERVER['HTTP_CLIENT_IP'];
        $forward = @$_SERVER['HTTP_X_FORWARDED_FOR'];
        $remote  = $_SERVER['REMOTE_ADDR'];

        if(filter_var($client, FILTER_VALIDATE_IP)) {
            $ip = $client;
        } elseif(filter_var($forward, FILTER_VALIDATE_IP)) {
            $ip = $forward;
        } else {
            $ip = $remote;
        }
        return $ip;
    }

    $user_ip = getUserIP();
    
    // 引入GeoIP2依赖文件
    require_once ABSPATH . '/nocache-ip/vendor/autoload.php';
    use GeoIp2\Database\Reader;

    try {
        // 读取GeoIP数据库并获取国家信息
        $cityDbReader = new Reader('/html/nocache-ip/GeoLite2-City.mmdb');
        $record = $cityDbReader->city($user_ip);
        $country = $record->country->name;
    } catch (\Exception $e) {
        // 处理查询失败的情况（如数据库路径错误、IP无法识别）
        $country = 'Unknown';
    }

    return $country;
}

步骤2：在主题任意文件中调用函数 #

现在你不需要再单独引入ip.php，直接在header.php、footer.php或其他主题文件里调用函数即可：

• 在header.php中输出：

echo "You came from " . get_visitor_country();

• 在footer.php中输出：

echo "Your country: " . get_visitor_country();

关键细节说明 #

• 缓存机制：函数内的static $country变量会在第一次调用后保留查询结果，后续调用直接返回缓存值，避免重复消耗服务器资源。
• 异常处理：try...catch块能防止GeoIP查询失败导致网站崩溃，失败时会返回Unknown作为兜底值。
• 路径修正：用ABSPATH拼接依赖文件路径，避免相对路径引发的找不到文件问题。

清理旧代码 #

记得删除header.php里原来的require_once( ABSPATH . '/nocache-ip/ip.php' );语句，现在所有逻辑都已整合到functions.php的函数中。

内容的提问来源于stack exchange，提问作者Johnny Bravo