本文详解如何在 php 中准确计算两个罗盘航向（0°–360°）之间的最小夹角，解决跨 0°/360° 边界时出现的“331°误判”问题，并提供可直接复用的健壮函数与完整示例。
本文详解如何在 php 中准确计算两个罗盘航向（0°–360°）之间的最小夹角，解决跨 0°/360° 边界时出现的“331°误判”问题，并提供可直接复用的健壮函数与完整示例。
在航空模拟、风向匹配跑道推荐等场景中，需频繁比较风向（如 360°）与跑道磁航向（如 029°）的夹角。直观相减（029 − 360 = −331）再取绝对值会得到错误的 331°，而实际最短夹角应为 29°——因为罗盘是环形空间（360° 闭环），两点间存在顺时针与逆时针两条路径，必须取二者中的最小绝对角度差。
核心原理是：对于任意两个角度 a 和 b（均归一化至 [0, 360) 区间），其最小夹角为
min(|a − b|, 360 − |a − b|)。
但仅返回绝对值不够——在跑道优选逻辑中，我们通常只需偏差大小（用于排序），而非旋转方向；因此最终函数应返回非负整数，且严格满足 0 ≤ result ≤ 180。
以下是经过验证、鲁棒性强的 PHP 实现：
/**
* 计算两个罗盘航向之间的最小夹角（0°–180°）
* @param float|int $heading1 第一个航向（0–360，支持小数）
* @param float|int $heading2 第二个航向（0–360，支持小数）
* @return int 最小夹角（度），范围 [0, 180]
*/
function compassAngleDiff(float $heading1, float $heading2): int
{
// 归一化到 [0, 360) 区间，容错处理越界输入
$h1 = fmod($heading1, 360.0);
if ($h1 < 0) $h1 += 360.0;
$h2 = fmod($heading2, 360.0);
if ($h2 < 0) $h2 += 360.0;
$absDiff = abs($h1 - $h2);
return (int)round(min($absDiff, 360.0 - $absDiff));
}
// ✅ 正确性验证示例
var_dump(compassAngleDiff(29, 360)); // int(29) ← 关键修复点
var_dump(compassAngleDiff(5, 355)); // int(10)
var_dump(compassAngleDiff(180, 0)); // int(180)
var_dump(compassAngleDiff(90, 270)); // int(180)
var_dump(compassAngleDiff(10, 10)); // int(0)将该函数集成进原始跑道推荐逻辑中，仅需替换原 $diff 计算部分：
// ...（原有 $rwy_hdgs 和 $wind_dir 定义保持不变）
$runways = [];
$i = 1;
foreach ($rwy_hdgs as $key => $value) {
$rwyHdg = (int)$value; // 转为整型（如 "029" → 29）
$windHdg = (int)$wind_dir; // 同理
$variance = compassAngleDiff($rwyHdg, $windHdg); // ✅ 使用新函数
$runways[$i] = [
'rwy' => $key,
'hdg' => $value,
'diff' => $variance
];
$i++;
}
// 按最小风向偏差升序排列（最优跑道在前）
usort($runways, function($a, $b) {
return $a['diff'] <=> $b['diff'];
});
// 输出结果（格式优化）
echo "✅ 推荐跑道（按风向匹配度升序）：\n";
foreach ($runways as $runway) {
printf("Runway %s (%s°) → 风向偏差：%d°\n",
$runway['rwy'], $runway['hdg'], $runway['diff']);
}关键注意事项：
立即学习“PHP免费学习笔记（深入）”；
- 务必归一化输入：使用 fmod() 处理可能的负角度或超 360° 输入（如 720° 或 −45°），避免逻辑崩溃；
- 避免整型截断陷阱："029" 直接 (int) 转换为 29 是安全的，但若数据含小数（如 "209.5"），应改用 (float) 并保留 compassAngleDiff 的浮点运算能力；
- 排序优先用 usort：相比 array_multisort + array_column 组合，usort 更直观、内存更优，且天然支持关联数组结构；
- 边界值语义明确：180° 表示正对反方向（完全逆风），0° 表示完全顺风——这与航空运行逻辑一致。
通过这一修正，您的飞行模拟工具即可精准识别 360° 风向下 029° 跑道仅偏差 29°，从而在排序结果中将其置于首位，真正实现“最小风差优先”的专业级推荐逻辑。
