mochaka/redcard

This package is abandoned and no longer maintained. No replacement package was suggested.

Autocomplete implementation using PHP and Redis

dev-master 2015-06-28 08:16 UTC

Requires

• php: >=5.3.0
• illuminate/support: ~5

Requires (Dev)

• predis/predis: dev-master

MIT

• Rishi Ishairzay
• Luke Nilaratna
• Aaron Florey

• redis
• cache
• search
• autocomplete
• laravel

README

Autocomplete implementation using PHP+Redis.

Inspired by https://github.com/seatgeek/soulmate

This library handles a basic implementation of autocomplete with sorted results (according to "scores") as well as arbitrary metadata for results. Also has the ability to separate different autocomplete databases in to "bins" (e.g. have separate bins "users" and another for "videos" so when querying against "users" it doesn't show results from "videos")

Installation

Add mochaka/redcard as a requirement to composer.json:

{
    "require": {
        "mochaka/redcard": "dev-master"
    }
}

Update your packages with composer update or install with composer install.

Laravel 5 Integration

The RedCard supports Laravel 5 integration. Best practice to use the library in Laravel 5 is to add the ServiceProvider.

Open your Laravel config file config/app.php and add the following lines.

In the $providers array add the service providers for this package.

'providers' => array(

    [...]

    'Mochaka\RedCard\RedCardServiceProvider'
),

Standalone

You will need to create a Predis Client Instance and provide it to the autocomplete class.

    $redis = new Predis\Client(array(
        'scheme' => 'tcp',
        'host'   => 'localhost',
        'port'   => 6379,
    ));

    $autocomplete = new Mochaka\RedCard\RedisAutocomplete( $redis );

    // You are ready to go!

Basic Usage

To store data you must have a unique ID for an item and the phrase that should be searchable.

Laravel

RedCard::store(2, "cat");
RedCard::store(3, "care");
RedCard::store("MYCRAZYID", "caress");
RedCard::store(55, "cars");
RedCard::store(6, "camera");

$results = RedCard::find("car");

var_dump($results)

Standalone

$autocomplete->store(2, "cat");
$autocomplete->store(3, "care");
$autocomplete->store("MYCRAZYID", "caress");
$autocomplete->store(55, "cars");
$autocomplete->store(6, "camera");

$results = $autocomplete->find("car");

var_dump($results)

Bins

Different types of data can be distinguished from one another through bins. Each bin has its own name and when searching and removing they will not conflict with one another.

Laravel

RedCard::store(2, "Mary", "users");
RedCard::store(3, "Sally", "users");
RedCard::store(4, "Leo", "users" );

RedCard::store(5, "Mary Had A Litte Lamb", "blog-title");
RedCard::store(6, "Redis Rocks, A Life Story", "blog-title");

$results = RedCard::find("Mary", "users");

// Will only return Mary instead of "Mary Had A Litte Lamb"

Standalone

$autocomplete->store(2, "Mary", "users");
$autocomplete->store(3, "Sally", "users");
$autocomplete->store(4, "Leo", "users" );

$autocomplete->store(5, "Mary Had A Litte Lamb", "blog-title");
$autocomplete->store(6, "Redis Rocks, A Life Story", "blog-title");

$results = $autocomplete->find("Mary", "users");

// Will only return Mary instead of "Mary Had A Litte Lamb"

Interface

The basic functions that you need to be aware of to utilize RedCard.

• store: store a new item to autocomplete

       store($id, $phrase, $bin = '', $score = 1, $data = NULL)

  example

       RedCard::store('id123', "Clockwork Orange", "Books", 3, array('author'=>'Anthony Burgess'))

• find: find an item. Searches are cached in a seperate hash.

       find($phrase, $bin = '', $count = 10, $isCaching = true)

  example

       RedCard::find("Clock", "Books" , 1, true)

• remove: remove an item from a bin. Searches are cached in a seperate hash.

       remove($id, $bin = '')

  example

       RedCard::remove('id123', 'Books')

License

RedCard Autocomplete is licensed under the MIT License. Original Copyright (c) 2011 Rishi Ishairzay, released under the MIT license