Laravel关联表排序：避免静态分析报错的优雅实现方案

针对你的两个排序需求，以下是符合Laravel Eloquent风格的实现方案，既避免手写JOIN、内存排序，也不会触发PHPStan静态分析错误：

1. 按Encounter的last_name排序（一级关联） #

推荐方式：利用withAggregate定义聚合字段后排序 #

先在Note模型中新增一个聚合关联：

class Note extends Model
{
    public function encounter()
    {
        return $this->belongsTo(Encounter::class);
    }

    // 定义聚合字段，获取关联Encounter的last_name
    public function encounterLastName()
    {
        return $this->withAggregate('encounter', 'last_name');
    }
}

之后直接按该聚合字段排序，语法简洁且完全符合静态分析要求：

Note::query()->orderBy('encounter_last_name');

备选方式：子查询转表达式排序 #

如果不想新增模型方法，可将子查询包装为Expression，避免类型不匹配错误：

$lastNameSubquery = Encounter::select('last_name')
    ->whereColumn('encounters.id', 'notes.encounter_id')
    ->limit(1);

Note::query()->orderBy(\Illuminate\Database\Query\Expression::make(
    $lastNameSubquery->toSql(),
    $lastNameSubquery->getBindings()
));

2. 按Site的name排序（二级关联） #

推荐方式：使用joinRelation多级关联JOIN #

Laravel提供的joinRelation方法支持一键关联多级关系，无需手写JOIN条件，风格统一且高效：

Note::query()
    ->joinRelation('encounter.site') // 自动处理两级关联的JOIN逻辑
    ->select('notes.*') // 仅查询notes表字段，避免字段冲突
    ->orderBy('sites.name');

备选方式：嵌套子查询转表达式排序 #

如果偏好子查询方式，同样通过Expression包装解决静态分析问题：

$siteNameSubquery = Site::select('name')
    ->join('encounters', 'encounters.site_id', '=', 'sites.id')
    ->whereColumn('encounters.id', 'notes.encounter_id')
    ->limit(1);

Note::query()->orderBy(\Illuminate\Database\Query\Expression::make(
    $siteNameSubquery->toSql(),
    $siteNameSubquery->getBindings()
));

或者用更简洁的orderByRaw：

Note::query()->orderByRaw('(
    SELECT sites.name 
    FROM sites 
    JOIN encounters ON encounters.site_id = sites.id 
    WHERE encounters.id = notes.encounter_id 
    LIMIT 1
)');

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