应使用 yii2 内置 ipvalidator 或 php 原生 filter_var($ip, filter_validate_ip, filter_flag_ipv6) 进行 ipv6 格式校验；前者支持压缩格式、大小写、前导零及区域标识符，后者底层调用 inet_pton()，可准确识别带作用域地址。
在 Yii2 应用中验证用户提交的 IPv6 地址，需兼顾格式合法性与 RFC 合规性，不能仅靠字符串特征粗略判断；直接使用正则表达式易漏判压缩格式（如 ::1）或嵌入 IPv4 的混合地址（如 ::ffff:192.0.2.1），必须依赖语言层真实解析能力。
使用 yii\validators\IpValidator（推荐）
Yii2 内置的 IpValidator 已完整支持 IPv6，自动处理 :: 压缩、大小写、前导零、区域标识符（如 %eth0）等 RFC 4291 规范细节。
在模型规则中直接声明：['ip_field', 'ip', 'ipv6' => true, 'ipv4' => false]。
若需同时允许 IPv4 和 IPv6，设为 'ipv4' => true, 'ipv6' => true；此时验证器会先尝试 IPv4 解析，失败再试 IPv6，内部调用的是 PHP 的 filter_var($value, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6)，具备生产级可靠性。
【注意：FILTER_FLAG_IPV6 在 PHP 8.1+ 中已废弃，但 Yii2 3.x 及以上版本已自动降级兼容，无需手动干预】
在控制器中手动验证
获取请求参数后，调用 PHP 原生函数进行即时校验：
$ip = Yii::$app->request->get('ip');
if (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6) === false) { throw new BadRequestHttpException('IPv6 地址格式不合法');
该函数底层使用系统级 inet_pton()，能准确识别 fe80::1%lo0 这类带作用域的地址，而纯正则无法安全处理百分号后内容。
不要用 FILTER_FLAG_NO_PRIV_RANGE 或 FILTER_FLAG_NO_RES_RANGE 等附加标志——它们只过滤地址语义（如私有网段），不参与格式校验，且对 IPv6 支持不一致。
自定义验证方法（需精确控制逻辑时）
方法一：委托给 Python 或系统命令（不推荐，增加依赖和延迟）
方法二：调用 inet_pton() 手动捕获异常
if (@inet_pton($ip) === false) { return false; }
此方式绕过 filter_var 的封装，更底层，但需注意 @ 抑制警告是必要操作，否则非法输入会触发 PHP Warning 并可能中断流程。
方法三：使用 ipaddress 类（需额外安装 symfony/polyfill-intl-idn 或启用 PHP 的 sockets 扩展）
Yii2 本身不提供 IP 对象抽象，但可引入 symfony/ip-address 包，其 Ipv6Address::fromString() 方法返回强类型对象，支持后续段提取、掩码计算等高级操作。
