<?php
/**
 * 系统IP地址获取
 * Date: 2026-07-18
 * Author: 小新
 * SystemName: XiaoPHP
 */

namespace XiaoPHP\System;

class Ipaddr
{
    public static function get(): ?string
    {
        if (!empty($_SERVER['HTTP_X_FORWARDED_FOR'])) {
            $ips = explode(',', $_SERVER['HTTP_X_FORWARDED_FOR']);
            return trim($ips[0]);
        }
        if (!empty($_SERVER['HTTP_CLIENT_IP'])) {
            return $_SERVER['HTTP_CLIENT_IP'];
        }
        // 修复：无代理头时返回 null（与 ?string 类型声明一致），避免 'unknown' 字符串污染日志/数据
        return $_SERVER['REMOTE_ADDR'] ?? null;
    }
}