1 /* 添加一个或者多个value到无顺序集合总，如果value已经成set中，则返回false
2 * @param key set名称
3 * @param value
4 * ...
5 * @return int 新set长度
6 */
7 $redis->sAdd('key1' , 'member1'); /* 1, 'key1' => {'member1'} */
8 $redis->sAdd('key1' , 'member2', 'member3'); /* 2, 'key1' => {'member1', 'member2', 'member3'}*/
9 $redis->sAdd('key1' , 'member2'); /* 0, 'key1' => {'member1', 'member2', 'member3'}*/
10
11 /* 返回set的value数量；sSize
12 * @param key set
13 * @return int size
14 */
15 $redis->sAdd('key1' , 'member1');
16 $redis->sAdd('key1' , 'member2');
17 $redis->sAdd('key1' , 'member3'); /* 'key1' => {'member1', 'member2', 'member3'}*/
18 $redis->sCard('key1'); /* 3 */
19 $redis->sCard('keyX'); /* 0 */
20
21 /* 返回n个set的差集
22 * @param key set1
23 * ...
24 * @param key setn
25 * @return array 差集
26 */
27 $redis->delete('s0', 's1', 's2');
28 $redis->sAdd('s0', '1');
29 $redis->sAdd('s0', '2');
30 $redis->sAdd('s0', '3');
31 $redis->sAdd('s0', '4');
32 $redis->sAdd('s1', '1');
33 $redis->sAdd('s2', '3');
34 var_dump($redis->sDiff('s0', 's1', 's2')); // array(0=>'2',1=>'4')
35
36 /* 求差集，并把差集保存在第一个set中
37 * @param key set1
38 * ...
39 * @param key setn
40 * @return int 返回差集元素个数或者false
41 */
42 $redis->delete('s0', 's1', 's2');
43 $redis->sAdd('s0', '1');
44 $redis->sAdd('s0', '2');
45 $redis->sAdd('s0', '3');
46 $redis->sAdd('s0', '4');
47 $redis->sAdd('s1', '1');
48 $redis->sAdd('s2', '3');
49 var_dump($redis->sDiffStore('dst', 's0', 's1', 's2')); //2
50 var_dump($redis->sMembers('dst')); //array(0=>'2',1=>'4')
51
52 /* 求交集，
53 * @param key set1
54 * ...
55 * @param key setn
56 * @return array 差集
57 */
58 $redis->sAdd('key1', 'val1');
59 $redis->sAdd('key1', 'val2');
60 $redis->sAdd('key1', 'val3');
61 $redis->sAdd('key1', 'val4');
62 $redis->sAdd('key2', 'val3');
63 $redis->sAdd('key2', 'val4');
64 $redis->sAdd('key3', 'val3');
65 $redis->sAdd('key3', 'val4');
66 var_dump($redis->sInter('key1', 'key2', 'key3')); //array(0=>'val3',1=>'val4')
67
68 /* 求交集，并把差集保存在第一个set中
69 * @param key set1
70 * ...
71 * @param key setn
72 * @return int 返回交集元素个数或者false
73 */
74 $redis->sAdd('key1', 'val1');
75 $redis->sAdd('key1', 'val2');
76 $redis->sAdd('key1', 'val3');
77 $redis->sAdd('key1', 'val4');
78 $redis->sAdd('key2', 'val3');
79 $redis->sAdd('key2', 'val4');
80 $redis->sAdd('key3', 'val3');
81 $redis->sAdd('key3', 'val4');
82 var_dump($redis->sInterStore('output', 'key1', 'key2', 'key3')); //2
83 var_dump($redis->sMembers('output')); // array(0=>'val3',1=>'val4')
84
85 /* 判断value是否在set里面，别名：sContains
86 * @param key
87 * @param value
88 * @return bool 包含返回true，失败返回false
89 */
90 $redis->sAdd('key1' , 'member1');
91 $redis->sAdd('key1' , 'member2');
92 $redis->sAdd('key1' , 'member3'); /* 'key1' => {'member1', 'member2', 'member3'}*/
93 $redis->sIsMember('key1', 'member1'); /* TRUE */
94 $redis->sIsMember('key1', 'memberX'); /* FALSE */
95
96 /* 返回一个set
97 * @param key set
98 * @param array set_val_array
99 */
100 $redis->delete('s');
101 $redis->sAdd('s', 'a');
102 $redis->sAdd('s', 'b');
103 $redis->sAdd('s', 'a');
104 $redis->sAdd('s', 'c');
105 var_dump($redis->sMembers('s')); //array(0=>'c',1=>'a',3=>'b')
106
107 /* 将set1中元素移动set2中，set1不保留
108 * @param key scrkey
109 * @param key deskey
110 * @param value 元素
111 * @return bool 成功返回true，失败返回false
112 */
113 $redis->sAdd('key1' , 'member11');
114 $redis->sAdd('key1' , 'member12');
115 $redis->sAdd('key1' , 'member13'); /* 'key1' => {'member11', 'member12', 'member13'}*/
116 $redis->sAdd('key2' , 'member21');
117 $redis->sAdd('key2' , 'member22'); /* 'key2' => {'member21', 'member22'}*/
118 $redis->sMove('key1', 'key2', 'member13');
119 /* 'key1' => {'member11', 'member12'} */
120 /* 'key2' => {'member21', 'member22', 'member13'} */
121
122 /* 移除并返回随机一个元素从set中
123 * @param string key
124 * @return bool/string 元素返回值或者false
125 */
126 $redis->sAdd('key1' , 'member1');
127 $redis->sAdd('key1' , 'member2');
128 $redis->sAdd('key1' , 'member3'); /* 'key1' => {'member3', 'member2', 'member1'}*/
129 $redis->sPop('key1'); /* 'member1', 'key1' => {'member3', 'member2'} */
130 $redis->sPop('key1'); /* 'member3', 'key1' => {'member2'} */
131
132 /* 随机返回一个元素，但是不移除该元素
133 * @param key list
134 * @param int(optional)
135 * 如果count是整数且小于元素的个数，返回含有 count
136 * 个不同的元素的数组,如果count是个整数且大于集合中元素的个数时,
137 * 仅返回整个集合的所有元素,当count是负数,
138 * 则会返回一个包含count的绝对值的个数元素的数组，
139 * 如果count的绝对值大于元素的个数,则返回的结果集里会出现一个元素出现多次的情况
140 * @return string/array/false 如果不提供count参数，则返回元素，如果提供count，
141 * 则返回元素数组，如果有误，则返回false
142 */
143 $redis->sAdd('key1' , 'member1');
144 $redis->sAdd('key1' , 'member2');
145 $redis->sAdd('key1' , 'member3'); /* 'key1' => {'member3', 'member1', 'member2'}*/
146 // No count
147 $redis->sRandMember('key1'); /* 'member1', 'key1' => {'member3', 'member1', 'member2'} */
148 $redis->sRandMember('key1'); /* 'member3', 'key1' => {'member3', 'member1', 'member2'} */
149 // With a count
150 $redis->sRandMember('key1', 3); // Will return an array with all members from the set
151 $redis->sRandMember('key1', 2); // Will an array with 2 members of the set
152 $redis->sRandMember('key1', -100); // Will return an array of 100 elements, picked from our set (with dups)
153 $redis->sRandMember('empty-set', 100); // Will return an empty array
154 $redis->sRandMember('not-a-set', 100); // Will return FALSE
155
156 /* 移除set中元素
157 * @param string set
158 * @param string key1 要移除的元素key
159 * @...
160 * @return int 返回移除元素个数
161 */
162 $redis->sAdd('key1' , 'member1');
163 $redis->sAdd('key1' , 'member2');
164 $redis->sAdd('key1' , 'member3'); /* 'key1' => {'member1', 'member2', 'member3'}*/
165 $redis->sRem('key1', 'member2', 'member3'); /*return 2. 'key1' => {'member1'} */
166
167 /* 合并多个set且返回结果
168 * @param string set1
169 * @param ...
170 * @return arrray 合并后结果
171 */
172 $redis->delete('s0', 's1', 's2');
173 $redis->sAdd('s0', '1');
174 $redis->sAdd('s0', '2');
175 $redis->sAdd('s1', '3');
176 $redis->sAdd('s1', '1');
177 $redis->sAdd('s2', '3');
178 $redis->sAdd('s2', '4');
179 var_dump($redis->sUnion('s0', 's1', 's2'));
180
181 /* 参考sUnion函数，却别在意该函数会保存结果
182 * @param string key 保存结果的key
183 * @param string set1
184 * @param ...
185 * @return arrray 合并后结果
186 */
187 $redis->delete('s0', 's1', 's2');
188 $redis->sAdd('s0', '1');
189 $redis->sAdd('s0', '2');
190 $redis->sAdd('s1', '3');
191 $redis->sAdd('s1', '1');
192 $redis->sAdd('s2', '3');
193 $redis->sAdd('s2', '4');
194 var_dump($redis->sUnionStore('dst', 's0', 's1', 's2')); //int(4)
195 var_dump($redis->sMembers('dst')); //array(4) {[0]=>string(1) "3" [1]=>string(1) "4" [2]=>string(1) "1" [3]=>string(1) "2" }
196
197 /* 遍历set集合
198 * @param string 迭代器
199 * @param long(引用)
200 * @param string optional 匹配模式
201 * @param long count
202 * @return array/boolean
203 */
204 $it = NULL;
205 $redis->setOption(Redis::OPT_SCAN, Redis::SCAN_RETRY); /* don't return empty results until we're done */
206 while($arr_mems = $redis->sscan('set', $it, "*pattern*")) {
207 foreach($arr_mems as $str_mem) {
208 echo "Member: $str_mem\n";
209 }
210 }
211
212 $it = NULL;
213 $redis->setOption(Redis::OPT_SCAN, Redis::SCAN_NORETRY); /* return after each iteration, even if empty */
214 while(($arr_mems = $redis->sscan('set', $it, "*pattern*"))!==FALSE) {
215 if(count($arr_mems) > 0) {
216 foreach($arr_mems as $str_mem) {
217 echo "Member found: $str_mem\n";
218 }
219 } else {
220 echo "No members in this iteration, iterator value: $it\n";
221 }
222 }
223
224 /* 添加一个或多个成员到有序集合中，如果存在则更新权重
225 * @param key 集合
226 * @param double score 权重
227 * @param string val 值
228 * @param long 成功返回1，失败返回0
229 */
230 $redis->zAdd('key', 1, 'val1');
231 $redis->zAdd('key', 0, 'val0');
232 $redis->zAdd('key', 5, 'val5');
233 $redis->zRange('key', 0, -1); // array(val0, val1, val5)
234
235 /* 返回有序集合大小
236 * @param key
237 * @return long 大小
238 */
239 $redis->zAdd('key', 0, 'val0');
240 $redis->zAdd('key', 2, 'val2');
241 $redis->zAdd('key', 10, 'val10');
242 $redis->zSize('key'); /* 3 */
243
244 /* 获取指定权重范围的子集中元素个数
245 * @param int start
246 * @param int end
247 * @return long 子集个数
248 */
249 $redis->zAdd('key', 0, 'val0');
250 $redis->zAdd('key', 2, 'val2');
251 $redis->zAdd('key', 10, 'val10');
252 $redis->zCount('key', 0, 3); /* 2, corresponding to array('val0', 'val2') */
253
254 /* 增加一个量给权重
255 * @param string key
256 * @param double value
257 * @param string k-value
258 * @return double 新的权重值
259 */
260 $redis->delete('key');
261 $redis->zIncrBy('key', 2.5, 'member1'); /* key or member1 didn't exist, so member1's score is to 0 before the increment */ /* and now has the value 2.5 */
262 $redis->zIncrBy('key', 1, 'member1'); /* 3.5 */
263
264 /* 对N个zset求并集和交集，并将最后的集合保存在dstkeyN中。
265 * 对于集合中每一个元素的score，在进行AGGREGATE运算前，
266 * 都要乘以对于的WEIGHT参数。
267 * 如果没有提供WEIGHT，默认为1。
268 * 默认的AGGREGATE是SUM，
269 * 即结果集合中元素的score是所有集合对应元素进行SUM运算的值，
270 * 而MIN和MAX是指，结果集合中元素的score是所有集合对应元素中最小值和最大值。
271 * @param string keyOutput 保存结果key
272 * @param array arrayZSetKeys 交集数组key
273 * @param array arrayWeights 权重数组
274 * @param aggregateFunction Either SUM/MIN/MAX
275 * @return long 交集数量
276 */
277 $redis->delete('k1');
278 $redis->delete('k2');
279 $redis->delete('k3');
280 $redis->delete('ko1');
281 $redis->delete('ko2');
282 $redis->delete('ko3');
283 $redis->delete('ko4');
284 $redis->zAdd('k1', 0, 'val0');
285 $redis->zAdd('k1', 1, 'val1');
286 $redis->zAdd('k1', 3, 'val3');
287 $redis->zAdd('k2', 2, 'val1');
288 $redis->zAdd('k2', 3, 'val3');
289 $redis->zInter('ko1', array('k1', 'k2')); /* 2, 'ko1' => array('val1', 'val3') */
290 $redis->zInter('ko2', array('k1', 'k2'), array(1, 1)); /* 2, 'ko2' => array('val1', 'val3') */
291 /* Weighted zInter */
292 $redis->zInter('ko3', array('k1', 'k2'), array(1, 5), 'min'); /* 2, 'ko3' => array('val1', 'val3') */
293 $redis->zInter('ko4', array('k1', 'k2'), array(1, 5), 'max'); /* 2, 'ko4' => array('val3', 'val1') */
294
295 /* 获取指定下标范围的有序集合范围子集
296 * @param string key 集合
297 * @param long start
298 * @param long end
299 * @param withscore:bool=false
300 * @return array 返回子集数组
301 */
302 $redis->zAdd('key1', 0, 'val0');
303 $redis->zAdd('key1', 2, 'val2');
304 $redis->zAdd('key1', 10, 'val10');
305 $redis->zRange('key1', 0, -1); /* array('val0', 'val2', 'val10') */
306 // with scores
307 $redis->zRange('key1', 0, -1, true); /* array('val0' => 0, 'val2' => 2, 'val10' => 10) */
308
309 /* 获取指定范围权重的子集
310 * @param key 有序集合
311 * @param int start
312 * @param int end
313 * @param array withscores => TRUE / limit => array($offset, $count)
314 * @return array 子集
315 */
316 $redis->zAdd('key', 0, 'val0');
317 $redis->zAdd('key', 2, 'val2');
318 $redis->zAdd('key', 10, 'val10');
319 $redis->zRangeByScore('key', 0, 3); /* array('val0', 'val2') */
320 $redis->zRangeByScore('key', 0, 3, array('withscores' => TRUE); /* array('val0' => 0, 'val2' => 2) */
321 $redis->zRangeByScore('key', 0, 3, array('limit' => array(1, 1)); /* array('val2') */
322 $redis->zRangeByScore('key', 0, 3, array('withscores' => TRUE, 'limit' => array(1, 1)); /* array('val2' => 2) */
323
324 /* 获取子集
325 * 不清楚，看例子清楚很多
326 */
327 foreach(Array('a','b','c','d','e','f','g') as $c)
328 $redis->zAdd('key',0,$c);
329 $redis->zRangeByLex('key','-','[c') /* Array('a','b','c'); */
330 $redis->zRangeByLex('key','-','(c') /* Array('a','b') */
331 $redis->zRangeByLex('key','-','[c',1,2) /* Array('b','c') */
332
333 /* 返回key对应的权重
334 * @param key 集合
335 * @param string member key
336 * @return long 元素对应的权重
337 */
338 $redis->zAdd('key', 1, 'one');
339 $redis->zAdd('key', 2, 'two');
340 $redis->zRank('key', 'one'); /* 0 */
341 $redis->zRank('key', 'two'); /* 1 */
342 $redis->zRevRank('key', 'one'); /* 1 */
343 $redis->zRevRank('key', 'two'); /* 0 */
344
345 /* 删除有序集合中元素，别名：zDelete
346 * @param string key 集合
347 * @param string member 元素
348 * @param long 成功返回1，失败返回0
349 */
350 $redis->zAdd('key', 0, 'val0');
351 $redis->zAdd('key', 2, 'val2');
352 $redis->zAdd('key', 10, 'val10');
353 $redis->zDelete('key', 'val2');
354 $redis->zRange('key', 0, -1); /* array('val0', 'val10') */
355
356 /* 移除指定权重范围的元素
357 * @param string key 集合
358 * @param long start 下标开始
359 * @param long end 下标结束
360 * @return long 删除元素个数
361 */
362 $redis->zAdd('key', 10, 'one');
363 $redis->zAdd('key', 20, 'two');
364 $redis->zAdd('key', 30, 'three');
365 $redis->zRemRangeByRank('key', 0, 1); /* 2 */
366 $redis->zRange('key', 0, -1); /* array('three' => 3) */
367
368 /* 移除权重范围内的元素,别名：zDeleteRangeByScore
369 * @param string key 集合
370 * @param double/string start 权重下限
371 * @param double/string end 权重上限
372 * @return long 删除元素个数
373 */
374 $redis->zAdd('key', 0, 'val0');
375 $redis->zAdd('key', 2, 'val2');
376 $redis->zAdd('key', 10, 'val10');
377 $redis->zRemRangeByScore('key', 0, 3); /* 2 */
378
379 /* 倒序集合
380 * @param long start 开始下标
381 * @param long end 结束下标
382 * @param bool=false 是否返回权重
383 * @return array 倒序集合数组
384 */
385 $redis->zAdd('key', 0, 'val0');
386 $redis->zAdd('key', 2, 'val2');
387 $redis->zAdd('key', 10, 'val10');
388 $redis->zRevRange('key', 0, -1); /* array('val10', 'val2', 'val0') */
389 $redis->zRevRange('key', 0, -1, true); /* array('val10' => 10, 'val2' => 2, 'val0' => 0) */
390
391
392 /* 获取元素权重
393 * @param key 集合
394 * @param string member 元素
395 * @return duble 权重
396 */
397 $redis->zAdd('key', 2.5, 'val2');
398 $redis->zScore('key', 'val2'); /* 2.5 */
399
400 /* 求并集，并保存在一个参数
401 * 看例子吧
402 */
403 $redis->delete('k1');
404 $redis->delete('k2');
405 $redis->delete('k3');
406 $redis->delete('ko1');
407 $redis->delete('ko2');
408 $redis->delete('ko3');
409 $redis->zAdd('k1', 0, 'val0');
410 $redis->zAdd('k1', 1, 'val1');
411 $redis->zAdd('k2', 2, 'val2');
412 $redis->zAdd('k2', 3, 'val3');
413 $redis->zUnion('ko1', array('k1', 'k2')); /* 4, 'ko1' => array('val0', 'val1', 'val2', 'val3') */
414 /* Weighted zUnion */
415 $redis->zUnion('ko2', array('k1', 'k2'), array(1, 1)); /* 4, 'ko2' => array('val0', 'val1', 'val2', 'val3') */
416 $redis->zUnion('ko3', array('k1', 'k2'), array(5, 1)); /* 4, 'ko3' => array('val0', 'val2', 'val3', 'val1') */
417
418 /* 遍历set集合
419 *
420 */
421 $it = NULL;
422 $redis->setOption(Redis::OPT_SCAN, Redis::SCAN_RETRY);
423 while($arr_matches = $redis->zscan('zset', $it, '*pattern*')) {
424 foreach($arr_matches as $str_mem => $f_score) {
425 echo "Key: $str_mem, Score: $f_score\n";
426 }
427 }