Laravel全名搜索排序方法分享

本文深入探讨了在 Laravel 8 中高效实现用户全名（first_name + last_name 分离存储）的模糊搜索与排序难题，摒弃低效且不安全的 whereRaw 和 CONCAT 拼接方案，转而采用 MySQL 原生 FULLTEXT 联合索引实现毫秒级、高相关性的跨字段自然语言搜索，并结合生成列（Generated Column）加索引的方式优雅支持严格字典序的全名排序，既大幅提升大数据量下的查询性能，又保障代码可维护性、数据库可移植性与应用安全性，是 Laravel 开发者处理真实业务中姓名检索场景的高性能标准实践。

本文介绍在 Laravel 8 中不使用 `whereRaw` 的前提下，通过数据库原生全文索引（FULLTEXT）对分散存储的 `first_name` 和 `last_name` 字段进行联合模糊搜索与按全名排序的高性能方案。

在实际开发中，当用户姓名被拆分为 first_name 和 last_name 两个独立字段时，常见的搜索需求（如输入“John Doe”匹配完整姓名）和排序需求（如 orderBy('full_name')）往往难以优雅实现——若强行拼接字符串或使用 whereRaw(CONCAT(...))，不仅破坏 Eloquent 的可移植性，更会在大数据量场景下引发严重性能瓶颈（如全表扫描、无法利用索引）。

推荐方案：MySQL FULLTEXT 索引 + Laravel 原生查询构造器

MySQL 的 FULLTEXT 索引专为文本搜索优化，支持自然语言模式（MATCH ... AGAINST），可跨多列建立联合索引，并自动处理词序、停用词与相关性排序。相比 LIKE '%term%' 或 CONCAT() 拼接，其查询速度提升可达数量级，且完全避免 whereRaw 的安全与维护风险。

✅ 第一步：为 first_name 和 last_name 添加联合 FULLTEXT 索引
在迁移文件中添加：

// php artisan make:migration add_fulltext_index_to_employees
public function up(MigrationBuilder $migration)
{
    $migration->table('employees', function (Blueprint $table) {
        $table->fullText(['first_name', 'last_name']);
    });
}

执行迁移后，MySQL 将创建一个覆盖两列的全文索引（注意：仅 InnoDB 表支持多列 FULLTEXT；MyISAM 已弃用）。

✅ 第二步：重构 scopeSearch，使用 MATCH ... AGAINST 替代 orWhere 链

public function scopeSearch($query, $term)
{
    $term = trim($term);
    if (empty($term)) {
        return $query;
    }

    // 使用自然语言模式（默认），自动按相关性排序
    $query->where(function ($q) use ($term) {
        $q->where('type', 'LIKE', "%{$term}%")
          ->orWhere('name', 'LIKE', "%{$term}%")
          ->orWhereHas('level', fn($sub) => $sub->where('name', 'LIKE', "%{$term}%"))
          ->orWhereHas('employee', function ($sub) use ($term) {
              // ✅ 关键替换：用 MATCH 对 first_name + last_name 联合搜索
              $sub->whereRaw("MATCH(first_name, last_name) AGAINST(? IN NATURAL LANGUAGE MODE)", [$term]);
              // 同时保留 employee_number 等其他字段的 LIKE 搜索
              $sub->orWhere('employee_number', 'LIKE', "%{$term}%");
          })
          ->orWhereHas('status', fn($sub) => $sub->where('name', 'LIKE', "%{$term}%"));
    });

    return $query;
}

⚠️ 注意：MATCH ... AGAINST 在 NATURAL LANGUAGE MODE 下不支持通配符（如 *），但会智能匹配词干与近义词；若需精确前缀匹配（如“Joh”），可改用 BOOLEAN MODE 并配合 `+John +Doe*` 语法（需确保最小词长配置合理）。

✅ 第三步：实现按全名排序（无需虚拟列或 whereRaw）

由于 MySQL 不支持直接 ORDER BY CONCAT(first_name, ' ', last_name) 利用索引，但可通过 MATCH 的隐式相关性排序获得“语义上更匹配”的结果。若需严格字典序排序（如 A-Z 全名列表），建议：

• 方案 A（推荐）：添加生成列（Generated Column）并建索引（MySQL 5.7+）

  ALTER TABLE employees 
    ADD COLUMN full_name VARCHAR(255) 
      GENERATED ALWAYS AS (CONCAT(TRIM(first_name), ' ', TRIM(last_name))) STORED,
    ADD INDEX idx_full_name (full_name);

  Laravel 中即可安全使用：

  ->orderBy('full_name', $this->order)

• 方案 B（兼容性更强）：应用层排序（适用于分页数据量可控场景）

  $models = Model::where('company_id', Auth::user()->company_id)
      ->search(trim($this->search))
      ->paginate($this->size);
  
  // 对当前页结果按全名排序（注意：仅限小页码，避免内存溢出）
  $models->items()->sort(function ($a, $b) {
      $fullNameA = trim("{$a->employee->first_name} {$a->employee->last_name}");
      $fullNameB = trim("{$b->employee->first_name} {$b->employee->last_name}");
      return $this->order === 'desc' 
          ? strcmp($fullNameB, $fullNameA) 
          : strcmp($fullNameA, $fullNameB);
  });

? 关键总结

• ✅ FULLTEXT 是解决多字段联合模糊搜索的标准、高效、安全方案，远优于 whereRaw 或 LIKE；
• ✅ 生成列（STORED）+ 索引是实现 ORDER BY full_name 的最佳实践，兼顾性能与可维护性；
• ❌ 避免在 WHERE 或 ORDER BY 中使用 CONCAT()、TRIM() 等函数，会导致索引失效；
• ? 测试时务必使用 EXPLAIN 验证查询是否命中 FULLTEXT 或 idx_full_name 索引。

通过以上改造，你将获得毫秒级全名搜索响应与稳定的字典序排序能力，同时保持 Laravel 代码的清晰性与数据库层的高性能。

终于介绍完啦！小伙伴们，这篇关于《Laravel全名搜索排序方法分享》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！