

Searching¶

Simple Text Search¶

Text fields can be filtered with the index's search method.

$result = $bookIndex->search('two cities');

$result->count();     // Number of documents.
$result->documents(); // Array of stdObjects.

Documents can also be returned as arrays instead of objects by passing true as the second parameter to the search method.

$result = $bookIndex->search('two cities', true);

$result->documents(); // Array of arrays.

Filtering¶

Tag Fields¶

Tag fields can be filtered with the index's tagFilter method.

Specifying multiple tags creates a union of documents.

$result = $bookIndex
    ->tagFilter('color', ['blue', 'red'])
    ->search('two cities');

Use multiple separate tagFilter calls to create an intersection of documents.

$result = $bookIndex
    ->tagFilter('color', ['blue'])
    ->tagFilter('color', ['red'])
    ->search('two cities');

Numeric Fields¶

Numeric fields can be filtered with the index's numericFilter method.

$result = $bookIndex
    ->numericFilter('price', 4.99, 19.99)
    ->search('two cities');

Geo Fields¶

Numeric fields can be filtered with the index's geoFilter method.

$result = $bookIndex
    ->geoFilter('place', -77.0366, 38.897, 100)
    ->search('two cities');

Sorting Results¶

Search results can be sorted with the index's sort method.

$result = $bookIndex
    ->sortBy('price')
    ->search('two cities');

Number of Results¶

The number of documents can be retrieved after performing a search.

$result = $bookIndex->search('two cities');

$result->count();     // Number of documents.

Alternatively, the number of documents can be queried without returning the documents themselves. This is useful if you want to check the total number of documents without returning any other data from the Redis server.

$numberOfDocuments = $bookIndex->count('two cities');

Setting a Language¶

A supported language can be specified when running a query. Supported languages are represented as constants in the Ehann\RediSearch\Language class.

$result = $bookIndex
    ->language(Language::ITALIAN)
    ->search('two cities');

Explaining a Query¶

An explanation for a query can be generated with the index's explain method.

This can be helpful for understanding why a query is returning a set of results.

$result = $bookIndex
    ->filter('price', 4.99, 19.99)
    ->sortBy('price')
    ->explain('two cities');

Logging Queries¶

Logging is optional. It can be enabled by injecting a PSR compliant logger, such as Monolog, into a RedisClient instance.

Install Monolog:

composer require monolog/monolog

Inject a logger instance (with a stream handler in this example):

$logger = new Logger('Ehann\RediSearch');
$logger->pushHandler(new StreamHandler('MyLogFile.log', Logger::DEBUG));
$this->redisClient->setLogger($logger);