本文详解如何在 Laravel 中通过视图中的 下拉框动态筛选并显示指定年份的文章，涵盖路由配置、表单提交、控制器接收与查询逻辑，解决常见请求未触发、参数获取失败等问题。
本文详解如何在 laravel 中通过视图中的 `
在 Laravel 开发中，实现“按年份筛选文章”这类交互功能，核心在于前后端数据联动：前端提供可选年份的下拉菜单，并通过表单提交将选中值传至后端；后端控制器接收该值，动态构建数据库查询条件。以下为经过验证的完整、健壮实现方案。
✅ 正确做法：使用 POST 表单 + 显式 Request 依赖注入
首先，确保路由支持两种请求方式（GET 用于初始加载，POST 用于筛选提交）：
// routes/web.php
Route::get('/', [HomeController::class, 'index'])->name('home');
Route::post('/', [HomeController::class, 'index']);
⚠️ 注意：不要混用 Route::match(['GET', 'POST'], ...)，明确分离更利于调试和中间件控制。
其次，视图中需包裹
{{-- resources/views/home.blade.php --}}
? 提示：添加 @csrf 是关键——Laravel 默认启用 CSRF 保护，缺少此指令会导致 419 Page Expired 错误。
控制器中，必须通过方法参数显式注入 Illuminate\Http\Request 实例（而非使用过时的全局 Request 辅助函数或 request() 辅助函数在闭包外调用），并正确处理空值场景：
<?php namespace App\Http\Controllers;
use App\Article;
use App\Catalog;
use Illuminate\Http\Request;
use App\Http\Controllers\Controller;
class HomeController extends Controller
{
public function index(Request $request)
{
// 获取用户选择的年份，支持空值（首次访问时为空）
$selectedYear = $request->input('article_year');
// 查询所有可用年份（用于下拉菜单）
$years = Catalog::where('catalog_type_id', 3)
->where('is_active', 1)
->orderBy('sort_num', 'asc')
->get();
// 构建查询：若未选择年份，则不加 user_year 条件（显示全部）；否则精确匹配
$newsQuery = Article::orderBy('sort_num', 'desc');
$pinnedQuery = Article::orderBy('sort_num', 'desc');
if ($selectedYear) {
$newsQuery->where('user_year', $selectedYear);
$pinnedQuery->where('user_year', $selectedYear);
}
$data['year'] = $years;
$data['news_pin'] = $pinnedQuery->where('is_active', 1)->get();
$data['news'] = $newsQuery->where('is_active', 0)->get();
return view('home', $data);
}
}
? 常见错误与修复要点
| 问题现象 | 根本原因 | 解决方案 |
|---|---|---|
| Undefined variable: request | 控制器方法未声明 $request 参数，却直接使用 $request->get(...) | 改为 public function index(Request $request) 并删除全局 use Request; |
| 下拉框无响应 / 点击不提交 | 使用标准 | |
| 数据库查不到结果 | $item->id 被用作 value，但 user_year 字段存的是年份字符串（如 "2022"），类型不匹配 | 改为 |
| 首次访问报错或筛选后年份选项丢失 | 未在 Blade 中回显已选值，导致 UX 断层 | 使用 {{ request('article_year') == $item->name ? 'selected' : '' }} 保持状态 |
✅ 进阶建议（可选）
- 使用 Eloquent Resource 或 API 方式：对复杂筛选，可考虑通过 Axios 发送 AJAX 请求，返回 JSON 数据并局部刷新列表，提升体验。
- 添加验证与默认兜底：对 $selectedYear 做格式校验（如 ^\d{4}$），避免 SQL 注入风险（虽然 Eloquent 的 where() 已参数化，但仍建议防御性编程）。
- 缓存优化：年份列表变化频率低，可使用 Cache::remember() 减少数据库查询。
通过以上结构化实现，你将获得一个稳定、可维护、符合 Laravel 最佳实践的年份筛选功能。记住：表单是桥梁，Request 是入口，Eloquent 是引擎，而清晰的状态管理是用户体验的基石。
