掌握 Laravel 查询表达式，告别 DB::raw()

Laravel 的数据库抽象层提供了在处理多种数据库时的便利性，使得开发者无需关注底层细节。但当遇到 Laravel 没有直接支持的功能时，我们通常会借助 DB::raw() 来编写原生 SQL。现在有一个更优雅的解决方案——laravel-query-expressions，这个开源项目旨在为你提供数据库独立的查询表达式。

项目简介

laravel-query-expressions 是一个针对 Laravel 10 及以上版本的扩展包，它引入了新的查询表达式，允许你在不依赖数据库特定语法的情况下，利用更多的数据库功能。通过这个库，你可以轻松地创建和组合复杂的查询，而不用担心代码在不同数据库间的兼容性问题。

例如，原本需要针对不同数据库编写如下的查询：

User::query()
    ->when(isPostgreSQL(), fn ($query) => $query->selectRaw('coalesce("user", "admin") AS "value"'))
    ->when(isMySQL(), fn ($query) => $query->selectRaw('coalesce(`user`, `admin`) AS `value`'))

现在可以简化为：

User::select(new Alias(new Coalesce(['user', 'admin']), 'count'));

同样，也可以实现对数据聚合的新方法，如：

Movie::select([
    new CountFilter(new Equal('released', new Value(2021))),
    // 更多统计项...
])->where('streamingservice', 'netflix');

技术分析

该扩展包实现了许多强大的查询表达式，包括但不限于：

• 数据操作：例如 Add、Divide 和 Modulo 等算术运算符。
• 条件判断：比如 Equal、GreaterThan 和 Between 等比较运算符，以及 CaseGroup 和 CaseRule 提供的 CASE-WHEN 结构。
• 函数应用：像 CountFilter、SumFilter 这样的聚合函数过滤器，以及 Avg、Max、Min 等传统聚合函数。

所有的表达式都可以与 Laravel 的 Eloquent 查询构造器无缝结合，保持代码整洁且易于维护。

应用场景

• 当你需要在不修改现有代码结构的情况下，添加对新数据库的支持时。
• 在创建复杂的数据统计或报表时，避免多次查询，提高性能。
• 当你的应用程序需要跨数据库运行，但又希望保持代码一致性时。

项目特点

• 数据库独立：所有表达式都根据所使用的数据库引擎自动调整语法，确保在任何环境下都能正常工作。
• 强大易用：提供了丰富的预定义表达式，用于构建复杂的查询逻辑。
• 向下兼容：即使在旧版 Laravel 中，也能通过模拟实现部分功能，最大化可用性。
• 代码简洁：消除对 DB::raw() 的依赖，使查询代码更加清晰、可读性强。

要安装这个项目，只需简单地执行：

composer require tpetry/laravel-query-expressions

然后就可以开始享受它带来的便捷了！

总的来说，laravel-query-expressions 是提升 Laravel 应用程序数据库操作灵活性和可移植性的强大工具。如果你正面临着数据库兼容性问题或需要构建复杂查询，不妨试试看，它会让你的开发体验更上一层楼。