juklicek/flexihash

Flexihash is a small PHP library which implements consistent hashing.

Maintainers

Details

github.com/juklicek/flexihash

Homepage

Source

Installs: 1

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 0

Forks: 84

pkg:composer/juklicek/flexihash

dev-master 2022-04-27 09:23 UTC

Requires

  • php: >=5.2.0

MIT 356690cde3e89970453563891c54ce9a61efd244

This package is not auto-updated.

Last update: 2025-10-23 23:59:06 UTC

README

Flexihash is a small PHP library which implements [http://en.wikipedia.org/wiki/Consistent_hashing consistent hashing], which is most useful in distributed caching. It requires PHP5 and uses [http://simpletest.org/ SimpleTest] for unit testing.

Usage Example

<?php

$hash = new Flexihash();

// bulk add
$hash->addTargets(array('cache-1', 'cache-2', 'cache-3'));

// simple lookup
$hash->lookup('object-a'); // "cache-1"
$hash->lookup('object-b'); // "cache-2"

// add and remove
$hash
  ->addTarget('cache-4')
  ->removeTarget('cache-1');

// lookup with next-best fallback (for redundant writes)
$hash->lookupList('object', 2); // ["cache-2", "cache-4"]

// remove cache-2, expect object to hash to cache-4
$hash->removeTarget('cache-2');
$hash->lookup('object'); // "cache-4"

Further Reading