README

这是一个简单的 Laravel 5–8 包，用于向 Sphinx Search 发送查询。它从 sngrl/sphinxsearch 包 fork 出来，为 Laravel 5 设计。受到 scalia/sphinxsearch 包（为 Laravel 4 设计）的启发。

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

安装

在 composer.json 中要求此包

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

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

或者直接在控制台运行这个命令

composer require igor-tv/sphinxsearch:dev-master

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

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

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

use sngrl\SphinxSearch\SphinxSearch;

配置

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

php artisan vendor:publish --provider=sngrl\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

许可证

Sngrl Sphinx Search 是开源软件，采用 MIT 许可证