如何将含嵌套属性的JS对象添加到URL，供PHP解析为关联数组？

前端：将嵌套筛选对象转为URL兼容的参数格式 #

要传递嵌套结构的参数，需遵循PHP/Symfony能自动解析的方括号命名规则（比如filters[categoryFilters][mainCategory]=val1），这种格式会被自动解析为嵌套关联数组。

实现递归转换函数 #

写一个工具函数，把嵌套JS对象转换成符合要求的键值对：

function buildNestedParams(obj, parentKey = '') {
  let params = [];
  for (const key in obj) {
    if (obj.hasOwnProperty(key)) {
      const currentKey = parentKey ? `${parentKey}[${key}]` : key;
      if (typeof obj[key] === 'object' && obj[key] !== null && !Array.isArray(obj[key])) {
        // 递归处理嵌套对象
        params = params.concat(buildNestedParams(obj[key], currentKey));
      } else if (Array.isArray(obj[key])) {
        // 处理数组（比如多选筛选）
        obj[key].forEach(item => {
          params.push([`${currentKey}[]`, item]);
        });
      } else {
        // 普通键值对
        params.push([currentKey, obj[key]]);
      }
    }
  }
  return params;
}

应用到你的筛选对象 #

用这个函数处理你的筛选对象，然后更新URL：

const filters = {
  categoryFilters: {
    mainCategory: 'val1',
    subCategory: 'val2'
  }
};

const url = new URL(window.location.href);
// 清空旧的筛选参数（可选，避免残留）
Array.from(url.searchParams.keys()).forEach(key => {
  if (key.startsWith('filters[')) {
    url.searchParams.delete(key);
  }
});

// 添加新的嵌套参数
const nestedParams = buildNestedParams(filters);
nestedParams.forEach(([key, value]) => {
  url.searchParams.set(key, value);
});

// 更新URL
window.history.replaceState(null, null, url);

执行后，URL会变成类似：?filters[categoryFilters][mainCategory]=val1&filters[categoryFilters][subCategory]=val2

后端：Symfony中获取嵌套筛选数组 #

在Symfony控制器里，直接通过Request对象的query属性就能拿到解析好的嵌套数组，无需额外处理：

use Symfony\Component\HttpFoundation\Request;

public function yourAction(Request $request)
{
    // 获取完整的筛选数组，结构和需求完全一致
    $filters = $request->query->get('filters', []);
    
    // 直接访问嵌套属性
    $mainCategory = $filters['categoryFilters']['mainCategory'] ?? null;
    $subCategory = $filters['categoryFilters']['subCategory'] ?? null;
    
    // 后续业务逻辑...
}

额外说明 #

• 如果有多选筛选（比如多个标签），前端数组会被转成filters[categoryFilters][tags][]=tag1&filters[categoryFilters][tags][]=tag2，后端拿到的$filters['categoryFilters']['tags']是包含所有选中标签的数组。
• 若需要保留旧的非筛选参数，清空时只删除以filters[开头的键即可，避免影响其他URL参数。

内容的提问来源于stack exchange，提问作者Szymon D.