可以通过一下地址学习composer：学习地址

告别 DB::raw() 的困境

作为一名 laravel 开发者，我深知框架提供的 Eloquent ORM 和查询构建器（Query Builder）在日常开发中的便利。它们为我们抽象了底层数据库的差异，让我们可以专注于业务逻辑，而不用担心 sql 语法在 mysql、postgresql 或 sqlite 之间的小小区别。

然而，这种美好的体验总有“破功”的时候。每当我需要执行一些数据库特有的函数、复杂的条件聚合，或者在 select 语句中进行一些高级计算时，我都会不自觉地敲下 DB::raw()。例如，为了处理空值合并，我可能需要这样写：

<pre class="brush:php;toolbar:false;">// 针对 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 非常简单：

<code class="bash">composer require tpetry/laravel-query-expressions</code>

安装完成后，你就可以开始用对象来替代那些恼人的 DB::raw() 调用了。

让我们回到前面 coalesce 的例子，看看使用 tpetry/laravel-query-expressions 后会变得多么优雅：

<pre class="brush:php;toolbar:false;">use TpetryQueryExpressionsLanguageAlias; use TpetryQueryExpressionsFunctionConditionalCoalesce; use appModelsUser;  // 告别繁琐的 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）

腾讯智影-AI数字人

基于AI数字人能力，实现7*24小时AI数字人直播带货，低成本实现直播业务快速增增，全天智能在线直播

73

查看详情

想象一下，你需要为仪表盘统计不同年份和不同类型的电影数量，以往可能需要多个子查询或复杂的 CASE WHEN 语句。现在，你可以这样优雅地实现：

<pre class="brush:php;toolbar:false;">use TpetryQueryExpressionsFunctionAggregateCountFilter; use TpetryQueryExpressionsOperatorComparisonEqual; use TpetryQueryExpressionsValueValue; use AppModelsMovie;  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：

<pre class="brush:php;toolbar:false;">use TpetryQueryExpressionsLanguage{CaseGroup, CaseRule}; use TpetryQueryExpressionsLanguageAlias; use TpetryQueryExpressionsOperatorComparisonEqual; use TpetryQueryExpressionsValueValue; use AppModelsUser;  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 后，我的项目获得了显著的提升：

1. 真正的数据库无关性：这是最大的优势。我的查询代码不再需要为特定数据库编写条件逻辑，一套代码可以在 MySQL、PostgreSQL 等多种数据库上无缝运行，大大降低了维护成本和未来迁移的风险。
2. 提升代码可读性与维护性：相比于晦涩的 SQL 字符串，使用 PHP 对象来表达查询逻辑更加直观和易于理解。团队成员可以更快地理解查询意图，也更容易进行重构和测试。
3. 减少错误：原生 SQL 语句容易出现拼写错误、引号问题或数据库兼容性问题。通过表达式对象，这些问题被抽象和自动化处理，减少了人为错误。
4. 提高开发效率：开发者可以将更多精力放在业务逻辑上，而不是纠结于数据库的细枝末节。复杂的聚合和计算也能以更少的代码实现。
5. 更好的 IDE 支持：因为是 PHP 对象，IDE 可以提供更好的自动补全和类型检查，提升开发体验。

总结

tpetry/laravel-query-expressions 是一个非常值得在 Laravel 项目中使用的 Composer 包。它优雅地解决了 DB::raw() 带来的数据库兼容性和维护性问题，让我们的数据库查询更加健壮、可读且易于维护。如果你还在为复杂的数据库操作而烦恼，或者希望你的 Laravel 应用拥有更好的跨数据库兼容性，那么我强烈推荐你尝试一下这个强大的工具。它将彻底改变你编写数据库查询的方式，让你的代码更加优雅和高效。

以上就是告别DB::raw，使用tpetry/laravel-query-expressions让你的Laravel数据库查询实现跨数据库兼容的详细内容，更多请关注php中文网其它相关文章！