PHPackages palicao/php-rebloom - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Caching](/categories/caching) 4. / 5. palicao/php-rebloom ActiveLibrary[Caching](/categories/caching) palicao/php-rebloom =================== 0.2.1(5y ago)228.7k↓36.7%4[2 issues](https://github.com/palicao/phpRebloom/issues)MITPHPPHP >=7.2.0CI failing Since Dec 11Pushed 5y ago2 watchersCompare [ Source](https://github.com/palicao/phpRebloom)[ Packagist](https://packagist.org/packages/palicao/php-rebloom)[ RSS](/packages/palicao-php-rebloom/feed)WikiDiscussions master Synced 2w ago READMEChangelog (2)Dependencies (2)Versions (6)Used By (0) PhpRebloom ========== [](#phprebloom) Use [Redis Bloom](https://oss.redislabs.com/redisbloom/) with PHP! [![Code Climate maintainability](https://camo.githubusercontent.com/9f1515f3666a62318a068e76b2c6858889f3228e0e869a210f69cf47a12fd641/68747470733a2f2f696d672e736869656c64732e696f2f636f6465636c696d6174652f636f7665726167652d6c65747465722f70616c6963616f2f7068705265626c6f6f6d3f6c6162656c3d6d61696e7461696e6162696c697479266c6f676f3d636f64652d636c696d617465)](https://codeclimate.com/github/palicao/phpRebloom)[![Code Climate coverage](https://camo.githubusercontent.com/1a89116f75d3227007b06d9148f59e02538ccf088393a47b0eeb042239f65709/68747470733a2f2f696d672e736869656c64732e696f2f636f6465636c696d6174652f636f7665726167652f70616c6963616f2f7068705265626c6f6f6d3f6c6f676f3d636f64652d636c696d617465)](https://codeclimate.com/github/palicao/phpRebloom)[![Build Status](https://camo.githubusercontent.com/1b434aa67997b1ebf8979dbb3a931c56107142cb87c3966510ab71a5ac797613/68747470733a2f2f7472617669732d63692e636f6d2f70616c6963616f2f7068705265626c6f6f6d2e7376673f6272616e63683d6d6173746572)](https://travis-ci.com/palicao/phpRebloom)[![Latest Stable Version](https://camo.githubusercontent.com/70c9030793f13af60c4e0831fe4d26735efd37aba3ae9cc5830b1688bebac46e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f70616c6963616f2f7068702d7265626c6f6f6d2e737667)](https://packagist.org/packages/palicao/php-rebloom)[![PHP version](https://camo.githubusercontent.com/ff1906c18de224cb3fb84c95989803cb301b121be9f6933b45e228bd9cc985d9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f70616c6963616f2f7068702d7265626c6f6f6d2f302e312e30)](https://camo.githubusercontent.com/ff1906c18de224cb3fb84c95989803cb301b121be9f6933b45e228bd9cc985d9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f70616c6963616f2f7068702d7265626c6f6f6d2f302e312e30)[![GitHub](https://camo.githubusercontent.com/c76c84e24f9f12535705b4ba3e341231426d8c4cb72353768b596b9d3889b0dd/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f70616c6963616f2f7068705265626c6f6f6d)](https://github.com/palicao/phpRebloom/blob/master/LICENSE) Disclaimer: this is a very lightweight library. For a battery-included experience, please checkout: Install ------- [](#install) `composer require palicao/php-rebloom` Bloom Filter ------------ [](#bloom-filter) A Bloom filter is a space-efficient probabilistic data structure designed to determine whether an element is present in a set. False positives are possible. ``` $bloomFilter = new BloomFilter( new RedisClient( new Redis(), new RedisConnectionParams($host, $port) ) ); ``` ### `reserve` [](#reserve) `BloomFilter::reserve(string $key, float $error, int $capacity): bool` Creates an empty Bloom Filter with a given desired error ratio and initial capacity. See [https://oss.redislabs.com/redisbloom/Bloom\_Commands/#bfreserve](https://oss.redislabs.com/redisbloom/Bloom_Commands/#bfreserve). ### `insert` [](#insert) `BloomFilter::insert(string $key, string $value, ?float $error = null, ?int $capacity = null): bool` Adds an item to the Bloom Filter, creating the filter if it does not yet exist. See [https://oss.redislabs.com/redisbloom/Bloom\_Commands/#bfadd](https://oss.redislabs.com/redisbloom/Bloom_Commands/#bfadd) and [https://oss.redislabs.com/redisbloom/Bloom\_Commands/#bfinsert](https://oss.redislabs.com/redisbloom/Bloom_Commands/#bfinsert). ### `insertMany` [](#insertmany) `BloomFilter::insertMany(string $key, array $values, ?float $error = null, ?int $capacity = null): bool[]` Adds several items to the BloomFilter, creating the filter if it does not yet exist. See [https://oss.redislabs.com/redisbloom/Bloom\_Commands/#bfmadd](https://oss.redislabs.com/redisbloom/Bloom_Commands/#bfmadd) and [https://oss.redislabs.com/redisbloom/Bloom\_Commands/#bfinsert](https://oss.redislabs.com/redisbloom/Bloom_Commands/#bfinsert). ### `insertIfKeyExists` [](#insertifkeyexists) `BloomFilter::insertIfKeyExists(string $key, string $value): bool` Adds an item to the Bloom Filter, only if the filter already exists. See [https://oss.redislabs.com/redisbloom/Bloom\_Commands/#bfadd](https://oss.redislabs.com/redisbloom/Bloom_Commands/#bfadd) and [https://oss.redislabs.com/redisbloom/Bloom\_Commands/#bfinsert](https://oss.redislabs.com/redisbloom/Bloom_Commands/#bfinsert). ### `insertManyIfKeyExists` [](#insertmanyifkeyexists) `BloomFilter::insertManyIfKeyExists(string $key, array $values): bool[]` Adds several items to the Bloom Filter, only if the filter already exists. See [https://oss.redislabs.com/redisbloom/Bloom\_Commands/#bfadd](https://oss.redislabs.com/redisbloom/Bloom_Commands/#bfadd) and [https://oss.redislabs.com/redisbloom/Bloom\_Commands/#bfinsert](https://oss.redislabs.com/redisbloom/Bloom_Commands/#bfinsert). ### `exists` [](#exists) `BloomFilter::exists(string $key, string $value): bool` Checks if an item exists. See [https://oss.redislabs.com/redisbloom/Bloom\_Commands/#bfadd](https://oss.redislabs.com/redisbloom/Bloom_Commands/#bfadd). ### `manyExist` [](#manyexist) `BloomFilter::manyExist(string $key, array $values): bool[]` Checks if many items exist. See [https://oss.redislabs.com/redisbloom/Bloom\_Commands/#bfmexists](https://oss.redislabs.com/redisbloom/Bloom_Commands/#bfmexists). ### `scanDump`, `loadChunks` and `copy` [](#scandump-loadchunks-and-copy) `BloomFilter::scanDump(string $key): array``BloomFilter::loadChunks(string $key, array $chunks): void``BloomFilter::copy(string $sourceKey, string $destKey): void` `scanDump` exports the whole Bloom Filter in an array, which can be loaded in chunks by `loadChunks`. The `copy` function, using the previous 2 functions, allows to quickly copy one Bloom Filter to a different key. See [https://oss.redislabs.com/redisbloom/Bloom\_Commands/#bfscandump](https://oss.redislabs.com/redisbloom/Bloom_Commands/#bfscandump) and [https://oss.redislabs.com/redisbloom/Bloom\_Commands/#bfloadchunk](https://oss.redislabs.com/redisbloom/Bloom_Commands/#bfloadchunk). Cuckoo Filter ------------- [](#cuckoo-filter) Cuckoo filter is similar to Bloom Filter, but it's even more space-efficient and allows deleting items. ``` $cuckooFilter = new CuckooFilter( new RedisClient( new Redis(), new RedisConnectionParams($host, $port) ) ); ``` ### `reserve` [](#reserve-1) `CuckooFilter::reserve(string $key, int $capacity, ?int $bucketSize = null, ?int $maxIterations = null, ?int $expansion = null): bool` Create an empty cuckoo filter with an initial capacity. The false positive rate is fixed at about 3%, depending on how full the filter is. See [https://oss.redislabs.com/redisbloom/Cuckoo\_Commands/#cfreserve](https://oss.redislabs.com/redisbloom/Cuckoo_Commands/#cfreserve). ### `insert` [](#insert-1) `CuckooFilter::insert(string $key, string $value, bool $allowDuplicateValues = true, ?int $capacity = null): bool` Adds an item to the cuckoo filter, creating the filter if it does not exist. See [https://oss.redislabs.com/redisbloom/Cuckoo\_Commands/#cfadd](https://oss.redislabs.com/redisbloom/Cuckoo_Commands/#cfadd), [https://oss.redislabs.com/redisbloom/Cuckoo\_Commands/#cfaddnx](https://oss.redislabs.com/redisbloom/Cuckoo_Commands/#cfaddnx), [https://oss.redislabs.com/redisbloom/Cuckoo\_Commands/#cfinsert](https://oss.redislabs.com/redisbloom/Cuckoo_Commands/#cfinsert), [https://oss.redislabs.com/redisbloom/Cuckoo\_Commands/#cfinsertnx](https://oss.redislabs.com/redisbloom/Cuckoo_Commands/#cfinsertnx). ### `insertMany` [](#insertmany-1) `CuckooFilter::insertMany(string $key, array $values, bool $allowDuplicateValues = true, ?int $capacity = null): bool[]` Similar to the previous, adds many values to the key. See [https://oss.redislabs.com/redisbloom/Cuckoo\_Commands/#cfadd](https://oss.redislabs.com/redisbloom/Cuckoo_Commands/#cfadd), [https://oss.redislabs.com/redisbloom/Cuckoo\_Commands/#cfaddnx](https://oss.redislabs.com/redisbloom/Cuckoo_Commands/#cfaddnx), [https://oss.redislabs.com/redisbloom/Cuckoo\_Commands/#cfinsert](https://oss.redislabs.com/redisbloom/Cuckoo_Commands/#cfinsert), [https://oss.redislabs.com/redisbloom/Cuckoo\_Commands/#cfinsertnx](https://oss.redislabs.com/redisbloom/Cuckoo_Commands/#cfinsertnx). ### `insertIfKeyExists` [](#insertifkeyexists-1) `CuckooFilter::insertIfKeyExists(string $key, string $value, bool $allowDuplicateValues = true, ?int $capacity = null): bool` Inserts an item in a cuckoo filter, only if it exists. See [https://oss.redislabs.com/redisbloom/Cuckoo\_Commands/#cfadd](https://oss.redislabs.com/redisbloom/Cuckoo_Commands/#cfadd), [https://oss.redislabs.com/redisbloom/Cuckoo\_Commands/#cfaddnx](https://oss.redislabs.com/redisbloom/Cuckoo_Commands/#cfaddnx), [https://oss.redislabs.com/redisbloom/Cuckoo\_Commands/#cfinsert](https://oss.redislabs.com/redisbloom/Cuckoo_Commands/#cfinsert), [https://oss.redislabs.com/redisbloom/Cuckoo\_Commands/#cfinsertnx](https://oss.redislabs.com/redisbloom/Cuckoo_Commands/#cfinsertnx). ### `insertManyIfKeyExists` [](#insertmanyifkeyexists-1) `CuckooFilter::insertManyIfKeyExists(string $key, array $values, bool $allowDuplicateValues = true, ?int $capacity = null): bool[]` Inserts many items in a cuckoo filter, only if it exists. See [https://oss.redislabs.com/redisbloom/Cuckoo\_Commands/#cfadd](https://oss.redislabs.com/redisbloom/Cuckoo_Commands/#cfadd), [https://oss.redislabs.com/redisbloom/Cuckoo\_Commands/#cfaddnx](https://oss.redislabs.com/redisbloom/Cuckoo_Commands/#cfaddnx), [https://oss.redislabs.com/redisbloom/Cuckoo\_Commands/#cfinsert](https://oss.redislabs.com/redisbloom/Cuckoo_Commands/#cfinsert), [https://oss.redislabs.com/redisbloom/Cuckoo\_Commands/#cfinsertnx](https://oss.redislabs.com/redisbloom/Cuckoo_Commands/#cfinsertnx). ### `exists` [](#exists-1) `CuckooFilter::exists(string $key, string $value): bool` Returns true if a cuckoo filter exists. See [https://oss.redislabs.com/redisbloom/Cuckoo\_Commands/#cfexists](https://oss.redislabs.com/redisbloom/Cuckoo_Commands/#cfexists). ### `delete` [](#delete) `CuckooFilter::delete(string $key, string $value): bool` Deletes an item once in a filter. See [https://oss.redislabs.com/redisbloom/Cuckoo\_Commands/#cfdel](https://oss.redislabs.com/redisbloom/Cuckoo_Commands/#cfdel). ### `count` [](#count) `CuckooFilter::count(string $key, string $value): int` Returns the number of times an item may be in the filter. See [https://oss.redislabs.com/redisbloom/Cuckoo\_Commands/#cfcount](https://oss.redislabs.com/redisbloom/Cuckoo_Commands/#cfcount). ### `scanDump`, `loadChunks` and `copy` [](#scandump-loadchunks-and-copy-1) `CuckooFilter::scanDump(string $key): array``CuckooFilter::loadChunks(string $key, array $chunks): void``CuckooFilter::copy(string $sourceKey, string $destKey): void` `scanDump` exports the whole Cuckoo Filter in an array, which can be loaded in chunks by `loadChunks`. The `copy` function, using the previous 2 functions, allows to quickly copy one Cuckoo Filter to a different key. CountMinSketch -------------- [](#countminsketch) Count-Min Sketch is a probabilistic data structure that serves as a frequency table of events in a stream of data. ``` $countMinSketch = new CountMinSketch( new RedisClient( new Redis(), new RedisConnectionParams($host, $port) ) ); ``` ### `initByDimensions` [](#initbydimensions) `CountMinSketch::initByDimensions(string $key, int $width, int $depth): bool` Initializes a CountMinSketch named `$key` with the `$width` and `$depth` provided by the user. See [https://oss.redislabs.com/redisbloom/CountMinSketch\_Commands/#cmsinitbydim](https://oss.redislabs.com/redisbloom/CountMinSketch_Commands/#cmsinitbydim). ### `initByProbability` [](#initbyprobability) `CountMinSketch::initByProbability(string $key, float $error, float $probability): bool` Initializes a CountMinSketch to accommodate the desired error rate and probability for inflated count. See [https://oss.redislabs.com/redisbloom/CountMinSketch\_Commands/#cmsinitbyprob](https://oss.redislabs.com/redisbloom/CountMinSketch_Commands/#cmsinitbyprob). ### `incrementBy` [](#incrementby) `CountMinSketch::incrementBy(string $key, Pair ...$pairs): bool` Increments one or more items by a given value in a CountMinSketch. A `Pair` represents an item and the value we want to increment. See [https://oss.redislabs.com/redisbloom/CountMinSketch\_Commands/#cmsincrby](https://oss.redislabs.com/redisbloom/CountMinSketch_Commands/#cmsincrby). ### `query` [](#query) `CountMinSketch::query(string $key, string ... $items): Pair[]` Returns the approximate count for one or more items. See [https://oss.redislabs.com/redisbloom/CountMinSketch\_Commands/#cmsquery](https://oss.redislabs.com/redisbloom/CountMinSketch_Commands/#cmsquery). ### `merge` [](#merge) Merges multiple CountMinSketches into one, so that the value for each item is the sum of the values in each sketch. The `$sourceKeysWeightMap` is an associative array where each key is a sketch, and the value is the weight, that is the value we want each item count to be multiplied by before merging. `CountMinSketch::merge(string $destinationKey, array $sourceKeysWeightMap) : bool` See [https://oss.redislabs.com/redisbloom/CountMinSketch\_Commands/#cmsmerge](https://oss.redislabs.com/redisbloom/CountMinSketch_Commands/#cmsmerge). ### `info` [](#info) Returns an instance of CountMinSketchInfo, which contains information regarding width, depth and total count of the sketch. `CountMinSketch::info(string $key): CountMinSketchInfo` See [https://oss.redislabs.com/redisbloom/CountMinSketch\_Commands/#cmsinfo](https://oss.redislabs.com/redisbloom/CountMinSketch_Commands/#cmsinfo). TopK ---- [](#topk) Similar to CountMinSketch, is based on the algorithm described here: ### `reserve` [](#reserve-2) `TopK::reserve(string $key, int $topK, int $width, int $depth, float $decay): bool` Reserves a TopK suitable to calculate `$topK` top elements, with a given `$width` and `$depth` and with a specified `$decay` (probability of reducing a counter in an occupied bucket). See [https://oss.redislabs.com/redisbloom/TopK\_Commands/#topkreserve](https://oss.redislabs.com/redisbloom/TopK_Commands/#topkreserve). ### `add` [](#add) Adds one or more item to the TooK. If an item enters the Top-K list, the item which is expelled is returned in the position that was occupied by the added item that took its place in the Top-K. `TopK::add(string $key, string ... $items): array` See [https://oss.redislabs.com/redisbloom/TopK\_Commands/#topkadd](https://oss.redislabs.com/redisbloom/TopK_Commands/#topkadd). ### `incrementBy` [](#incrementby-1) Increase the score of an item in the data structure by increment. Similar to `add`, expelled items are returned. `TopK::incrementBy(string $key, Pair ...$pairs): array` See [https://oss.redislabs.com/redisbloom/TopK\_Commands/#topkincrby](https://oss.redislabs.com/redisbloom/TopK_Commands/#topkincrby). ### `query` [](#query-1) Returns subset of $items containing the elements found in the Top-K. `TopK::query(string $key, string ... $items): string[]` See [https://oss.redislabs.com/redisbloom/TopK\_Commands/#topkquery](https://oss.redislabs.com/redisbloom/TopK_Commands/#topkquery). ### `count` [](#count-1) Returns a subset of $items containing the elements found in the top-k with their approximate count. `TopK::count(string $key, string ... $items): Pair[]` See [https://oss.redislabs.com/redisbloom/TopK\_Commands/#topkcount](https://oss.redislabs.com/redisbloom/TopK_Commands/#topkcount). ### `list` [](#list) Returns the top-k items with their relative position. `TopK::list(string $key): Pair[]` See [https://oss.redislabs.com/redisbloom/TopK\_Commands/#topklist](https://oss.redislabs.com/redisbloom/TopK_Commands/#topklist). ### `info` [](#info-1) Returns a TopKInfo object containing information about size, with, depth and decay of the Top-K `TopK::info(string $key): TopKInfo` See [https://oss.redislabs.com/redisbloom/TopK\_Commands/#topkinfo](https://oss.redislabs.com/redisbloom/TopK_Commands/#topkinfo). ### Health Score 30 — LowBetter than 61% of packages Maintenance18 Infrequent updates — may be unmaintained Popularity34 Limited adoption so far Community10 Small or concentrated contributor base Maturity47 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~160 days Total 3 Last Release 2121d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/29f2d2fba3b6f3b89c90f2d222ae67e62663a98b1fb8fd67bbfaa489da21e65e?d=identicon)[palicao](/maintainers/palicao) --- Top Contributors [![palicao](https://avatars.githubusercontent.com/u/659961?v=4)](https://github.com/palicao "palicao (17 commits)") --- Tags bloom-filtercount-min-sketchcuckoo-filterdriverphpphp-redispredisredisredis-servertop-k ### Code Quality TestsPHPUnit Static AnalysisPsalm Type Coverage Yes ### Embed Badge ![Health badge](/badges/palicao-php-rebloom/health.svg) ``` [![Health](https://phpackages.com/badges/palicao-php-rebloom/health.svg)](https://phpackages.com/packages/palicao-php-rebloom) ``` ### Alternatives [iazaran/smart-cache Smart Cache is a caching optimization package designed to enhance the way your Laravel application handles data caching. It intelligently manages large data sets by compressing, chunking, or applying other optimization strategies to keep your application performant and efficient. 21114.2k](/packages/iazaran-smart-cache)[phpfastcache/phpssdb PHP SSDB Driver for phpFastCache 14736.9k1](/packages/phpfastcache-phpssdb)[rapidwebltd/rw-file-cache RW File Cache is a PHP File-based Caching Library. Its syntax is designed to closely resemble the PHP memcache extension. 15196.8k7](/packages/rapidwebltd-rw-file-cache)[yuzuru-s/redis-recommend Wrapping Redis's sorted set APIs for specializing recommending operations. 392.9k](/packages/yuzuru-s-redis-recommend)[ichhabrecht/intcache Turn uncachable page objects into cacheable links 193.9k](/packages/ichhabrecht-intcache) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)