本文详解 PHP 中处理 GeoJSON（尤其是含多层嵌套坐标数组）时常见的 JSON 编码丢失问题，核心在于 MODX 模板解析器对双中括号 [[...]] 的误识别，并提供安全存储、可靠序列化及防解析干扰的完整解决方案。
本文详解 php 中处理 geojson（尤其是含多层嵌套坐标数组）时常见的 json 编码丢失问题，核心在于 modx 模板解析器对双中括号 `[[...]]` 的误识别，并提供安全存储、可靠序列化及防解析干扰的完整解决方案。
在 PHP 中处理 GeoJSON 数据时，若其 geometry 的 coordinates 字段包含深度嵌套的多维数组（如 MultiPolygon 的 [[[[-64.597,60.300],[...]], [...]],[[...]]]），直接使用 json_encode() 存储或输出可能意外丢失数据——但问题往往并非 JSON 函数本身，而是应用框架（如 MODX）的模板预处理器干扰了原始 JSON 字符串的完整性。
? 问题根源：MODX 的双中括号解析机制
MODX 使用 [[...]] 作为占位符语法（如 [[snippetName]] 或 [[*fieldname]]）。当 GeoJSON 坐标数组中出现连续的 [[（例如 [[[-64.597,60.300], [...]]]），MODX 会错误地将其识别为未闭合的模板标签，进而截断、忽略或静默丢弃后续内容，导致 json_encode() 输出时 coordinates 变为空字段（如 "coordinates":,）。
这一点可通过以下最小复现验证：
// 模拟被 MODX 处理前后的字符串
$rawJson = '{"coordinates":[[[[-64.597,60.300],[ -64.524,60.299]]]]}';
echo "原始 JSON: " . $rawJson . "\n";
// 若此字符串经 MODX 输出（如 via [[*feature]]），则 [[[[...]]]] 会被解析器破坏
✅ 正确解决方案：三重保障策略
1. 存储阶段：始终以 原始 JSON 字符串 形式保存（非 PHP 数组）
避免 json_decode($src, true) 后再 json_encode() 存库 —— 这会引入双重序列化风险且丧失精度。应直接存储原始 JSON 文本：
public function importGeodata()
{
$srcfile = file_get_contents('/path/to/us-states.json');
$jsondata = json_decode($srcfile, true);
foreach ($jsondata['features'] as $feature) {
if ($updateObj = $this->modx->getObject('CatalogStates', ['name' => $feature['properties']['NAME']])) {
// ⚠️ 关键：不调用 json_encode(array($feature))，而是保留原始 feature JSON 字符串
$featureJson = json_encode($feature, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
$updateObj->set('feature', $featureJson); // 直接存字符串
$updateObj->save();
}
}
}
2. 读取与输出阶段：禁用模板解析 + 显式 JSON 标志
在输出 GeoJSON 前，必须绕过 MODX 模板引擎，直接以纯文本响应发送，并设置正确 Content-Type：
public function getGeoJson()
{
$criteria = $this->modx->newQuery('CatalogStates');
$criteria->where(['id:IN' => [1, 2]]);
$states = $this->modx->getCollection('CatalogStates', $criteria);
$features = [];
foreach ($states as $state) {
// 安全反序列化：从数据库取出的是原始 JSON 字符串
$feature = json_decode($state->get('feature'), true);
if (json_last_error() === JSON_ERROR_NONE) {
$features[] = $feature;
}
}
// ⚠️ 关键：直接输出，不经过 MODX chunk/snippet 解析
header('Content-Type: application/json; charset=utf-8');
// 使用 JSON_PRETTY_PRINT 提升可读性（非必需），但更重要的是避免 [[ 被解析
echo json_encode(['type' => 'FeatureCollection', 'features' => $features],
JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_PRETTY_PRINT);
exit;
}
3. （可选）增强鲁棒性：对 coordinates 字段做 Base64 编码（极端场景）
若仍存在解析冲突（如自定义插件强制解析），可将敏感结构体单独编码：
// 存储时 $feature['geometry']['coordinates_b64'] = base64_encode(json_encode($feature['geometry']['coordinates'])); unset($feature['geometry']['coordinates']); // 读取时 $coords = json_decode(base64_decode($feature['geometry']['coordinates_b64']), true);
? 注意事项与最佳实践
- ✅ 永远不要在 MODX 输出上下文中直接 echo json_encode($array) —— 因为 $array 若含 [[ 结构，其字符串化结果仍会被解析器扫描。
- ✅ 使用 JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES 避免中文乱码和 URL 转义干扰。
- ✅ 数据库字段类型建议为 LONGTEXT 并设置 utf8mb4_unicode_ci 排序规则，确保完整支持 Unicode 坐标与属性名。
- ❌ 避免 json_decode(..., true) 后再 json_encode() 循环——浮点精度、NaN/Infinity 处理、对象/数组混用均可能引入偏差。
- ? 调试技巧：用 var_dump($state->get('feature')) 确认数据库中是否真存有完整 JSON 字符串；用 json_last_error_msg() 检查解码失败原因。
通过以上方法，即可彻底解决 GeoJSON 在 PHP + MODX 环境中因模板解析导致的坐标丢失问题，确保地理数据的完整性与可交换性。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
