本文介绍使用纯 php 函数（ipv4）和 symfony 组件（ipv6/兼容 ipv4）判断两个 cidr 表示的 ip 地址是否位于同一子网，包含可直接运行的代码、原理说明及注意事项。
本文介绍使用纯 php 函数（ipv4）和 symfony 组件（ipv6/兼容 ipv4）判断两个 cidr 表示的 ip 地址是否位于同一子网，包含可直接运行的代码、原理说明及注意事项。
在实际网络服务开发中，常需验证客户端 IP 是否归属指定子网（如内网白名单、区域路由策略等）。关键在于：不能仅比对 CIDR 前缀字符串（如 192.168.1.0/24 vs 192.168.10.0/24），而应计算各自网络地址并比较是否相等。
✅ IPv4 子网匹配（原生 PHP 实现）
以下函数 cidr_match($ip, $cidr) 接收一个 IP 地址（如 '192.168.1.10'）和一个 CIDR 字符串（如 '192.168.1.0/24'），返回布尔值表示该 IP 是否属于该子网：
function cidr_match($ip, $cidr) {
list($subnet, $mask) = explode('/', $cidr);
// 验证输入合法性（推荐补充）
if (!filter_var($ip, FILTER_VALIDATE_IP) || !filter_var($subnet, FILTER_VALIDATE_IP) || !is_numeric($mask) || $mask < 0 || $mask > 32) {
return false;
}
$ip_long = ip2long($ip);
$subnet_long = ip2long($subnet);
$mask_bits = 32 - (int)$mask;
// 构造子网掩码：如 /24 → 0xFFFFFF00
$netmask = $mask_bits === 0 ? 0xFFFFFFFF : ~((1 << $mask_bits) - 1);
return ($ip_long & $netmask) === ($subnet_long & $netmask);
}? 原理简析：
ip2long()将 IPv4 转为 32 位整数；&按位与操作提取网络部分；~((1 动态生成对应掩码（例如 <code>/24→0xFFFFFF00）。最终比较两个 IP 经掩码运算后的网络地址是否一致。
要判断两个 CIDR（如 '192.168.1.10/24' 和 '192.168.10.130/24'）是否同属一个网络，需先分别提取其网络地址：
立即学习“PHP免费学习笔记（深入）”；
function cidr_to_network($cidr) {
list($ip, $mask) = explode('/', $cidr);
$ip_long = ip2long($ip);
$mask_bits = 32 - (int)$mask;
$netmask = $mask_bits === 0 ? 0xFFFFFFFF : ~((1 << $mask_bits) - 1);
return long2ip($ip_long & $netmask);
}
// 示例：判断两个 CIDR 是否指向同一网络
$cidr1 = '192.168.1.10/24';
$cidr2 = '192.168.10.130/24';
if (cidr_to_network($cidr1) === cidr_to_network($cidr2)) {
echo "✅ 属于同一子网";
} else {
echo "❌ 不属于同一子网（注意：/24 下 192.168.1.x 与 192.168.10.x 网络地址不同）";
}⚠️ 重要提示：'192.168.1.10/24' 的网络地址是 192.168.1.0，而 '192.168.10.130/24' 的网络地址是 192.168.10.0 —— 二者不相同，因此不属于同一子网。原始问题中的例子实际结果为 false。
? IPv6 或混合环境：推荐使用 Symfony IpUtils
对于 IPv6 或需更高健壮性的场景，建议使用经过充分测试的组件。Symfony 的 HttpFoundation\IpUtils 支持 IPv4/IPv6 双栈及 CIDR、范围、通配符等多种格式：
composer require symfony/http-foundation
use Symfony\Component\HttpFoundation\IpUtils;
$cidr1 = '192.168.1.10/24';
$cidr2 = '192.168.10.130/24';
// 提取网络地址（需先解析 CIDR 的 subnet 部分）
list($net1, $mask1) = explode('/', $cidr1);
list($net2, $mask2) = explode('/', $cidr2);
// 判断 net1 是否属于 net2 所定义的网络（注意：checkIp 是「IP 是否在 CIDR 内」，非「两 CIDR 是否等价」）
if (IpUtils::checkIp($net1, $cidr2) && IpUtils::checkIp($net2, $cidr1)) {
echo "✅ 两 CIDR 网络完全重叠（即同一子网）";
} else {
echo "❌ 网络不重叠";
}?
IpUtils::checkIp($ip, $cidr)内部已自动处理 IPv4/IPv6、掩码边界、无效输入等，比手写更安全可靠。
✅ 总结与最佳实践
- 对纯 IPv4 且无 Composer 环境的轻量项目：使用优化后的
cidr_to_network()辅助函数，务必校验输入合法性（避免ip2long(false)返回-1导致误判）； - 对生产环境、含 IPv6 需求或追求稳定性的项目：优先选用
symfony/http-foundation的IpUtils； - 切勿直接字符串比较 CIDR，必须通过网络地址归一化后比对；
- 注意
/32（单 IP）、/0（全网）等边界情况，上述代码均已兼容。
通过合理选择工具与严谨实现，即可准确、高效地完成子网归属判定任务。
