如何安装或启用Laravel Nova的SearchableRelation功能？

1. 确认Nova版本匹配 #

你参考的是Nova v5的文档，首先检查项目的Nova版本是否为v5及以上：

• 在项目根目录运行命令：composer show laravel/nova，查看输出的版本号。
• 若版本低于v5，需升级到v5版本才能使用该文档中描述的关系搜索功能。

2. 正确配置关系搜索（不存在SearchableRelation类） #

Nova v5中并没有名为SearchableRelation的独立类或Trait，文档中提到的「搜索关联关系」是通过资源类的searchableFields属性或searchable方法来配置的：

方式一：点语法快速配置 #

在Nova资源类中定义searchableFields，直接用点语法关联模型字段：

public static $searchableFields = [
    'id',
    'title',
    'author.name', // 搜索关联的author模型的name字段
    'author.email',
];

方式二：闭包自定义搜索逻辑 #

如果需要更灵活的搜索规则，重写searchable方法：

public static function searchable(Request $request)
{
    return static::where('title', 'like', "%{$request->search}%")
        ->orWhereHas('author', function ($query) use ($request) {
            $query->where('name', 'like', "%{$request->search}%")
                  ->orWhere('email', 'like', "%{$request->search}%");
        });
}

3. 新项目无法使用的排查要点 #

• 安装Nova时指定v5版本：执行composer require laravel/nova:^5.0确保安装的是对应版本。
• 检查资源类是否手动配置了上述搜索规则，默认Nova资源不会自动包含关联字段的搜索配置。

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