Scorpio SphinxSearch Bundle for Symfony

Dave Redfern

Published: 02 Sep 02:55 in Deprecated

Scorpio SphinxSearch Bundle

The Sphinx extension is deprecated and officially unsupported. This package has been updated, but is now deprecated. Please see: https://github.com/FoolCode/SphinxQL-Query-Builder for an alternative. This package should still function provided an instance implementing the SphinxClient is used e.g.: https://github.com/nilportugues/php-sphinx-search.

SphinxSearchBundle adds configuration and service support to Scorpio SphinxSearch, making it easier to use in a Symfony project.

Requirements

  • Symfony 2.3+
  • Scorpio SphinxSearch
  • for composer installs, PHP Sphinx extension

Installation

  1. The preferred method is to install via composer:

    composer require scorpio/sphinx-search-bundle "0.1.*"

  2. Enable the bundle in your AppKernel:

    // app/AppKernel.php
    
    public function registerBundles()
    {
        $bundles = array(
            // ...
            new Scorpio\SphinxSearchBundle\ScorpioSphinxSearchBundle(),
            // ...
        );
    }
    
  3. Set the configuration parameters in your config.yml

  4. Map some indexes (see later)

Basic Usage

This bundle exposes the following configuration:

scorpio_sphinx_search:
    host: localhost
    port: 9312
    max_query_time: 3000 # max query execution time

Optionally a specific SphinxClient class can be specified to handle the connections. This can be used if the PHP extension is not available and the SphinxQL library cannot be used.

scorpio_sphinx_search:
    client_class: SomeClass\That\Implements\SphinxClientAPI

The following services are automatically registered:

  • scorpio_sphinx_search.server.settings (private)
  • scorpio_sphinx_search.search_manager (main search manager instance)

Indexes can be configured as services:

services:
    my_custom_sphinx_index:
        class: Scorpio\SphinxSearch\SearchIndex
        arguments:
           - 'my_custom_sphinx_index'
           - [ 'available', 'fields', 'as_an_array' ]
           - [ 'attribute1', 'attribute2' ]

Note: the index name and fields are required and must match what is exposed in the Sphinx configuration.

Additionally the result set and result record class can also be specified:

services:
    my_custom_sphinx_index:
        class: Scorpio\SphinxSearch\SearchIndex
        arguments:
           - 'my_custom_sphinx_index'
           - [ 'available', 'fields', 'as_an_array' ]
           - [ 'attribute1', 'attribute2' ]
           - 'MyResultSet'
           - 'MyCustomResult'

Finally, for the really lazy!, the index definition can be tagged with the custom attribute "query" set to true:

services:
    my_custom_sphinx_index:
        tags:
            - { name: scorpio_sphinx_search.index, query: true }

And a custom query service will be automatically registered in the container. The prefix can be customised in your parameters.yml, the default if not set is "query", so the previous tag would create the service: "query.my_custom_sphinx_index".

Note: the attribute "query" must be set to true, otherwise the index will be ignored. This allows the services to be tagged and locatable for debugging but not auto-create a query service when not needed.

In your controller you can then access the query instance:

class MyController extends Controller
{

    function indexAction(Request $request)
    {
        // bind a search term somehow, apply filters etc. maybe check for keywords...
        $query = $this
            ->get('query.my_custom_sphinx_index')
            ->setQuery($request->query->get('keywords'));

        $results = $this->get('scorpio_sphinx_search.search_manager')->query($query);

        // do something with the results.
    }
}

License

This bundle is licensed under the BSD license. See the complete license in the bundle LICENSE file.

Issues or feature requests

Issues and feature requests should be made on the Github repository page.

Return to article