如何在Laravel中实现搜索功能-Laravel-PHP中文网

如何在Laravel中实现搜索功能

星降

发布： 2025-07-07 22:04:02

原创

434人浏览过

在laravel中实现搜索功能最直接的方式是使用数据库like查询，适用于小规模应用；若需处理大规模数据或复杂搜索逻辑，则应引入laravel scout配合algolia或meilisearch等专业搜索服务。1. 对于简单场景，通过表单提交、路由定义和控制器中的like查询即可实现基础搜索功能；2. 优化查询性能可通过添加数据库索引、使用全文索引（full-text index）、延迟加载与预加载关联数据等方式提升效率；3. 当需要更高级的搜索体验时，laravel scout提供了一种便捷方式，通过集成searchable trait将模型数据同步到搜索引擎，并支持简洁的搜索查询接口，显著提升开发效率与搜索体验。

如何在Laravel中实现搜索功能

在Laravel中实现搜索功能，最直接的方式就是利用数据库的LIKE查询，这对于小规模应用来说绰绰有余。但如果数据量上来，或者需要更复杂的搜索逻辑，比如模糊匹配、相关性排序，那么引入专业的搜索服务或包，像Laravel Scout配合Algolia或MeiliSearch，会是更明智的选择。关键在于根据项目的实际需求和数据规模来选择最适合的方案。

解决方案

说实话，大部分项目刚开始时，简单的数据库LIKE查询就够用了。它实现起来快，成本也低。

我们假设有一个posts表，里面有title和content字段。

1. 表单和路由： 首先，我们需要一个搜索表单。在resources/views/posts/index.blade.php里可以这样：

<form action="{{ route('posts.search') }}" method="GET">
    <input type="text" name="query" placeholder="搜索文章标题或内容..." value="{{ request('query') }}">
    <button type="submit">搜索</button>
</form>

@foreach ($posts as $post)
    <div class="post-item">
        <h3>{{ $post->title }}</h3>
        <p>{{ Str::limit($post->content, 150) }}</p>
    </div>
@endforeach

{{ $posts->appends(request()->query())->links() }}

登录后复制

路由配置，在routes/web.php：

use App\Http\Controllers\PostController;

Route::get('/posts', [PostController::class, 'index'])->name('posts.index');
Route::get('/posts/search', [PostController::class, 'search'])->name('posts.search');

登录后复制

2. 控制器逻辑： 在app/Http/Controllers/PostController.php中，search方法会处理搜索逻辑。

<?php

namespace App\Http\Controllers;

use App\Models\Post;
use Illuminate\Http\Request;
use Illuminate\Support\Str; // 引入 Str 门面

class PostController extends Controller
{
    public function index()
    {
        $posts = Post::paginate(10); // 默认展示所有文章
        return view('posts.index', compact('posts'));
    }

    public function search(Request $request)
    {
        $query = $request->input('query');

        // 简单的输入验证，避免空查询
        if (empty($query)) {
            // 我通常会直接重定向回列表页或者给个空结果，看业务需求
            return redirect()->route('posts.index')->with('error', '请输入搜索关键词。');
        }

        // 使用 LIKE 查询进行搜索，忽略大小写
        // 注意：这里用的是 MySQL 的 ILIKE 等价物，对于 PostgreSQL 可以直接用 ILIKE
        $posts = Post::where('title', 'like', '%' . $query . '%')
                     ->orWhere('content', 'like', '%' . $query . '%')
                     ->paginate(10);

        // 确保分页链接带上搜索参数
        $posts->appends(['query' => $query]);

        return view('posts.index', compact('posts'));
    }
}

登录后复制

这种方式直观且易于理解，对于数据量不大、搜索需求不复杂的场景，完全够用。但它也有明显的短板，比如性能和搜索结果的准确性。

Laravel搜索功能中如何优化查询性能？

当我们开始抱怨搜索慢、用户体验差的时候，通常就是需要优化的时候了。我个人在处理这类问题时，会从几个方面入手：

1. 数据库索引： 这是最基础也是最有效的优化手段。如果你的title或content字段上没有索引，那么每次LIKE查询都会进行全表扫描，这在数据量大时简直是灾难。给你的搜索字段加上B-tree索引，比如：

Schema::table('posts', function (Blueprint $table) {
    $table->index('title');
    // 如果 content 字段很长，可能需要考虑 TEXT 类型字段的索引限制，或者使用全文索引
    // $table->index('content');
});

登录后复制

对于LIKE '%keyword%'这种前缀模糊匹配，标准B-tree索引的效率会大打折扣，因为无法利用索引进行快速定位。这时，如果数据库支持（如MySQL），可以考虑使用全文索引（Full-Text Index）。

企业网站通用源码1.0

企业网站通用源码是以aspcms作为核心进行开发的asp企业网站源码。企业网站通用源码是一套界面设计非常漂亮的企业网站源码，是2016年下半年的又一力作，适合大部分的企业在制作网站是参考或使用，源码亲测完整可用，没有任何功能限制，程序内核使用的是aspcms，如果有不懂的地方或者有不会用的地方可以搜索aspcms的相关技术问题来解决。网站UI虽然不是特别细腻，但是网站整体格调非常立体，尤其是通观全

查看详情

2. 使用全文索引（Full-Text Search）： MySQL的InnoDB存储引擎从5.6版本开始支持全文索引。这比LIKE查询强大得多，能更好地处理自然语言搜索。在迁移文件中添加全文索引：

Schema::table('posts', function (Blueprint $table) {
    $table->text('content')->change(); // 确保 content 是 TEXT 类型
    $table->fullText(['title', 'content']);
});

登录后复制

然后在查询时使用MATCH AGAINST：

$posts = Post::whereRaw("MATCH (title, content) AGAINST (?)", [$query])
             ->paginate(10);

登录后复制

这会显著提升包含LIKE '%keyword%'模式的搜索性能和相关性。但要注意，全文索引有其自身的限制和配置要求。

3. 延迟加载与预加载： 如果你的搜索结果列表需要展示关联数据（比如文章作者），确保你使用了with()进行预加载，避免N+1查询问题。

$posts = Post::where(...)
             ->with('author') // 假设 Post 模型有 author 关联
             ->paginate(10);

登录后复制

4. 引入专业搜索服务/引擎： 当数据库层面的优化达到瓶颈，或者你需要更高级的功能（如拼写纠错、同义词、地理位置搜索等），那么Laravel Scout或直接集成Elasticsearch、Algolia、MeiliSearch就是必由之路了。这些服务专门为搜索而生，性能和功能都远超传统数据库查询。这通常是我在项目发展到一定阶段，对搜索体验有更高要求时的首选。

Laravel Scout如何提升搜索体验？

Laravel Scout是Laravel官方提供的一个轻量级解决方案，它通过为Eloquent模型添加一个searchable trait，将模型数据同步到各种搜索驱动（如Algolia, MeiliSearch, Elasticsearch等）。我个人觉得它最大的优点就是将复杂的搜索服务集成变得异常简单，让开发者能专注于业务逻辑，而不是底层搜索引擎的API。

1. 核心理念与安装： Scout的核心思想就是把你的Eloquent模型变成“可搜索的”。安装Scout：

composer require laravel/scout
php artisan vendor:publish --provider="Laravel\Scout\ScoutServiceProvider"

登录后复制

选择并配置你的搜索驱动，比如MeiliSearch（因为它开源，易于本地开发测试）：

composer require meilisearch/meilisearch-php

登录后复制

在.env文件中配置MeiliSearch的URL和API Key。

2. 模型集成： 在你的模型（例如App\Models\Post.php）中引入Searchable trait：

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Laravel\Scout\Searchable; // 引入 Searchable trait

class Post extends Model
{
    use HasFactory, Searchable; // 使用 trait

    // 定义哪些字段应该被索引
    public function toSearchableArray()
    {
        $array = $this->toArray();

        // 假设我们只想索引 title 和 content
        return [
            'id' => $array['id'],
            'title' => $array['title'],
            'content' => $array['content'],
        ];
    }
}

登录后复制

然后，你需要将现有数据导入到搜索索引中：

php artisan scout:import "App\Models\Post"

登录后复制

之后，每当Post模型被创建、更新或删除时，Scout会自动同步数据到搜索索引。

3. 搜索查询： 查询就变得异常简洁：

use App\Models\Post;
use Illuminate\Http\Request;

public function search(Request $request)
{
    $query = $request->input('query');

    if (empty($query)) {
        return redirect()->route('posts.index

登录后复制

以上就是如何在Laravel中实现搜索功能的详细内容，更多请关注php中文网其它相关文章！