php redis 操做手冊

時間 2019-12-24

標籤 php redis 手冊欄目 PHP 简体版

原文原文鏈接

本篇文章給你們分享的內容是關於php redis 操做手冊，有着必定的參考價值，有須要的朋友能夠參考一下php

String 類型操做

  1 string是redis最基本的類型，並且string類型是二進制安全的。意思是redis的string能夠包含任何數據。
  2 
  3 好比jpg圖片或者序列化的對象
  4 
  5 $redis->set('key','TK');
  6 
  7 $redis->set('number','1');
  8 
  9 $redis->setex('key',5,'TK'); //設置有效期爲5秒的鍵值
 10 
 11 $redis->psetex('key',5000,'TK'); //設置有效期爲5000毫秒(同5秒)的鍵值
 12 
 13 $redis->setnx('key','XK'); //若鍵值存在返回false 不存在返回true
 14 
 15 $redis->delete('key'); 刪除鍵值 能夠傳入數組 array('key1','key2')刪除多個鍵
 16 
 17 $redis->getSet('key','XK'); //將鍵key的值設置爲XK， 並返回這個鍵值原來的值TK
 18 
 19  $ret = $redis->multi()  //批量事務處理,不保證處理數據的原子性
 20 
 21         ->set('key1', 'val1')
 22 
 23         ->get('key1')
 24 
 25         ->setnx('key', 'val2')
 26 
 27         ->get('key2')
 28 
 29         ->exec();
 30 
 31 $redis->watch('key');   // 監控鍵key 是否被其餘客戶端修改
 32 
 33                           若是KEY在調用watch()和exec()之間被修改，exec失敗
 34 
 35 function f($redis, $chan, $msg) {  
 36 
 37 //頻道訂閱    
 38 
 39 switch($chan) {        
 40 
 41 case 'chan-1':            
 42 
 43 echo $msg;            
 44 
 45 break;        
 46 
 47 case 'chan-2':            
 48 
 49 echo $msg;            
 50 
 51 break;        
 52 
 53 case 'chan-2':            
 54 
 55 echo $msg;            
 56 
 57 break;
 58 
 59     }
 60 
 61 }
 62 
 63 $redis->subscribe(
 64 
 65 array('chan-1', 'chan-2', 'chan-3'), 'f'); // subscribe to 3 
 66 
 67 chans$redis->publish('chan-1', 'hello, world!'); // send message.
 68 
 69 $redis->exists('key'); //驗證鍵是否存在，存在返回true
 70 
 71 $redis->incr('number'); //鍵值加1
 72 
 73 $redis->incrby('number',-10); //鍵值加減10
 74 
 75 $redis->incrByFloat('number', +/- 1.5); //鍵值加減少數
 76 
 77 $redis->decr('number'); // 鍵值減1
 78 
 79 $redis->decrBy('number',10); // 鍵值減10
 80 
 81 $mget = $redis->mget(array('number','key')); // 批量獲取鍵值,返回一個數組
 82 
 83 $redis->mset(array('key0' => 'value0', 'key1' => 'value1')); // 批量設置鍵值
 84 
 85 $redis->msetnx(array('key0' => 'value0', 'key1' => 'value1')); 
 86 
 87                                         // 批量設置鍵值，相似將setnx()方法批量操做
 88 
 89 $redis->append('key', '-Smudge'); //原鍵值TK，將值追加到鍵值後面，鍵值爲TK-Smudge
 90 
 91 $redis->getRange('key', 0, 5); // 鍵值截取從0位置開始到5位置結束
 92 
 93 $redis->getRange('key', -6, -1); // 字符串截取從-6(倒數第6位置)開始到-1(倒數第1位置)結束
 94 
 95 $redis->setRange('key', 0, 'Smudge'); 
 96 
 97                                     // 鍵值中替換字符串，0表示從0位置開始
 98 
 99                                        有多少個字符替換多少位置，其中漢字佔2個位置
100 
101 $redis->strlen('key'); //鍵值長度
102 
103 $redis->getBit('key');
104 
105 $redis->setBit('key');

list鏈表操做redis

 1 $redis->delete('list-key'); // 刪除鏈表
 2 
 3 $redis->lPush('list-key', 'A'); //插入鏈表頭部/左側，返回鏈表長度
 4 
 5 $redis->rPush('list-key', 'B'); //插入鏈表尾部/右側，返回鏈表長度
 6 
 7 $redis->lPushx('list-key', 'C'); 
 8 
 9                  // 插入鏈表頭部/左側,鏈表不存在返回0，存在即插入成功，返回當前鏈表長度
10 
11 $redis->rPushx('list-key', 'C'); 
12 
13                  // 插入鏈表尾部/右側,鏈表不存在返回0，存在即插入成功，返回當前鏈表長度
14 
15 $redis->lPop('list-key'); //返回LIST頂部（左側）的VALUE ,後入先出(棧)
16 
17 $redis->rPop('list-key'); //返回LIST尾部（右側）的VALUE ,先入先出（隊列）
18 
19 $redis->blPop();
20 
21 $redis->brPop();
22 
23 $redis->lSize('list-key'); 
24 
25                     // 若是是鏈表則返回鏈表長度，空鏈表返回0 
26 
27                        若不是鏈表或者不爲空，則返回false ,判斷非鏈表 " === false "
28 
29 $redis->lGet('list-key',-1); // 經過索引獲取鏈表元素 0獲取左側一個  -1獲取最後一個
30 
31 $redis->lSet('list-key', 0, 'X'); //0位置元素替換爲 X
32 
33 $redis->lRange('list-key', 0, 3); 
34 
35                     //鏈表截取 從0開始 3位置結束 ，結束位置爲-1 獲取開始位置以後的所有
36 
37 $redis->lTrim('list-key', 0, 1); // 截取鏈表(不可逆) 從0索引開始 1索引結束
38 
39 $redis->lRem('list-key', 'C', 2); //鏈表從左開始刪除元素2個C
40 
41 $redis->lInsert('list-key', Redis::BEFORE, 'C', 'X'); 
42 
43                     // 在C元素前面插入X  , Redis::AfTER(表示後面插入) 
44 
45                        鏈表不存在則插入失敗 返回0 若元素不存在返回-1
46 
47 $redis->rpoplpush('list-key', 'list-key2'); 
48 
49                     //從源LIST的最後彈出一個元素
50 
51                       而且把這個元素從目標LIST的頂部（左側）壓入目標LIST。
52 
53 $redis->brpoplpush();                    //rpoplpush的阻塞版本，這個版本有第三個參數用於設置阻塞時間
54 
55                       即若是源LIST爲空，那麼能夠阻塞監聽timeout的時間，若是有元素了則執行操做。

Set集合類型

 1 set無序集合 不容許出現重複的元素 服務端能夠實現多個 集合操做
 2 
 3 $redis->sMembers('key'); //獲取容器key中全部元素
 4 
 5 $redis->sAdd('key' , 'TK');                 // (從左側插入,最後插入的元素在0位置),集合中已經存在TK 則返回false 
 6 
 7                      不存在添加成功 返回true
 8 
 9 $redis->sRem('key' , 'TK'); // 移除容器中的TK
10 
11 $redis->sMove('key','key1','TK'); //將容易key中的元素TK 移動到容器key1  操做成功返回TRUE
12 
13 $redis->sIsMember('key','TK'); //檢查VALUE是不是SET容器中的成員
14 
15 $redis->sCard('key'); //返回SET容器的成員數
16 
17 $redis->sPop('key'); //隨機返回容器中一個元素，並移除該元素
18 
19 $redis->sRandMember('key');//隨機返回容器中一個元素，不移除該元素
20 
21 $redis->sInter('key','key1'); 
22 
23      // 返回兩個集合的交集 沒有交集返回一個空數組，若參數只有一個集合，則返回集合對應的完整的數組
24 
25 $redis->sInterStore('store','key','key1'); //將集合key和集合key1的交集 存入容器store 成功返回1
26 
27 $redis->sUnion('key','key1'); //集合key和集合key1的並集  注意即便多個集合有相同元素 只保留一個$redis->sUnionStore('store','key','key1'); 
28 
29             //集合key和集合key1的並集保存在集合store中,  注意即便多個集合有相同元素 只保留一個
30 
31 $redis->sDiff('key','key1','key2'); //返回數組，該數組元素是存在於key集合而不存在於集合key1 key2

Zset數據類型數組

 1 **(stored set) 和 set 同樣是字符串的集合，不一樣的是每一個元素都會關聯一個 double 類型的 scoreredis的list類型其實就是一個每一個子元素都是string類型的雙向鏈表。**
 2 
 3 $redis->zAdd('tkey', 1, 'A'); 
 4 
 5                            //  插入集合tkey中，A元素關聯一個分數，插入成功返回1
 6 
 7                                同時集合元素不能夠重複, 若是元素已經存在返回 0
 8 
 9 $redis->zRange('tkey',0,-1); // 獲取集合元素，從0位置 到 -1 位置
10 
11 $redis->zRange('tkey',0,-1, true); 
12 
13                     // 獲取集合元素，從0位置 到 -1 位置, 返回一個關聯數組 帶分數 
14 
15                       array([A] => 0.01,[B] => 0.02,[D] => 0.03) 其中小數來自zAdd方法第二個參數
16 
17 $redis->zDelete('tkey', 'B'); // 移除集合tkey中元素B  成功返回1 失敗返回 0
18 
19 $redis->zRevRange('tkey', 0, -1); // 獲取集合元素，從0位置 到 -1 位置，數組按照score降序處理$redis->zRevRange('tkey', 0, -1,true); 
20 
21                 // 獲取集合元素，從0位置 到 -1 位置，數組按照score降序處理 返回score關聯數組
22 
23 $redis->zRangeByScore('tkey', 0, 0.2,array('withscores' => true)); 
24 
25             //獲取幾個tkey中score在區間[0,0.2]元素 ,score由低到高排序,
26 
27                 元素具備相同的score，那麼會按照字典順序排列 , withscores 控制返回關聯數組
28 
29 $redis->zRangeByScore('tkey', 0.1, 0.36, array('withscores' => TRUE, 'limit' => array(0, 1)));             //其中limit中 0和1 表示取符合條件集合中 從0位置開始，向後掃描1個 返回關聯數組
30 
31 $redis->zCount('tkey', 2, 10); // 獲取tkey中score在區間[2, 10]元素的個數
32 
33 $redis->zRemRangeByScore('tkey', 1, 3); // 移除tkey中score在區間[1, 3](含邊界)的元素
34 
35 $redis->zRemRangeByRank('tkey', 0, 1); 
36 
37                          //默認元素score是遞增的，移除tkey中元素 從0開始到-1位置結束
38 
39 $redis->zSize('tkey');  //返回存儲在key對應的有序集合中的元素的個數
40 
41 $redis->zScore('tkey', 'A'); // 返回集合tkey中元素A的score值
42 
43 $redis->zRank('tkey', 'A'); 
44 
45                       // 返回集合tkey中元素A的索引值 
46 
47                          z集合中元素按照score從低到高進行排列 ，即最低的score index索引爲0
48 
49 $redis->zIncrBy('tkey', 2.5, 'A'); // 將集合tkey中元素A的score值 加 2.5
50 
51 $redis->zUnion('union', array('tkey', 'tkey1')); 
52 
53         // 將集合tkey和集合tkey1元素合併於集合union , 而且新集合中元素不能重複
54 
55            返回新集合的元素個數， 若是元素A在tkey和tkey1都存在，則合併後的元素A的score相加
56 
57 $redis->zUnion('ko2', array('k1', 'k2'), array(5, 2)); 
58 
59         // 集合k1和集合k2並集於k02 ，array(5,1)中元素的個數與子集合對應，而後 5 對應k1 
60 
61            k1每一個元素score都要乘以5 ，同理1對應k2，k2每一個元素score乘以1 
62 
63            而後元素按照遞增排序，默認相同的元素score(SUM)相加
64 
65 $redis->zUnion('ko2', array('k1', 'k2'), array(10, 2),'MAX'); 
66 
67         // 各個子集乘以因子以後，元素按照遞增排序，相同的元素的score取最大值(MAX)
68 
69            也能夠設置MIN 取最小值
70 
71 $redis->zInter('ko1', array('k1', 'k2')); 
72 
73         // 集合k1和集合k2取交集於k01 ，且按照score值遞增排序
74 
75            若是集合元素相同，則新集合中的元素的score值相加
76 
77 $redis->zInter('ko1', array('k1', 'k2'), array(5, 1)); 
78 
79         //集合k1和集合k2取交集於k01 ，array(5,1)中元素的個數與子集合對應，而後 5 對應k1 
80 
81           k1每一個元素score都要乘以5 ，同理1對應k2，k2每一個元素score乘以1 
82 
83           ，而後元素score按照遞增排序，默認相同的元素score(SUM)相加
84 
85 $redis->zInter('ko1', array('k1', 'k2'), array(5, 1),'MAX'); 
86 
87         // 各個子集乘以因子以後，元素score按照遞增排序，相同的元素score取最大值(MAX)
88 
89            也能夠設置MIN 取最小值

Hash數據類型安全

 
  redis hash是一個string類型的field和value的映射表.它的添加，刪除操做都是O(1)（平均）.hash特別適合用於存儲對象。

$redis->hSet('h', 'name', 'TK'); // 在h表中 添加name字段 value爲TK

$redis->hSetNx('h', 'name', 'TK'); // 在h表中 添加name字段 value爲TK 若是字段name的value存在返回false 不然返回 true

$redis->hGet('h', 'name'); // 獲取h表中name字段value

$redis->hLen('h'); // 獲取h表長度即字段的個數

$redis->hDel('h','email'); // 刪除h表中email 字段

$redis->hKeys('h'); // 獲取h表中全部字段

$redis->hVals('h'); // 獲取h表中全部字段value

$redis->hGetAll('h'); // 獲取h表中全部字段和value 返回一個關聯數組(字段爲鍵值)

$redis->hExists('h', 'email'); //判斷email 字段是否存在與表h 不存在返回false

$redis->hSet('h', 'age', 28);

$redis->hIncrBy('h', 'age', -2); 

 // 設置h表中age字段value加(-2) 若是value是個非數值 則返回false 不然，返回操做後的value

$redis->hIncrByFloat('h', 'age', -0.33);  

        // 設置h表中age字段value加(-2.6) 若是value是個非數值 則返回false 不然

           返回操做後的value(小數點保留15位)

$redis->hMset('h', array('score' => '80', 'salary' => 2000)); // 表h 批量設置字段和value

$redis->hMGet('h', array('score','salary')); // 表h 批量獲取字段的value