PHP-redis命令文檔

字號(hào):


    Redis本質(zhì)上一個(gè)Key/Value數(shù)據(jù)庫(kù),與Memcached類似的NoSQL型數(shù)據(jù)庫(kù),但是他的數(shù)據(jù)可以持久化的保存在磁盤(pán)上,解決了服務(wù)重啟后數(shù)據(jù)不丟失的問(wèn)題,它的值可以是string(字符串)、list(列表)、sets(集合)或者是ordered sets(被排序的集合),所有的數(shù)據(jù)類型都具有push/pop、add/remove、執(zhí)行服務(wù)端的并集、交集、兩個(gè)sets集中的差別等等操作,這些操作都是具有原子性的,Redis還支持各種不同的排序能力
    Redis 2.0更是增加了很多新特性,如:提升了性能、增加了新的數(shù)據(jù)類型、更少的利用內(nèi)存(AOF和VM)
    phpredis是php的一個(gè)擴(kuò)展,效率是相當(dāng)高有鏈表排序功能,對(duì)創(chuàng)建內(nèi)存級(jí)的模塊業(yè)務(wù)關(guān)系
    以下是redis官方提供的命令使用技巧:
    Redis::__construct構(gòu)造函數(shù)
    $redis = new Redis();
    connect, open 鏈接redis服務(wù)
    參數(shù)
    host: string,服務(wù)地址
    port: int,端口號(hào)
    timeout: float,鏈接時(shí)長(zhǎng) (可選, 默認(rèn)為 0 ,不限鏈接時(shí)間)
    注: 在redis.conf中也有時(shí)間,默認(rèn)為300
    ping 查看連接狀態(tài)
    get 得到某個(gè)key的值(string值)
    如果該key不存在,return 特殊值 nil;如果 key 不是字符串類型,那么返回一個(gè)錯(cuò)誤
    set 寫(xiě)入key 和 value(string值)
    在 Redis 2.6.12 版本以前, set命令總是返回 OK 。
    從 Redis 2.6.12 版本開(kāi)始, set 在設(shè)置操作成功完成時(shí),才返回 OK 。
    如果設(shè)置了 NX 或者 XX ,但因?yàn)闂l件沒(méi)達(dá)到而造成設(shè)置操作未執(zhí)行,那么命令返回空批量回復(fù)(NULL Bulk Reply)。
    setex 帶生存時(shí)間的寫(xiě)入值
    將值 value 關(guān)聯(lián)到 key ,并將 key 的生存時(shí)間設(shè)為 seconds (以秒為單位)。
    如果 key 已經(jīng)存在, SETEX 命令將覆寫(xiě)舊值。
    這個(gè)命令類似于以下兩個(gè)命令:
    SET key value
    EXPIRE key seconds # 設(shè)置生存時(shí)間
    不同之處是, SETEX 是一個(gè)原子性(atomic)操作,關(guān)聯(lián)值和設(shè)置生存時(shí)間兩個(gè)動(dòng)作會(huì)在同一時(shí)間內(nèi)完成,
    該命令在 Redis 用作緩存時(shí),非常實(shí)用。
    #粒子
    $redis->setex(‘key’, 3600, ‘value’); // sets key → value, with 1h TTL.
    setnx 判斷是否重復(fù)的,寫(xiě)入值
    #將 key 的值設(shè)為 value ,當(dāng)且僅當(dāng) key 不存在。 若給定的 key 已經(jīng)存在,則 SETNX 不做任何動(dòng)作
    $redis->setnx(‘key’, ‘value’);
    $redis->setnx(‘key’, ‘value’);
    delete 刪除指定key的值
    返回已經(jīng)刪除key的個(gè)數(shù)(長(zhǎng)整數(shù))
    $redis->delete(‘key1′, ‘key2′);
    $redis->delete(array(‘key3′, ‘key4′, ‘key5′));
    ttl
    得到一個(gè)key的生存時(shí)間
    persist
    移除生存時(shí)間到期的key
    如果key到期 true 如果不到期 false
    mset (redis版本1.1以上才可以用)
    同時(shí)給多個(gè)key賦值
    $redis->mset(array(‘key0′ => ‘value0′, ‘key1′ => ‘value1′));
    exists
    判斷key是否存在。存在 true 不在 false
    $redis->exists(‘test’);
    incr, incrBy
    key中的值進(jìn)行自增1,如果填寫(xiě)了第二個(gè)參數(shù),者自增第二個(gè)參數(shù)所填的值
    $redis->incr(‘key1′);
    $redis->incrBy(‘key1′, 10);
    decr, decrBy
    做減法,使用方法同incr
    getMultiple
    傳參
    由key組成的數(shù)組
    返回參數(shù)
    如果key存在返回value,不存在返回false
    $redis->set(‘key1′, ‘value1′);
    $redis->set(‘key2′, ‘value2′);
    $redis->set(‘key3′, ‘value3′);
    $redis->getMultiple(array(‘key1′, ‘key2′, ‘key3′));
    $redis->lRem(‘key1′, ‘A’, 2);
    $redis->lRange(‘key1′, 0, -1);#獲取所有的列表
    list相關(guān)操作
    lPush
    $redis->lPush(key, value);
    在名稱為key的list左邊(頭)添加一個(gè)值為value的 元素
    rPush
    $redis->rPush(key, value);
    在名稱為key的list右邊(尾)添加一個(gè)值為value的 元素
    lPushx/rPushx
    $redis->lPushx(key, value);
    在名稱為key的list左邊(頭)/右邊(尾)添加一個(gè)值為value的元素,如果value已經(jīng)存在,則不添加
    lPop/rPop
    $redis->lPop(‘key’);
    輸出名稱為key的list左(頭)起/右(尾)起的第一個(gè)元素,刪除該元素
    blPop/brPop
    $redis->blPop(‘key1′, ‘key2′, 10);
    lpop命令的block版本。即當(dāng)timeout為0時(shí),若遇到名稱為key i的list不存在或該list為空,則命令結(jié)束。如果timeout>0,則遇到上述情況時(shí),等待timeout秒,如果問(wèn)題沒(méi)有解決,則對(duì)keyi+1開(kāi)始的list執(zhí)行pop操作
    lSize
    $redis->lSize(‘key’);
    返回名稱為key的list有多少個(gè)元素
    lIndex, lGet
    $redis->lGet(‘key’, 0);
    返回名稱為key的list中index位置的元素
    lSet
    $redis->lSet(‘key’, 0, ‘X’);
    給名稱為key的list中index位置的元素賦值為value
    lRange, lGetRange
    $redis->lRange(‘key1′, 0, -1);
    返回名稱為key的list中start至end之間的元素(end為 -1 ,返回所有)
    lTrim, listTrim
    $redis->lTrim(‘key’, start, end);
    截取名稱為key的list,保留start至end之間的元素
    lRem, lRemove
    $redis->lRem(‘key’, ‘A’, 2);
    刪除count個(gè)名稱為key的list中值為value的元素。count為0,刪除所有值為value的元素,count>0從頭至尾刪除count個(gè)值為value的元素,count<0從尾到頭刪除|count|個(gè)值為value的元素
    lInsert
    在名稱為為key的list中,找到值為pivot 的value,并根據(jù)參數(shù)Redis::BEFORE | Redis::AFTER,來(lái)確定,newvalue 是放在 pivot 的前面,或者后面。如果key不存在,不會(huì)插入,如果 pivot不存在,return -1
    $redis->delete(‘key1′); $redis->lInsert(‘key1′, Redis::AFTER, ‘A’, ‘X’); $redis->lPush(‘key1′, ‘A’); $redis->lPush(‘key1′, ‘B’); $redis->lPush(‘key1′, ‘C’); $redis->lInsert(‘key1′, Redis::BEFORE, ‘C’, ‘X’);
    $redis->lRange(‘key1′, 0, -1);
    $redis->lInsert(‘key1′, Redis::AFTER, ‘C’, ‘Y’);
    $redis->lRange(‘key1′, 0, -1);
    $redis->lInsert(‘key1′, Redis::AFTER, ‘W’, ‘value’);
    rpoplpush
    返回并刪除名稱為srckey的list的尾元素,并將該元素添加到名稱為dstkey的list的頭部
    $redis->delete(‘x’, ‘y’);
    $redis->lPush(‘x’, ‘a(chǎn)bc’); $redis->lPush(‘x’, ‘def’); $redis->lPush(‘y’, ’123′); $redis->lPush(‘y’, ’456′); // move the last of x to the front of y. var_dump($redis->rpoplpush(‘x’, ‘y’));
    var_dump($redis->lRange(‘x’, 0, -1));
    var_dump($redis->lRange(‘y’, 0, -1));
    string(3) “abc”
    array(1) { [0]=> string(3) “def” }
    array(3) { [0]=> string(3) “abc” [1]=> string(3) “456″ [2]=> string(3) “123″ }
    SET操作相關(guān)
    sAdd
    向名稱為key的set中添加元素value,如果value存在,不寫(xiě)入,return false
    $redis->sAdd(key , value);
    sRem, sRemove
    刪除名稱為key的set中的元素value
    $redis->sAdd(‘key1′ , ‘set1′);
    $redis->sAdd(‘key1′ , ‘set2′);
    $redis->sAdd(‘key1′ , ‘set3′);
    $redis->sRem(‘key1′, ‘set2′);
    sMove
    將value元素從名稱為srckey的集合移到名稱為dstkey的集合
    $redis->sMove(seckey, dstkey, value);
    sIsMember, sContains
    名稱為key的集合中查找是否有value元素,有ture 沒(méi)有 false
    $redis->sIsMember(key, value);
    sCard, sSize
    返回名稱為key的set的元素個(gè)數(shù)
    sPop
    隨機(jī)返回并刪除名稱為key的set中一個(gè)元素
    sRandMember
    隨機(jī)返回名稱為key的set中一個(gè)元素,不刪除
    sInter
    求交集
    sInterStore
    求交集并將交集保存到output的集合
    $redis->sInterStore(‘output’, ‘key1′, ‘key2′, ‘key3′)
    sUnion
    求并集
    $redis->sUnion(‘s0′, ‘s1′, ‘s2′);
    s0,s1,s2 同時(shí)求并集
    sUnionStore
    求并集并將并集保存到output的集合
    $redis->sUnionStore(‘output’, ‘key1′, ‘key2′, ‘key3′);
    sDiff
    求差集
    sDiffStore
    求差集并將差集保存到output的集合
    sMembers, sGetMembers
    返回名稱為key的set的所有元素
    sort
    排序,分頁(yè)等
    參數(shù)
    ‘by’ => ‘some_pattern_*’,
    ‘limit’ => array(0, 1),
    ‘get’ => ‘some_other_pattern_*’ or an array of patterns,
    ‘sort’ => ‘a(chǎn)sc’ or ‘desc’,
    ‘a(chǎn)lpha’ => TRUE,
    ‘store’ => ‘external-key’
    例子
    $redis->delete(‘s’); $redis->sadd(‘s’, 5); $redis->sadd(‘s’, 4); $redis->sadd(‘s’, 2); $redis->sadd(‘s’, 1); $redis->sadd(‘s’, 3);
    var_dump($redis->sort(‘s’)); // 1,2,3,4,5
    var_dump($redis->sort(‘s’, array(‘sort’ => ‘desc’))); // 5,4,3,2,1
    var_dump($redis->sort(‘s’, array(‘sort’ => ‘desc’, ‘store’ => ‘out’))); // (int)5
    string命令
    getSet
    返回原來(lái)key中的值,并將value寫(xiě)入key
    $redis->set(‘x’, ’42′);
    $exValue = $redis->getSet(‘x’, ‘lol’); // return ’42′, replaces x by ‘lol’
    $newValue = $redis->get(‘x’)’ // return ‘lol’
    append
    string,名稱為key的string的值在后面加上value
    $redis->set(‘key’, ‘value1′);
    $redis->append(‘key’, ‘value2′);
    $redis->get(‘key’);
    getRange (方法不存在)
    返回名稱為key的string中start至end之間的字符
    $redis->set(‘key’, ‘string value’);
    $redis->getRange(‘key’, 0, 5);
    $redis->getRange(‘key’, -5, -1);
    setRange (方法不存在)
    改變key的string中start至end之間的字符為value
    $redis->set(‘key’, ‘Hello world’);
    $redis->setRange(‘key’, 6, “redis”);
    $redis->get(‘key’);
    strlen
    得到key的string的長(zhǎng)度
    $redis->strlen(‘key’);
    getBit/setBit
    返回2進(jìn)制信息