v0.4.0 2023-07-10 10:05 UTC

This package is auto-updated.

Last update: 2023-12-10 11:03:50 UTC


This is a pure-PHP implementation of libketama, a consistent hashing library.

Compatibility with libketama

PHP Ketama uses the same algorithm as libketama, and will always return the same results as libketama.

The API is not compatible.


Loading a cached continuum file is faster in PHP Ketama. Hashing is slower. As per the included benchmark, this makes PHP Ketama faster than libketama when doing up to 200 hashes per instance.



use Ketama\Ketama;
use Symfony\Component\Cache\Adapter\ApcuAdapter;
use Symfony\Component\Cache\Psr16Cache;

// Cache used to store the parsed continuum file
$cache = new Psr16Cache(new ApcuAdapter('mynamespace')

$ketama = new Ketama($cache);
$continuum = $ketama->createContinuum('/some/file');

// Lookup server
$ip = $continuum->getServer("some key");

Continuum file:

# server    weight
server1 1
server2 3
server3 1
server4 2