README

一个简单的 Laravel 5 包，用于向 Sphinx Search 发起查询。灵感来源于 scalia/sphinxsearch 包的 Laravel 4 版本。

创建此包是为了将其导入到 packagist.org 网站，并通过 Composer（https://composer.php.ac.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 ***/
        Iris\SphinxSearch\SphinxSearchServiceProvider::class,
    ),

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

use Iris\SphinxSearch\SphinxSearch;

配置

要使用 Sphinx Search，您需要配置您的索引和要查询的模型。为此，将配置发布到您的应用中。

php artisan vendor:publish --provider=Iris\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 许可证授权