README

一个简单的 Laravel 8 扩展包，用于对 Sphinx Search 执行查询。基于 sngrl/sphinxsearch 扩展包对 Laravel 5 的支持。

创建此扩展包是为了将其导入到 packagist.org 网站，并通过 Composer 进行安装（https://getcomposer.org.cn/）。

安装

在您的 composer.json 中需要此扩展包

	"require": {
        /*** Some others packages ***/
		"daawud/sphinxsearch": "dev-master",
	},

在您的控制台运行 composer update 命令以拉取 Sphinx Search 的最新版本。

或者直接在控制台运行以下命令

composer require daawud/sphinxsearch

更新 composer 后，将 ServiceProvider 添加到 config/app.php 中的 "providers" 数组

	'providers' => array(
        /*** Some others providers ***/
        daawud\SphinxSearch\SphinxSearchServiceProvider::class,
    ),

您可以将此行添加到可能使用 SphinxSearch 的文件中

use daawud\SphinxSearch\SphinxSearch;

配置

要使用 Sphinx Search，您需要配置您的索引以及它应该查询的模型。为此，请将配置发布到您的应用程序。

php artisan vendor:publish --provider=daawud\SphinxSearch\SphinxSearchServiceProvider --force

这将创建文件 config/sphinxsearch.php。根据需要修改主机和端口，并配置索引，将其绑定到表和 ID 列。

return array (
	'host'    => '127.0.0.1',
	'port'    => 9312,
	'indexes' => array (
		'my_index_name' => array ( 'table' => 'my_keywords_table', 'column' => 'id' ),
	)
);

或者禁用模型查询，仅获取结果 ID 列表。

return array (
	'host'    => '127.0.0.1',
	'port'    => 9312,
	'indexes' => array (
		'my_index_name' => FALSE,
	)
);

使用方法

基本查询（原始 Sphinx 结果）

$sphinx = new SphinxSearch();
$results = $sphinx->search('my query', 'index_name')->query();

基本查询（使用 Eloquent）

$results = $sphinx->search('my query', 'index_name')->get();

使用限制和过滤器查询另一个 Sphinx 索引。

$results = $sphinx->search('my query', 'index_name')
	->limit(30)
	->filter('attribute', array(1, 2))
	->range('int_attribute', 1, 10)
	->get();

指定匹配和排序类型进行查询。

$result = $sphinx->search('my query', 'index_name')
	->setFieldWeights(
		array(
			'partno'  => 10,
			'name'    => 8,
			'details' => 1
		)
	)
	->setMatchMode(\Sphinx\SphinxClient::SPH_MATCH_EXTENDED)
	->setSortMode(\Sphinx\SphinxClient::SPH_SORT_EXTENDED, "@weight DESC")
	->get(true);  //passing true causes get() to respect returned sort order

许可

Daawud Sphinx Search 是开源软件，许可协议为 MIT 协议