告别 DB::raw() 的困境
作为一名 Laravel 开发者，我深知框架提供的 Eloquent ORM 和查询构建器（Query Builder）在日常开发中的便利。它们为我们抽象了底层数据库的差异，让我们可以专注于业务逻辑，而不用担心 SQL 语法在 MySQL、PostgreSQL 或 SQLite 之间的小小区别。
然而，这种美好的体验总有“破功”的时候。每当我需要执行一些数据库特有的函数、复杂的条件聚合，或者在 SELECT 语句中进行一些高级计算时，我都会不自觉地敲下 DB::raw()。例如，为了处理空值合并，我可能需要这样写：
// 针对 PostgreSQL
User::query()
->when(isPostgreSQL(), fn ($query) => $query->selectRaw('coalesce("user", "admin") AS "value"'));
// 针对 MySQL
User::query()
->when(isMySQL(), fn ($query) => $query->selectRaw('coalesce(`user`, `admin`) AS `value`'));你看，仅仅一个 coalesce 函数，我就需要考虑不同数据库的引号习惯 (" vs `)，甚至可能需要根据当前运行的数据库类型来动态调整 SQL 语句。这不仅让代码变得冗长且难以阅读，更重要的是，它彻底打破了 Laravel 数据库抽象的优势，让我的应用变得“数据库绑定”。一旦未来需要更换数据库，这些散落在代码各处的 DB::raw() 调用就会成为巨大的维护负担。
我常常想，有没有一种方式，能像 Eloquent 和查询构建器一样，以一种数据库无关的方式来表达这些复杂的 SQL 逻辑呢？
遇见 tpetry/laravel-query-expressions：解决方案的曙光
在一次偶然的探索中，我发现了 tpetry/laravel-query-expressions 这个 Composer 包。它简直就是我梦寐以求的解决方案！这个包利用了 Laravel 10 引入的一些新特性，将数据库无关的查询表达式带入了我们的开发流程。
它的核心思想是：将常见的 SQL 函数、操作符和逻辑判断封装成 PHP 对象。当你使用这些对象构建查询时，这个包会自动将它们转换成当前数据库引擎所理解的正确 SQL 语法，甚至能模拟一些在特定数据库版本中缺失的功能。这意味着，你只需编写一次代码，就能在不同的数据库上无缝运行！
轻松安装与使用
使用 Composer 安装 tpetry/laravel-query-expressions 非常简单：
composer require tpetry/laravel-query-expressions
安装完成后，你就可以开始用对象来替代那些恼人的 DB::raw() 调用了。
让我们回到前面 coalesce 的例子，看看使用 tpetry/laravel-query-expressions 后会变得多么优雅：
use Tpetry\QueryExpressions\Language\Alias;
use Tpetry\QueryExpressions\Function\Conditional\Coalesce;
use App\Models\User;
// 告别繁琐的 DB::raw() 和条件判断
User::select(new Alias(new Coalesce(['user', 'admin']), 'value'))
->get();是不是瞬间感觉清爽了许多？这里的 Coalesce 对象代表了 SQL 的 COALESCE 函数，Alias 对象则用于为结果设置别名。无论你的数据库是 MySQL 还是 PostgreSQL，tpetry/laravel-query-expressions 都会自动生成正确的 SQL 语句，无需你手动干预。
更多强大的查询能力
这个包提供的功能远不止于此，它涵盖了语言、操作符和函数等多个方面，让你可以构建出以前需要大量 DB::raw() 才能实现的复杂查询。
1. 聚合过滤（CountFilter, SumFilter）
想象一下，你需要为仪表盘统计不同年份和不同类型的电影数量，以往可能需要多个子查询或复杂的 CASE WHEN 语句。现在，你可以这样优雅地实现：
use Tpetry\QueryExpressions\Function\Aggregate\CountFilter;
use Tpetry\QueryExpressions\Operator\Comparison\Equal;
use Tpetry\QueryExpressions\Value\Value;
use App\Models\Movie;
Movie::select([
new CountFilter(new Equal('released', new Value(2021))),
new CountFilter(new Equal('released', new Value(2022))),
new CountFilter(new Equal('genre', new Value('Drama'))),
new CountFilter(new Equal('genre', new Value('Comedy'))),
])->where('streamingservice', 'netflix')
->get();CountFilter 结合 Equal 表达式，能够非常直观地实现带条件的计数聚合，生成的 SQL 语句会根据数据库类型自动优化，例如在 PostgreSQL 中会使用 COUNT(*) FILTER (WHERE ...)。
2. 条件逻辑（CaseGroup, CaseRule）
你甚至可以在查询中构建复杂的 CASE WHEN 逻辑，而无需编写任何原生 SQL：
use Tpetry\QueryExpressions\Language\{CaseGroup, CaseRule};
use Tpetry\QueryExpressions\Language\Alias;
use Tpetry\QueryExpressions\Operator\Comparison\Equal;
use Tpetry\QueryExpressions\Value\Value;
use App\Models\User;
User::query()
->select([
"id",
new Alias(
new CaseGroup(
when: [
new CaseRule(new Value("Admin"), new Equal("role", new Value(3))),
new CaseRule(new Value("Editor"), new Equal("role", new Value(2))),
new CaseRule(new Value("Viewer"), new Equal("role", new Value(1)))
],
else: new Value("Unknown Role")
),
"role_name"
)
])
->get();这段代码会根据用户的 role 字段，动态生成一个 role_name 别名，而且整个过程都是数据库无关的。
3. 更多实用功能
tpetry/laravel-query-expressions 还提供了：
-
数学函数:
Add,Subtract,Multiply,Divide,Abs等。 -
字符串函数:
Concat,Lower,Upper,Uuid4等。 -
时间函数:
Now,TimestampBin等，用于时间序列分析。 -
比较操作符:
GreaterThan,LessThan,Equal,Between等，可以直接用于where条件。
这些表达式都可以相互嵌套，形成非常强大和灵活的查询逻辑。
优势与实际应用效果
引入 tpetry/laravel-query-expressions 后，我的项目获得了显著的提升：
- 真正的数据库无关性：这是最大的优势。我的查询代码不再需要为特定数据库编写条件逻辑，一套代码可以在 MySQL、PostgreSQL 等多种数据库上无缝运行，大大降低了维护成本和未来迁移的风险。
- 提升代码可读性与维护性：相比于晦涩的 SQL 字符串，使用 PHP 对象来表达查询逻辑更加直观和易于理解。团队成员可以更快地理解查询意图，也更容易进行重构和测试。
- 减少错误：原生 SQL 语句容易出现拼写错误、引号问题或数据库兼容性问题。通过表达式对象，这些问题被抽象和自动化处理，减少了人为错误。
- 提高开发效率：开发者可以将更多精力放在业务逻辑上，而不是纠结于数据库的细枝末节。复杂的聚合和计算也能以更少的代码实现。
- 更好的 IDE 支持：因为是 PHP 对象，IDE 可以提供更好的自动补全和类型检查，提升开发体验。
总结
tpetry/laravel-query-expressions 是一个非常值得在 Laravel 项目中使用的 Composer 包。它优雅地解决了 DB::raw() 带来的数据库兼容性和维护性问题，让我们的数据库查询更加健壮、可读且易于维护。如果你还在为复杂的数据库操作而烦恼，或者希望你的 Laravel 应用拥有更好的跨数据库兼容性，那么我强烈推荐你尝试一下这个强大的工具。它将彻底改变你编写数据库查询的方式，让你的代码更加优雅和高效。
