本文详解如何将原生 SQL 转换为 Laravel Query Builder 风格代码，解决因直接使用 DB::select() 返回数组导致 Blade 模板报错的问题，并提供安全、可维护的链式查询写法。
本文详解如何将原生 sql 转换为 laravel query builder 风格代码，解决因直接使用 `db::select()` 返回数组导致 blade 模板报错的问题，并提供安全、可维护的链式查询写法。
在 Laravel 中，直接拼接原生 SQL 字符串（如 DB::select()）虽可行，但易引发类型错误与 SQL 注入风险。例如，DB::select() 总是返回结果集数组（即使只查 COUNT），而 Blade 模板中若直接 {{ $special }} 输出，会触发 htmlspecialchars() expects parameter 1 to be string, array given 错误——因为模板引擎试图对数组调用字符串转义函数。
正确的做法是使用 Laravel 的 Query Builder 构建结构化查询。针对您提供的 SQL：
SELECT COUNT('vehicules.id')
FROM vehicules
INNER JOIN (equipements, contenirs)
ON (contenirs.vehicule_id = vehicules.id AND contenirs.equipement_id = equipements.id)
WHERE (vehicules.KMActuel - contenirs.dernierKM > equipements.kilometrageMax);
应转换为以下链式语法（推荐写法）：
use Illuminate\Support\Facades\DB;
$specialCount = DB::table('vehicules')
->join('contenirs', 'vehicules.id', '=', 'contenirs.vehicule_id')
->join('equipements', 'equipements.id', '=', 'contenirs.equipement_id')
->whereRaw('vehicules.KMActuel - contenirs.dernierKM > equipements.kilometrageMax')
->count('vehicules.id'); // ✅ 返回整型数字，可直接在 Blade 中安全输出
? 关键说明：
->count('vehicules.id')返回的是 PHP integer，而非数组，完美适配{{ $specialCount }}；- 使用
->join()显式声明连接关系，替代过时且易出错的隐式逗号连接（(equipements, contenirs)）；->whereRaw()用于包裹含运算符和跨表字段计算的条件，确保 SQL 表达式被原样执行；- 所有字段名建议加反引号（如
`vehicules`.`id`）以规避关键字冲突（Laravel 8+ 可通过配置启用自动转义）。
在控制器中赋值后传递至视图：
return view('dash', ['specialCount' => $specialCount]);
Blade 中即可安全渲染：
<p>需维护的车辆数量：{{ $specialCount }}</p>
✅ 最佳实践提醒：
- 避免在
whereRaw()中拼接用户输入，如有动态参数，请使用参数绑定：->whereRaw('vehicules.KMActuel - contenirs.dernierKM > ?', [$maxKm]) - 若需复用该逻辑，建议封装为 Eloquent 模型作用域（Scope）或 Repository 方法，提升可测试性与可读性；
- 对于复杂统计类查询，也可考虑使用
DB::scalar()（Laravel 10.29+）获取单值，语义更清晰。
遵循此方式，既保障了安全性与类型一致性，又充分利用了 Laravel 的查询构建能力，让数据库操作更稳健、可维护。
