1. 程式人生 > >PHP 操作 Redis 的手冊

PHP 操作 Redis 的手冊

ins true 刪除元素 hello set集合 安全 name 二進制 關聯數組

轉:https://www.cnblogs.com/jackluo/p/5708024.html

String 類型操作

string是redis最基本的類型,而且string類型是二進制安全的。意思是redis的string可以包含任何數據。比如jpg圖片或者序列化的對象

$redis->set(‘key‘,‘TK‘);
$redis->set(‘number‘,‘1‘);
$redis->setex(‘key‘,5,‘TK‘); //設置有效期為5秒的鍵值
$redis->psetex(‘key‘,5000,‘TK‘); //設置有效期為5000毫秒(同5秒)的鍵值
$redis->setnx(‘key‘,‘XK‘); //
若鍵值存在返回false 不存在返回true $redis->delete(‘key‘); 刪除鍵值 可以傳入數組 array(‘key1‘,‘key2‘)刪除多個鍵 $redis->getSet(‘key‘,‘XK‘); //將鍵key的值設置為XK, 並返回這個鍵值原來的值TK $ret = $redis->multi() //批量事務處理,不保證處理數據的原子性 ->set(‘key1‘, ‘val1‘) ->get(‘key1‘) ->setnx(‘key‘, ‘val2‘) ->get(‘key2‘)
->exec(); $redis->watch(‘key‘); // 監控鍵key 是否被其他客戶端修改 如果KEY在調用watch()和exec()之間被修改,exec失敗 function f($redis, $chan, $msg) { //頻道訂閱 switch($chan) { case ‘chan-1‘: echo $msg; break; case ‘chan-2‘: echo $msg;
break; case ‘chan-2‘: echo $msg; break; } } $redis->subscribe(array(‘chan-1‘, ‘chan-2‘, ‘chan-3‘), ‘f‘); // subscribe to 3 chans $redis->publish(‘chan-1‘, ‘hello, world!‘); // send message. $redis->exists(‘key‘); //驗證鍵是否存在,存在返回true $redis->incr(‘number‘); //鍵值加1 $redis->incrby(‘number‘,-10); //鍵值加減10 $redis->incrByFloat(‘number‘, +/- 1.5); //鍵值加減小數 $redis->decr(‘number‘); // 鍵值減1 $redis->decrBy(‘number‘,10); // 鍵值減10 $mget = $redis->mget(array(‘number‘,‘key‘)); // 批量獲取鍵值,返回一個數組 $redis->mset(array(‘key0‘ => ‘value0‘, ‘key1‘ => ‘value1‘)); // 批量設置鍵值 $redis->msetnx(array(‘key0‘ => ‘value0‘, ‘key1‘ => ‘value1‘)); // 批量設置鍵值,類似將setnx()方法批量操作 $redis->append(‘key‘, ‘-Smudge‘); //原鍵值TK,將值追加到鍵值後面,鍵值為TK-Smudge $redis->getRange(‘key‘, 0, 5); // 鍵值截取從0位置開始到5位置結束 $redis->getRange(‘key‘, -6, -1); // 字符串截取從-6(倒數第6位置)開始到-1(倒數第1位置)結束 $redis->setRange(‘key‘, 0, ‘Smudge‘); // 鍵值中替換字符串,0表示從0位置開始 有多少個字符替換多少位置,其中漢字占2個位置 $redis->strlen(‘key‘); //鍵值長度 $redis->getBit(‘key‘); $redis->setBit(‘key‘);

list鏈表操作

$redis->delete(‘list-key‘); // 刪除鏈表
$redis->lPush(‘list-key‘, ‘A‘); //插入鏈表頭部/左側,返回鏈表長度
$redis->rPush(‘list-key‘, ‘B‘); //插入鏈表尾部/右側,返回鏈表長度
$redis->lPushx(‘list-key‘, ‘C‘); 
                 // 插入鏈表頭部/左側,鏈表不存在返回0,存在即插入成功,返回當前鏈表長度
$redis->rPushx(‘list-key‘, ‘C‘); 
                 // 插入鏈表尾部/右側,鏈表不存在返回0,存在即插入成功,返回當前鏈表長度
$redis->lPop(‘list-key‘); //返回LIST頂部(左側)的VALUE ,後入先出(棧)
$redis->rPop(‘list-key‘); //返回LIST尾部(右側)的VALUE ,先入先出(隊列)
$redis->blPop();
$redis->brPop();
$redis->lSize(‘list-key‘); 
                    // 如果是鏈表則返回鏈表長度,空鏈表返回0 
                       若不是鏈表或者不為空,則返回false ,判斷非鏈表 " === false "                          
$redis->lGet(‘list-key‘,-1); // 通過索引獲取鏈表元素 0獲取左側一個  -1獲取最後一個
$redis->lSet(‘list-key‘, 0, ‘X‘); //0位置元素替換為 X
$redis->lRange(‘list-key‘, 0, 3); 
                    //鏈表截取 從0開始 3位置結束 ,結束位置為-1 獲取開始位置之後的全部
$redis->lTrim(‘list-key‘, 0, 1); // 截取鏈表(不可逆) 從0索引開始 1索引結束 
$redis->lRem(‘list-key‘, ‘C‘, 2); //鏈表從左開始刪除元素2個C
$redis->lInsert(‘list-key‘, Redis::BEFORE, ‘C‘, ‘X‘); 
                    // 在C元素前面插入X  , Redis::AfTER(表示後面插入) 
                       鏈表不存在則插入失敗 返回0 若元素不存在返回-1
$redis->rpoplpush(‘list-key‘, ‘list-key2‘); 
                    //從源LIST的最後彈出一個元素
                      並且把這個元素從目標LIST的頂部(左側)壓入目標LIST。 

$redis->brpoplpush();
                    //rpoplpush的阻塞版本,這個版本有第三個參數用於設置阻塞時間
                      即如果源LIST為空,那麽可以阻塞監聽timeout的時間,如果有元素了則執行操作。

Set集合類型

set無序集合 不允許出現重復的元素 服務端可以實現多個 集合操作

$redis->sMembers(‘key‘); //獲取容器key中所有元素
$redis->sAdd(‘key‘ , ‘TK‘);
                 // (從左側插入,最後插入的元素在0位置),集合中已經存在TK 則返回false 
                     不存在添加成功 返回true
$redis->sRem(‘key‘ , ‘TK‘); // 移除容器中的TK
$redis->sMove(‘key‘,‘key1‘,‘TK‘); //將容易key中的元素TK 移動到容器key1  操作成功返回TRUE
$redis->sIsMember(‘key‘,‘TK‘); //檢查VALUE是否是SET容器中的成員
$redis->sCard(‘key‘); //返回SET容器的成員數
$redis->sPop(‘key‘); //隨機返回容器中一個元素,並移除該元素
$redis->sRandMember(‘key‘);//隨機返回容器中一個元素,不移除該元素
$redis->sInter(‘key‘,‘key1‘); 
     // 返回兩個集合的交集 沒有交集返回一個空數組,若參數只有一個集合,則返回集合對應的完整的數組
$redis->sInterStore(‘store‘,‘key‘,‘key1‘); //將集合key和集合key1的交集 存入容器store 成功返回1
$redis->sUnion(‘key‘,‘key1‘); //集合key和集合key1的並集  註意即使多個集合有相同元素 只保留一個

$redis->sUnionStore(‘store‘,‘key‘,‘key1‘); 
            //集合key和集合key1的並集保存在集合store中,  註意即使多個集合有相同元素 只保留一個
$redis->sDiff(‘key‘,‘key1‘,‘key2‘); //返回數組,該數組元素是存在於key集合而不存在於集合key1 key2

Zset數據類型

**(stored set) 和 set 一樣是字符串的集合,不同的是每個元素都會關聯一個 double 類型的 score
redis的list類型其實就是一個每個子元素都是string類型的雙向鏈表。**

$redis->zAdd(‘tkey‘, 1, ‘A‘); 
                           //  插入集合tkey中,A元素關聯一個分數,插入成功返回1
                               同時集合元素不可以重復, 如果元素已經存在返回 0
$redis->zRange(‘tkey‘,0,-1); // 獲取集合元素,從0位置 到 -1 位置
$redis->zRange(‘tkey‘,0,-1, true); 
                    // 獲取集合元素,從0位置 到 -1 位置, 返回一個關聯數組 帶分數 
                      array([A] => 0.01,[B] => 0.02,[D] => 0.03) 其中小數來自zAdd方法第二個參數
$redis->zDelete(‘tkey‘, ‘B‘); // 移除集合tkey中元素B  成功返回1 失敗返回 0
$redis->zRevRange(‘tkey‘, 0, -1); // 獲取集合元素,從0位置 到 -1 位置,數組按照score降序處理

$redis->zRevRange(‘tkey‘, 0, -1,true); 
                // 獲取集合元素,從0位置 到 -1 位置,數組按照score降序處理 返回score關聯數組
$redis->zRangeByScore(‘tkey‘, 0, 0.2,array(‘withscores‘ => true)); 
            //獲取幾個tkey中score在區間[0,0.2]元素 ,score由低到高排序,
                元素具有相同的score,那麽會按照字典順序排列 , withscores 控制返回關聯數組
$redis->zRangeByScore(‘tkey‘, 0.1, 0.36, array(‘withscores‘ => TRUE, ‘limit‘ => array(0, 1)));
             //其中limit中 0和1 表示取符合條件集合中 從0位置開始,向後掃描1個 返回關聯數組
$redis->zCount(‘tkey‘, 2, 10); // 獲取tkey中score在區間[2, 10]元素的個數
$redis->zRemRangeByScore(‘tkey‘, 1, 3); // 移除tkey中score在區間[1, 3](含邊界)的元素
$redis->zRemRangeByRank(‘tkey‘, 0, 1); 
                         //默認元素score是遞增的,移除tkey中元素 從0開始到-1位置結束
$redis->zSize(‘tkey‘);  //返回存儲在key對應的有序集合中的元素的個數
$redis->zScore(‘tkey‘, ‘A‘); // 返回集合tkey中元素A的score值
$redis->zRank(‘tkey‘, ‘A‘); 
                      // 返回集合tkey中元素A的索引值 
                         z集合中元素按照score從低到高進行排列 ,即最低的score index索引為0
$redis->zIncrBy(‘tkey‘, 2.5, ‘A‘); // 將集合tkey中元素A的score值 加 2.5
$redis->zUnion(‘union‘, array(‘tkey‘, ‘tkey1‘)); 
        // 將集合tkey和集合tkey1元素合並於集合union , 並且新集合中元素不能重復
           返回新集合的元素個數, 如果元素A在tkey和tkey1都存在,則合並後的元素A的score相加
$redis->zUnion(‘ko2‘, array(‘k1‘, ‘k2‘), array(5, 2)); 
        // 集合k1和集合k2並集於k02 ,array(5,1)中元素的個數與子集合對應,然後 5 對應k1 
           k1每個元素score都要乘以5 ,同理1對應k2,k2每個元素score乘以1 
           然後元素按照遞增排序,默認相同的元素score(SUM)相加
$redis->zUnion(‘ko2‘, array(‘k1‘, ‘k2‘), array(10, 2),‘MAX‘); 
        // 各個子集乘以因子之後,元素按照遞增排序,相同的元素的score取最大值(MAX)
           也可以設置MIN 取最小值
$redis->zInter(‘ko1‘, array(‘k1‘, ‘k2‘)); 
        // 集合k1和集合k2取交集於k01 ,且按照score值遞增排序
           如果集合元素相同,則新集合中的元素的score值相加
$redis->zInter(‘ko1‘, array(‘k1‘, ‘k2‘), array(5, 1)); 
        //集合k1和集合k2取交集於k01 ,array(5,1)中元素的個數與子集合對應,然後 5 對應k1 
          k1每個元素score都要乘以5 ,同理1對應k2,k2每個元素score乘以1 
          ,然後元素score按照遞增排序,默認相同的元素score(SUM)相加
$redis->zInter(‘ko1‘, array(‘k1‘, ‘k2‘), array(5, 1),‘MAX‘); 
        // 各個子集乘以因子之後,元素score按照遞增排序,相同的元素score取最大值(MAX)
           也可以設置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

PHP 操作 Redis 的手冊