本文介绍如何在 Lara vel 中根据 HTTP 请求中任意数量和名称的查询参数，动态构建 Eloquent 查询条件，避免硬编码每个字段判断，提升 API 的灵活性与可维护性。

开发 RESTful API 时，常见需求之一就是支持多维度、可变数量的过滤条件。

例如：brand=1&color=red&type=5。

问题在于，这些字段名是什么、有多少个，往往在一开始并不能完全确定。

如果为每一个可能出现的参数都单独写一层 if 判断，比如 $request->get('brand')，代码很快就会变得冗长混乱，后续扩展和维护成本也会明显上升。

Lara vel 的动态查询方案

Lara vel 提供了简洁优雅的解决方式。

可以利用 $request->query() 获取全部 GET 参数，再通过循环动态追加 where 条件。

以下是推荐实现方式：

// 获取所有查询参数（仅 GET，不含 POST）
$filters = $request->query();

// 初始化基础查询（例如只查启用且属于指定分类的商品）
$products = Product::where('active', 1)
->where('category_id', $category_id);

// 动态追加 where 条件
foreach ($filters as $field => $value) {
// 跳过空值或 null 值（避免意外匹配 NULL 数据）
if ($value === null || $value === '' || !is_scalar($value)) {
continue;
}

// 注意：确保字段名安全（见下方安全建议）
$products->where($field, $value);
}

$products = $products->take(10)->get();

关键优势

• 自动适配任意新增查询参数。比如后续增加 warranty=24，无需修改 PHP 逻辑。
• 避免重复的 if 判断，显著减少样板代码。
• 保持 Eloquent 查询链式调用的流畅性。

重要注意事项

字段白名单校验（强烈推荐）

直接使用 $request->query() 的键名作为数据库字段名，存在 SQL 注入风险。

例如恶意传入 id[operator]=exists&id[value]=1，或字段名含点号/JSON路径。

生产环境务必限制可用字段：

$allowedFields = ['brand', 'color', 'type', 'calificacion_energetica', 'price_range'];
$filters = array_filter(
$request->only($allowedFields),
fn($v) => $v !== null && $v !== ''
);
foreach ($filters as $field => $value) {
$products->where($field, $value);
}

字段映射处理

如果请求参数名与数据库字段不一致，例如 calificacion-energetica → calificacion_energetica，可以在循环前先做映射：

$fieldMap = [
'calificacion-energetica' => 'calificacion_energetica',
'marca' => 'brand',
];
$filters = [];
foreach ($request->query() as $key => $val) {
$dbField = $fieldMap[$key]  $key;
if ($val !== null && isset($allowedFields[$dbField])) {
$filters[$dbField] = $val;
}
}

数值/范围/模糊查询扩展

如果需要支持 price_min、name_like 等复合条件，可以约定参数命名规则。

• 如 price[min]
• 如 name[like]

再结合 when() 或自定义解析逻辑，进一步增强查询能力。

总结

动态字段查询是构建高适应性 API 的核心技巧。

结合白名单校验与清晰的字段映射策略，既能享受 Lara vel ORM 的表达力，又能保障系统安全与长期可维护性。