在Yii2项目开发中，经常需要根据前端传递的产品、月份、年份等参数筛选数据，核心逻辑是在控制器中接收参数并组装查询条件。下面介绍完整的实现步骤。
前端参数传递方式
前端可以通过GET或POST方式传递筛选参数，通常筛选场景使用GET方式更方便，参数可以拼接在URL中。例如前端传递产品ID、月份、年份的URL格式如下：
<!-- 前端筛选表单示例 -->
<form action="/site/filter-data" method="get">
<select name="product_id">
<option value="">全部产品</option>
<option value="1">产品A</option>
<option value="2">产品B</option>
</select>
<select name="month">
<option value="">全部月份</option>
<option value="1">1月</option>
<option value="2">2月</option>
</select>
<select name="year">
<option value="">全部年份</option>
<option value="2023">2023年</option>
<option value="2024">2024年</option>
</select>
<button type="submit">筛选</button>
</form>
控制器接收参数
在Yii2控制器中，可以通过Yii::$app->request->get()方法获取GET参数，或使用post()方法获取POST参数。首先需要在控制器动作中定义接收参数的逻辑，同时处理参数未传递的情况。
<?php
namespace appcontrollers;
use Yii;
use yiiwebController;
use appmodelsProductSale; // 假设存在产品销售数据模型
class SiteController extends Controller
{
public function actionFilterData()
{
// 接收前端传递的筛选参数，设置默认值为空
$productId = Yii::$app->request->get('product_id', '');
$month = Yii::$app->request->get('month', '');
$year = Yii::$app->request->get('year', '');
// 后续查询逻辑将在下方补充
}
}
组装查询条件
Yii2的ActiveRecord查询构造器支持动态添加查询条件，我们可以根据参数是否为空来决定是否添加对应的筛选条件。如果参数为空，则不限制该维度的筛选。
<?php
// 接上面的actionFilterData方法内部逻辑
$query = ProductSale::find();
// 筛选产品ID，如果参数不为空则添加条件
if (!empty($productId)) {
$query->andWhere(['product_id' => $productId]);
}
// 筛选月份，如果参数不为空则添加条件
if (!empty($month)) {
$query->andWhere(['sale_month' => $month]); // 假设表中月份字段为sale_month
}
// 筛选年份，如果参数不为空则添加条件
if (!empty($year)) {
$query->andWhere(['sale_year' => $year]); // 假设表中年份字段为sale_year
}
// 执行查询获取结果
$list = $query->orderBy(['sale_date' => SORT_DESC])->asArray()->all();
返回筛选结果
获取到筛选后的数据后，可以根据项目需求返回JSON格式数据给前端，或者渲染到视图页面中。如果是前后端分离项目，通常返回JSON格式更合适。
<?php
// 接上面的查询逻辑
// 返回JSON格式数据
Yii::$app->response->format = yiiwebResponse::FORMAT_JSON;
return [
'code' => 0,
'msg' => 'success',
'data' => $list
];
// 如果是传统MVC模式，可渲染视图
// return $this->render('filter_result', ['list' => $list]);
注意事项
- 前端传递的参数需要做合法性校验，避免SQL注入风险，Yii2的参数绑定机制已经做了基础防护，但仍建议对参数类型做校验，比如月份和年份需要是数字类型。
- 如果筛选参数较多，可以将参数接收和查询条件组装封装成独立的方法，减少控制器动作的冗余代码。
- 当某个筛选维度不需要限制时，前端传递空值，控制器中判断为空就不添加对应查询条件即可。