使用Haversine公式可计算两点间球面距离，PHP通过经纬度转弧度、应用公式并结合地球半径实现，支持km/m/mi/nm单位输出，适用于附近的人等场景，需注意输入验证与性能优化。
在PHP中计算两个地理位置之间的距离，常用的方法是使用Haversine公式。该公式基于地球的球面模型，通过两点的经纬度来计算它们之间的最短球面距离，适用于大多数地理距离计算场景，比如“附近的人”、“门店距离”等功能。
1. Haversine 公式原理
Haversine 公式用于计算地球上两点间的弧长，考虑了地球曲率。其数学表达如下：
a = sin²(Δφ/2) + cos φ₁ ⋅ cos φ₂ ⋅ sin²(Δλ/2)
c = 2 ⋅ atan2(√a, √(1−a))
d = R ⋅ c
其中：
立即学习“PHP免费学习笔记（深入）”；
- φ₁, φ₂：两点的纬度（以弧度为单位）
- Δφ：纬度之差
- Δλ：经度之差
- R：地球半径，平均约为 6371 公里
2. PHP 实现 Haversine 距离计算
以下是一个封装好的 PHP 函数，用于计算两个经纬度坐标之间的距离：
function calculateDistance($lat1, $lon1, $lat2, $lon2, $unit = 'km') {
$earthRadius = [
'km' => 6371,
'm' => 6371000,
'mi' => 3959, // 英里
'nm' => 3440 // 海里
];
// 转换为弧度
$lat1 = deg2rad($lat1);
$lon1 = deg2rad($lon1);
$lat2 = deg2rad($lat2);
$lon2 = deg2rad($lon2);
// 纬度和经度差
$deltaLat = $lat2 - $lat1;
$deltaLon = $lon2 - $lon1;
// Haversine 公式
$a = sin($deltaLat / 2) * sin($deltaLat / 2) +
cos($lat1) * cos($lat2) *
sin($deltaLon / 2) * sin($deltaLon / 2);
$c = 2 * atan2(sqrt($a), sqrt(1 - $a));
$distance = $earthRadius[$unit] * $c;
return $distance;}
3. 使用示例
假设你要计算北京（39.9042° N, 116.4074° E）到上海（31.2304° N, 121.4737° E）的距离：
$beijing = ['lat' => 39.9042, 'lng' => 116.4074]; $shanghai = ['lat' => 31.2304, 'lng' => 121.4737];$distance_km = calculateDistance( $beijing['lat'], $beijing['lng'], $shanghai['lat'], $shanghai['lng'], 'km' );
echo "距离: " . round($distance_km, 2) . " 公里"; // 输出：距离: 1068.35 公里
4. 单位转换说明
函数支持多种单位输出：
- km：公里（默认）
- m：米（适合近距离，如百米内）
- mi：英里（常用于美国系统）
- nm：海里（航海或航空领域）
根据业务需求选择合适的单位传入即可。
5. 注意事项与优化建议
实际开发中还需注意以下几点：
- 确保输入的经纬度是有效的浮点数，避免SQL注入或非法坐标
- 若需批量计算“附近N公里内的用户”，建议先用MySQL的ST_Distance_Sphere等空间函数做初步筛选，再用PHP精算
- 对性能要求高时可考虑使用Redis GEO 或 MySQL GIS 功能
- 该公式假设地球为完美球体，精度足够日常使用，但高精度场景需用Vincenty等更复杂算法
基本上就这些。Haversine 公式简单高效，配合 PHP 的三角函数支持，能快速实现地理距离计算功能。
