README

一个简单的 Laravel 5 包，用于执行对 Sphinx Search 的查询。灵感来自 scalia/sphinxsearch 包的 Laravel 4 版本。

创建此包是为了将其导入到 site packagist.org 并允许通过 Composer 进行安装（https://getcomposer.org.cn/）。

安装

在您的 composer.json 中要求此包

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

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

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

composer require sngrl/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 许可证