README

此包为模型创建 MySQL 全文索引，并允许您通过这些索引进行搜索。

安装

使用 composer 安装 composer require swisnl/laravel-fulltext
发布迁移和配置 php artisan vendor:publish --tag=laravel-fulltext
迁移数据库 php artisan migrate

用法

该包使用模型观察者来更新索引，当模型发生变化时。如果您想运行一个完整的索引，可以使用控制台命令。

模型

将 Indexable 特性添加到您想要索引的模型中，并定义您想要索引的列，如标题和内容。

示例

class Country extends Model
{

    use \Swis\Laravel\Fulltext\Indexable;

    protected $indexContentColumns = ['biographies.name', 'political_situation', 'elections'];
    protected $indexTitleColumns = ['name', 'governmental_type'];

}

您可以使用点表示法查询模型的关联关系，例如 biographies.name。

搜索

您可以使用 Search 类进行搜索。

$search = new \Swis\Laravel\Fulltext\Search();
$search->run('europe');

这将返回一个包含在 Polymorphic 关系 indexable 中的模型的 Collection。

如果您只想搜索特定模型，可以使用 $search->runForClass('europe', Country::class);。这将仅返回该模型的搜索结果。

Artisan 命令

laravel-fulltext:all

为某个类索引所有模型。

php artisan laravel-fulltext:all \\App\\Models\\Country

laravel-fulltext:one

为某个类的单个模型索引。

php artisan laravel-fulltext:one \\App\\Models\\Country 4

选项

db_connection

选择要使用的数据库连接，默认为默认数据库连接。当您不使用默认数据库连接时，在运行迁移之前必须设置此选项才能正确工作。

weight.title weight.content

在结果中对 title 或 content 进行加权。搜索结果分数乘以此配置中的权重。

enable_wildcards

启用单词后的通配符。因此，当搜索例如 car 时，它也会匹配 carbon。

exclude_feature_enabled

此功能排除某些行返回。当您在模型中有一个标志确定此记录是否必须在搜索查询中返回时，启用此功能。默认情况下，此功能已禁用。

exclude_records_column_name

该属性的列名（充当标志）。这必须与表中的列名完全匹配。

使用此功能的示例

如果您有一个博客，然后向您的博客添加此搜索功能以搜索博客文章。有时您不希望在搜索结果中显示某些文章，例如，当文章尚未发布时。此功能可以帮助您做到这一点。

变更日志

请参阅 CHANGELOG 了解最近更改的详细信息。

测试

composer test

贡献

有关详细信息，请参阅 CONTRIBUTING 和 CODE_OF_CONDUCT。

安全

如果您发现任何安全问题，请通过电子邮件 security@swis.nl 而不是使用问题跟踪器。

致谢

许可证

MIT 许可证 (MIT)。有关更多信息，请参阅许可证文件。

本包是Treeware。如果您在生产环境中使用它，我们请求您为世界种一棵树以感谢我们的工作。通过为Treeware森林做出贡献，您将为当地家庭创造就业机会并恢复野生动物栖息地。

SWIS ❤️ 开源

SWIS是一家来自荷兰莱顿的互联网公司。我们热爱与开源软件合作。

swisnl / laravel-fulltext

维护者

详细信息