Laravel中如何实现表字段值别名匹配？有没有Eloquent内置处理方案？

Laravel 没有专门针对名称别名映射查询的开箱即用内置功能，但可以通过框架原生提供的查询作用域特性实现，无需手动重写全量模型查找方法，实现成本远低于自定义getByName系列逻辑：

方案1：本地作用域（推荐，无侵入） #

适用于只需要在部分查询场景下走别名匹配的情况，不影响原有代码逻辑，支持链式调用其他查询条件：

1. 首先确保你的主模型已经定义好和aliases表的一对多关联：

// 主模型（例：Business.php）中定义关联
public function aliases()
{
    return $this->hasMany(Alias::class);
}

2. 定义本地查询作用域封装匹配逻辑：

// 同主模型中添加作用域方法
public function scopeWhereNameMatches($query, string $targetName)
{
    return $query->where('name', $targetName)
        ->orWhereHas('aliases', function ($subQuery) use ($targetName) {
            $subQuery->where('alias_name', $targetName);
        })
        ->distinct(); // 避免多别名匹配时返回重复主记录
}

3. 直接在业务代码中调用即可：

// 匹配正式名或别名返回对应主记录
$record = Business::whereNameMatches('目标名称')->first();
// 也可以叠加其他查询条件
$validRecord = Business::whereNameMatches('目标名称')->where('status', 1)->first();

方案2：全局作用域（零改造成本） #

适用于希望所有对name字段的查询自动包含别名匹配、无需修改原有业务调用代码的场景：

1. 新建全局作用域类：

<?php

namespace App\Models\Scopes;

use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Scope;

class NameWithAliasScope implements Scope
{
    public function apply(Builder $builder, Model $model)
    {
        $builder->leftJoin('aliases', 'aliases.business_id', '=', 'business.id');
    }

    public function extend(Builder $builder)
    {
        // 重写where逻辑，对name字段的查询自动匹配主表名和别名
        $builder->macro('where', function (Builder $builder, $column, $operator = null, $value = null, $boolean = 'and') {
            if ($column === 'name') {
                return $builder->where(function ($q) use ($operator, $value) {
                    $q->where('business.name', $operator, $value)
                        ->orWhere('aliases.alias_name', $operator, $value);
                }, null, null, $boolean);
            }
            // 其他字段走默认查询逻辑
            return $builder->whereRaw($column, $operator, $value, $boolean);
        });
    }
}

2. 在主模型的boot方法中注册全局作用域：

protected static function booted()
{
    static::addGlobalScope(new NameWithAliasScope);
}

注册完成后原有代码中所有where('name', $xxx)、firstWhere('name', $xxx)的调用都无需修改，自动支持别名匹配。

若需要处理拼写错误的模糊匹配，可直接在作用域的查询逻辑中替换精确匹配为数据库原生的SOUNDEX、LEVENSHTEIN函数或LIKE模糊匹配，无需调整调用层逻辑。

内容的提问来源于stack exchange，提问作者Scott