PHP-Redis擴展使用手冊（二）

時間 2019-11-16
原文原文鏈接
  1 /* 根據多個key獲取多個value，不存在的key返回false    getMultiple是別名？
  2      * @param array 包含key的數組
  3      * @return array 返回key對應value的數組
  4      */
  5     $redis->set('key1', 'value1');
  6     $redis->set('key2', 'value2');
  7     $redis->set('key3', 'value3');
  8     $redis->mGet(array('key1', 'key2', 'key3')); // array('value1', 'value2', 'value3')
  9     $redis->mGet(array('key0', 'key1', 'key5')); // array(`FALSE`, 'value2', `FALSE`);
 10     
 11     /* 設置key的value，並返回舊的value
 12      * @param key 
 13      * @return string value 舊的value
 14      */
 15     $redis->set('x', '42');
 16     $exValue = $redis->getSet('x', 'lol');  // return '42', replaces x by 'lol'
 17     $newValue = $redis->get('x');              // return 'lol'
 18     
 19     /* 返回一個隨機的key
 20      * @return string key
 21      */
 22     $key = $redis->randomKey();
 23     $surprise = $redis->get($key);  // who knows what's in there.
 24     
 25     /* 將一個key移到不一樣的數據庫中
 26      * @param key 要移動的key
 27      * @param int 數據庫索引
 28      * @return bool 成功返回true，失敗返回false
 29      */
 30     $redis->select(0);      // switch to DB 0
 31     $redis->set('x', '42'); // write 42 to x
 32     $redis->move('x', 1);   // move to DB 1
 33     $redis->select(1);      // switch to DB 1
 34     $redis->get('x');       // will return 42
 35     
 36     /* 從新命名一個key    別名：renameKey
 37      * @param string srckey 舊key名稱
 38      * @param string dstkey 新key名稱
 39      * @return bool 成功返回true，失敗返回false
 40      */
 41     $redis->set('x', '42');
 42     $redis->rename('x', 'y');
 43     $redis->get('y');   // → 42
 44     $redis->get('x');   // → `FALSE`
 45     
 46     /* 從新命名一個key,若是新key已存在，則不替換
 47      * @param string srckey 舊key名稱
 48      * @param string dstkey 新key名稱
 49      * @return bool 成功返回true，失敗返回false
 50      */
 51     $redis->set('x', '42');
 52     $redis->set('y', '43');
 53     $redis->renameNx('x', 'y');    //替換失敗，y已存在，返回false
 54     
 55     /* 設置生存時間，別名：setTimeout, pexpire
 56      * @param key 
 57      * @param int ttl 單位是秒
 58      * @return bool 成功返回true，失敗返回false
 59      */
 60     $redis->set('x', '42');
 61     $redis->setTimeout('x', 3);     // x will disappear in 3 seconds.
 62     sleep(5);                       // wait 5 seconds
 63     $redis->get('x');               // will return `FALSE`, as 'x' has expired.
 64     
 65     /* 設置生存時間，別名：pexpireAt
 66      * @param string key
 67      * @param int timestamp 時間戳，超過該時間key戳無效
 68      * @return bool 成功返回true，失敗返回false
 69      */
 70     $redis->set('x', '42');
 71     $now = time(NULL); // current timestamp
 72     $redis->expireAt('x', $now + 3);    // x will disappear in 3 seconds.
 73     sleep(5);               // wait 5 seconds
 74     $redis->get('x');       // will return `FALSE`, as 'x' has expired.
 75     
 76     /* 返回和模式匹配成功的全部key 別名：getKeys
 77      * @param string 模式 
 78      * @return array/string 單個值或數組
 79      */
 80     $allKeys = $redis->keys('*');   // all keys will match this.
 81     $keyWithUserPrefix = $redis->keys('user*');
 82     
 83     /* 充key空間中搜索key
 84      * 不是很懂$it的做用 
 85      */
 86     $it = NULL; /* Initialize our iterator to NULL */
 87     $redis->setOption(Redis::OPT_SCAN, Redis::SCAN_RETRY); /* retry when we get no keys back */
 88     while($arr_keys = $redis->scan($it)) {
 89         foreach($arr_keys as $str_key) {
 90             echo "Here is a key: $str_key\n";
 91         }
 92         echo "No more keys to scan!\n";
 93     }
 94     
 95     /* 根據參數，查看相應key的信息
 96      * @param string 「encoding」返回給定 key 鎖儲存的值所使用的內部表示(representation)；「refcount」返回給定 key 引用所儲存的值的次數（此命令主要用於除錯）；「idletime」返回給定 key 自儲存以來的空閒時間(idle， 沒有被讀取也沒有被寫入)，以秒爲單位
 97      * @return 「encoding」返回string，「refcount、idletime」返回long
 98      */
 99     $redis->object("encoding", "l"); // → ziplist
100     $redis->object("refcount", "l"); // → 1
101     $redis->object("idletime", "l"); // → 400 (in seconds, with a precision of 10 seconds)
102     
103     /* 返回key指向的value的類型
104      * @param key key
105      * @return string: Redis::REDIS_STRING(1)、set: Redis::REDIS_SET(2)、list: Redis::REDIS_LIST(3)、zset: Redis::REDIS_ZSET(4)、hash: Redis::REDIS_HASH(5)、other: Redis::REDIS_NOT_FOUND(0)
106      */
107      
108     $redis->sadd('key_1','value_1');
109     $redis->sadd('key_1','value_2');
110     echo $redis->type('key_1');        // echo 2
111     
112     /* 追加字符串到指定key的value中去
113      * @param key 
114      * @param value 
115      * @return int 追加以後的value長度
116      */
117     $redis->set('key', 'value1');
118     $redis->append('key', 'value2'); /* 12 */
119     $redis->get('key'); /* 'value1value2' */
120     
121     /* 獲取key指向value的子字符串
122      * @param key 
123      * @param int start 開始下標
124      * @param int end 結束下標
125      * @return string 子字符串
126      */
127     $redis->set('key', 'string value');
128     $redis->getRange('key', 0, 5); /* 'string' */
129     $redis->getRange('key', -5, -1); /* 'value' */
130     
131     /* 改變key指向value的子字符串
132      * @param key 
133      * @param offset 偏移量
134      * @param value 值 
135      * @return int 返回修改後字符串的長度
136      */
137     $redis->set('key', 'Hello world');
138     $redis->setRange('key', 6, "redis"); /* returns 11 */
139     $redis->get('key'); /* "Hello redis" */
140     
141     /* 返回value的長度
142      * @param key
143      * @return int 返回字符串長度
144      */
145     $redis->set('key', 'value');
146     $redis->strlen('key'); /* 5 */
147     
148     /* 從key指向的value中獲取指定位置的bit值
149      * @param key 
150      * @param offset 偏移量
151      * @return long 0/1 
152      */
153     $redis->set('key', "\x7f"); // this is 0111 1111
154     $redis->getBit('key', 0); /* 0 */
155     $redis->getBit('key', 1); /* 1 */
156     
157     /* 改變字符串指向value的指定位置的bit
158      * @param key 
159      * @param offset 偏移量
160      * @param int value 0/1 
161      * @return long 0/1 返回改變以前該位置的bit
162      */
163     $redis->set('key', "*");    // ord("*") = 42 = 0x2f = "0010 1010"
164     $redis->setBit('key', 5, 1); /* returns 0 */
165     $redis->setBit('key', 7, 1); /* returns 0 */
166     $redis->get('key'); /* chr(0x2f) = "/" = b("0010 1111") */
167     
168     /* 根據對應的操做對多個位進行運算
169      * @param operation 「AND」、「OR」、「NOT」、「XOR」
170      * @param ret_key 返回結果
171      * @param key1 
172      * @param key2 
173      * @param ...
174      * @return long 返回結果key的長度
175      */
176     $key1 = '0';
177     $redis->setbit($key1,1,1);
178     $redis->expire($key1,1000);
179     
180     $key2 = '1';
181     $redis->setbit($key2,2,1);
182     $redis->expire($key2,1000);
183     
184     $redis->bitop('OR','t_key',$key1,$key2);
185     $redis->get('t_key');    //echo $key1 OR $key2
186 
187     
188     /* 統計字符串bit的數量
189      * @param key 
190      * @return long value 返回
191      */
192     $redis->set('key2','2');
193     $redis->bitcount('key2');    //echo 3 '2'的ascii爲51，二進制位110100，3個11
194     $redis->set('key1','3');
195     $redis->bitcount('key1');    //echo 4 '3'的ascii爲51，二進制位110011，4個11
196     
197     /* 根據給的參數，進行排序
198      * @param array 
199      *    'by' => 'some_pattern_*',                經過該字段排序，user_level_* 是一個佔位符， 它先取出 uid 中的值， 而後再用這個值來查找相應的鍵
200      *    'limit' => array(offset, count),        分頁
201      *    'get' => 'some_other_pattern_*' or an array of patterns,     鏈接更多的key-valuve
202      *    'sort' => 'asc' or 'desc',                降序或者升序
203      *    'alpha' => TRUE,                        sort默認排序對象爲數字，當須要對字符串進行排序時將改參數設置爲true    
204      *    'store' => 'external-key'                將排序結果保存到該key上        
205      * @return value 返回一個數組
206      */
207     $redis->LPUSH('user_id', 1);//(integer) 1
208     $redis->SET('user_name_1', 'admin');
209     $redis->SET('user_level_1',9999);
210 
211     $redis->LPUSH('user_id', 2);//(integer) 2
212     $redis->SET('user_name_2', 'huangz');
213     $redis->SET('user_level_2', 10);
214 
215     $redis->LPUSH('user_id', 59230);//(integer) 3
216     $redis->SET('user_name_59230','jack');
217     $redis->SET('user_level_59230', 3);
218 
219     $redis->LPUSH('user_id', 222);  //(integer) 4
220     $redis->SET('user_name_222', 'hacker');
221     $redis->SET('user_level_222', 9999);
222     
223     $redis->SET('user_password_222', "hey,im in");
224     $redis->SET('user_password_1', "a_long_long_password");
225     $redis->SET('user_password_2', "nobodyknows");
226     $redis->SET('user_password_59230', "jack201022");
227     
228     print_r($redis->sort('user_id'));    //Array ( [0] => 1 [1] => 2 [2] => 222 [3] => 59230 ) 
229     
230     $redis->sort('user_id',array('store'=>'store_key'));    
231     print_r($redis->LRANGE('store_key',0,4));    //Array ( [0] => 1 [1] => 2 [2] => 222 [3] => 59230 ) 
232     
233     print_r($redis->SORT('user_id',array('BY'=>'user_level_*', 'SORT'=>'DESC' ))); //Array ( [0] => 222 [1] => 1 [2] => 2 [3] => 59230 ) 
234     
235     print_r($redis->sort('user_id',array('limit'=>array(1,2))));    //Array ( [0] => 2 [1] => 222 ) 
236     
237     print_r($redis->SORT('user_id',array( 'BY'=>'user_id*', 'SORT'=>'asc', 'GET'=>array('user_name_*','user_password_*') )));//Array ( [0] => admin [1] => a_long_long_password [2] => huangz [3] => nobodyknows [4] => hacker [5] => hey,im in [6] => jack [7] => jack201022 )
238 
239     /* 返回給的的key的生存時間
240      * @param key 
241      * @return long 返回時間，單位爲秒
242      */
243     $redis->set('key_1','value_1');
244     $redis->expire('key_1',100);
245     $redis->ttl('key_1');    //100
246     
247     /* 返回給的的key的生存時間
248      * @param key 
249      * @return long 返回時間，單位爲毫秒
250      */
251     $redis->set('key_1','value_1');
252     $redis->pexpire('key_1',100);
253     $redis->pttl('key_1');    //100
254     
255     /* 移除有效時間ttl
256      * @param key 
257      * @return bool 成功返回true，失敗返回false
258      */
259     $redis->set('key_1','value_1');
260     $redis->pexpire('key_1',100);
261     $redis->pttl('key_1');    //100
262     $redis->persist('key_1');
263     $redis->pttl('key_1');    //-1
264     
265     /* 插入多個鍵值對key-value 
266      * @param array key-value 
267      * @return bool 成功返回true，失敗返回false
268      */
269     $redis->mset(array('key0' => 'value0', 'key1' => 'value1'));
270     $redis->get('key0');    //value0
271     $redis->get('key1');    //value1
272     
273     /* 插入多個鍵值對key-value,若是key存在則不插入
274      * @param array key-value 
275      * @return bool 成功返回true，失敗返回false
276      */
277     $redis->msetnx(array('key0' => 'value0', 'key2' => 'value2'));    //若是有key存在，則直接返回false不操做
278     $redis->get('key0');    //value0
279     $redis->get('key2');    //value2