\App\Http\HelpersIpRegion

find()

find(string  $ip) : string

查询 IP 归属地（进程级结果缓存）。

流程：① 命中缓存直接返回（含空串结果——无效 IP/库缺失也缓存，防重复 fopen） ② 未命中走解析并写入缓存。 缓存键绑定库文件路径：换库/库缺失场景自动失效（防旧库结果残留）。

Parameters

Returns

findUncached()

findUncached(string  $ip) : string

查询 IP 归属地（无缓存路径）。

流程：① 校验库文件与 IP 格式 ② 索引头二分定位 IP 段 ③ 按模式解析国家/地区 ④ 清洗广告后缀并转 UTF-8

Parameters

Returns

resolveLocation()

resolveLocation(mixed  $handle, int  $recordOffset) : string

解析命中记录的国家 + 地区（0x01 双偏移重定向 / 0x02 国家后跟地区）

Parameters

Returns

areaAt()

areaAt(mixed  $handle, int  $offset) : string

地区段解析：重定向模式（0x01/0x02）经 3 字节偏移跳转，否则就地读串

Parameters

Returns

bytes()

bytes(mixed  $handle, int  $offset, int  $length) : string

指定偏移读取定长字节（失败返回空串）

Parameters

Returns

uint32()

uint32(mixed  $handle, int  $offset) : int

小端 32 位无符号整数

Parameters

Returns

uint24()

uint24(mixed  $handle, int  $offset) : int

小端 24 位无符号整数（索引记录尾 3 字节）

Parameters

Returns

byte()

byte(mixed  $handle, int  $offset) : int

单字节无符号整数

Parameters

Returns

stringAt()

stringAt(mixed  $handle, int  $offset) : string

自偏移读 NUL 结尾字符串（上限 255 字节防坏数据越读）

Parameters

Returns