本文介绍使用纯 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 32) {
return false;
}
$ip_long = ip2long($ip);
$subnet_long = ip2long($subnet);
$mask_bits = 32 - (int)$mask;
// 构造子网掩码：如 /24 → 0xFFFFFF00
$netmask = $mask_bits === 0 ? 0xFFFFFFFF : ~((1 <blockquote><p>? <strong>原理简析</strong>：<code>ip2long()</code> 将 IPv4 转为 32 位整数；<code>&</code> 按位与操作提取网络部分；<code>~((1 动态生成对应掩码（例如 <code>/24</code> → <code>0xFFFFFF00</code>）。最终比较两个 IP 经掩码运算后的网络地址是否一致。</code></p></blockquote><p>要判断两个 CIDR（如 <code>'192.168.1.10/24'</code> 和 <code>'192.168.10.130/24'</code>）是否同属一个网络，需先分别提取其网络地址：</p><pre class="brush:php;toolbar:false;">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 <p>⚠️ <strong>重要提示</strong>：<code>'192.168.1.10/24'</code> 的网络地址是 <code>192.168.1.0</code>，而 <code>'192.168.10.130/24'</code> 的网络地址是 <code>192.168.10.0</code> —— 二者<strong>不相同</strong>，因此不属于同一子网。原始问题中的例子实际结果为 <code>false</code>。</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill5233" title="btpanel phpsite 宝塔面板PHP网站"><img
src="https://img.php.cn/upload/skill/000/000/081/179040786932301.jpg" alt="btpanel phpsite 宝塔面板PHP网站" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill5233" title="btpanel phpsite 宝塔面板PHP网站" class="overflowclass">btpanel phpsite 宝塔面板PHP网站</a>
<p class="overflowclass">宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理</p>
</div>
<a rel="nofollow" href="/xiazai/skill5233" title="btpanel phpsite 宝塔面板PHP网站" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div><h3>? IPv6 或混合环境：推荐使用 Symfony IpUtils</h3><p>对于 IPv6 或需更高健壮性的场景，建议使用经过充分测试的组件。Symfony 的 <code>HttpFoundation\IpUtils</code> 支持 IPv4/IPv6 双栈及 CIDR、范围、通配符等多种格式：</p><pre class="brush:php;toolbar:false;">composer require symfony/http-foundationuse 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（全网）等边界情况，上述代码均已兼容。
通过合理选择工具与严谨实现，即可准确、高效地完成子网归属判定任务。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
