$redis = new Redis();
se connecter, ouvrir le service Redis du lien
Paramètres
hôte : chaîne, adresse du service
port : int, numéro de port
timeout : float, durée du lien (facultatif, Le la valeur par défaut est 0, aucune limite à la durée du lien)
Remarque : il y a aussi du temps dans redis.conf, la valeur par défaut est 300
pconnect, liens popen qui ne seront pas activement fermés
Référence ci-dessus
setOption définit le mode redis
getOption vérifie le mode défini par redis
ping vérifie l'état de la connexion
get obtient le valeur d'une certaine clé (valeur de chaîne)
Si la clé n'existe pas, return false
set écrit la clé et la valeur (valeur de chaîne)
Si l'écriture est réussi, renvoie ture
setex Écrivez la valeur avec le temps de survie
$redis->setex('key', 3600, 'value'); // sets key → value, with 1h TTL.
setnx Déterminez si elle est répétée, écrivez la valeur
$redis->setnx('key', 'value'); $redis->setnx('key', 'value');
delete Supprime la valeur du spécifié key
Renvoyer la clé supprimée Le numéro (entier long)
$redis->delete('key1', 'key2'); $redis->delete(array('key3', 'key4', 'key5'));
Obtenir le temps de survie d'une clé
persist
Supprimer la clé dont le temps de survie a expiré
Si la clé expire vrai si elle n'expire pas faux
mset (ne peut être utilisé qu'avec Redis version 1.1 ou supérieure)
Attribuez plusieurs clés à la fois en même temps
$redis->mset(array('key0' => 'value0', 'key1' => 'value1'));
multi, exec, throw
Entrer ou quitter le mode transaction
Le paramètre peut être Redis::MULTI ou Redis::PIPELINE. Redis::MULTI
Redis::MULTI : multiple Chaque opération est exécutée comme une transaction
Redis::PIPELINE : permet d'envoyer des commandes d'exécution (multiples) au serveur simplement et plus rapidement, mais sans aucune garantie d'atomicité
rejeter : supprimer Une transaction
renvoie la valeur
multi(), renvoie un objet redis et passe en mode multi-mode une fois entrée. En mode multimode, toutes les méthodes appelées ultérieurement renverront le même objet seulement jusqu'à ce que la méthode exec() soit appelée.
regarder, ne pas regarder (après avoir testé le code, l'effet mentionné ne peut pas être obtenu)
Surveiller si la valeur d'une clé est modifiée par d'autres programmes. Si cette clé est modifiée entre watch et exec (méthode), l'exécution de cette transaction MULTI/EXEC échouera (retour faux)
unwatch annule tous les paramètres de clé
surveillés par ce programme, List d'une paire de clés
$redis->watch('x'); $ret = $redis->multi() ->incr('x') ->exec(); subscribe *
rappel de méthode. Notez que cette méthode peut changer à l'avenir
publier *
Publier le contenu sur une certaine chaîne. Notez que cette méthode peut changer à l'avenir
existe
Déterminez si la clé existe. S'il y a vrai mais pas faux
incr, la valeur dans incrBy
key sera incrémentée de 1. Si le deuxième paramètre est renseigné, il sera incrémenté de la valeur renseignée dans le deuxième paramètre
$redis->incr('key1'); $redis->incrBy('key1', 10);
decr, decrBy
faire la soustraction, la méthode d'utilisation est la même que incr
getMultiple
Passer les paramètres
Tableau composé de clés
Paramètres de retour
Si la clé existe, renvoie la valeur, sinon, retourne faux
$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);
Liste des opérations associées
lPush
$redis->lPush(key, value);
Ajouter un élément avec une valeur à gauche (en tête) de la liste nommé clé
rPush
$redis->rPush(key, value);
Ajouter à droite (queue) de la liste nommée key Un élément de valeur
lPushx/rPushx
$redis->lPushx(key, value);
ajoute un élément de valeur à gauche (tête)/droite (queue) de la liste nommée clé, si valeur déjà Si elle existe, ne pas ajouter
lPop/rPop
$redis->lPop('key');
Sortir le premier élément à gauche (tête)/droite (queue) de la liste clé nommée, supprimez l'élément
blPop/brPop
$redis->blPop('key1', 'key2', 10);
version bloc de la commande lpop. Autrement dit, lorsque le délai d'attente est égal à 0, si la liste nommée key i n'existe pas ou si la liste est vide, la commande se termine. Si timeout>0, lorsque vous rencontrez la situation ci-dessus, attendez les secondes d'expiration. Si le problème n'est pas résolu, effectuez une opération pop sur la liste à partir de keyi 1
lSize
$redis->lSize('key');
Le. return name est Combien d'éléments la liste de clés contient-elle ?
lIndex, lGet
$redis->lGet('key', 0);
renvoie l'élément à la position d'index dans la liste nommée key
lSet
$redis->lSet('key', 0, 'X');
Attribuer la valeur à l'élément à la position d'index dans la liste nommée clé comme valeur
lRange, lGetRange
$redis->lRange('key1', 0, -1);
Renvoyer les éléments entre le début et la fin dans la liste nommée key (end est -1, renvoie tout)
lTrim, listTrim
$redis->lTrim('key', start, end);
Intercepter la liste nommée key, conserver les éléments entre début et fin
lRem, lRemove
$redis->lRem('key', 'A', 2);
Supprime le nombre d'éléments dont la valeur est valeur dans la liste nommée clé. count est 0, supprime tous les éléments avec une valeur, count>0 supprime count les éléments avec une valeur du début à la fin, count<0 supprime |count| éléments avec une valeur de bout en bout
lInsérer
Dans la liste nommée key, recherchez la valeur avec la valeur pivot, et déterminez si la nouvelle valeur est placée avant ou après le pivot selon les paramètres Redis::BEFORE | Si la clé n'existe pas, elle ne sera pas insérée. Si le pivot n'existe pas, 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
Renvoie et supprime l'élément tail de la liste nommé srckey. , et ajoutez l'élément Allez en tête de la liste nommée dstkey
$redis->delete('x', 'y'); $redis->lPush('x', 'abc'); $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" }
Opération SET liée
sAdd
Ajoutez la valeur de l'élément à l'ensemble nommé key If value. existe, pas d'écriture, renvoie false
$redis->sAdd(key , value);
sRem, sRemove
Supprimer la valeur de l'élément
$redis->sAdd('key1' , 'set1'); $redis->sAdd('key1' , 'set2'); $redis->sAdd('key1' , 'set3'); $redis->sRem('key1', 'set2');
sMove
dans l'ensemble nommé key L'élément de valeur est déplacé de la collection nommée srckey vers la collection nommée dstkey
$redis->sMove(seckey, dstkey, value);
sIsMember, sContains
Recherchez s'il existe un élément de valeur dans la collection nommée key. vrai, il n'y a pas de faux
$redis->sIsMember(key, value);
sCard, sSize
返回名称为key的set的元素个数
sPop
随机返回并删除名称为key的set中一个元素
sRandMember
随机返回名称为key的set中一个元素,不删除
sInter
求交集
sInterStore
求交集并将交集保存到output的集合
$redis->sInterStore('output', 'key1', 'key2', 'key3')
sUnion
求并集
$redis->sUnion('s0', 's1', 's2');
s0,s1,s2 同时求并集
sUnionStore
求并集并将并集保存到output的集合
$redis->sUnionStore('output', 'key1', 'key2', 'key3');
sDiff
求差集
sDiffStore
求差集并将差集保存到output的集合
sMembers, sGetMembers
返回名称为key的set的所有元素
sort
排序,分页等
参数
'by' => 'some_pattern_*', 'limit' => array(0, 1), 'get' => 'some_other_pattern_*' or an array of patterns, 'sort' => 'asc' or 'desc', 'alpha' => 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
返回原来key中的值,并将value写入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的长度
$redis->strlen('key');
getBit/setBit
返回2进制信息
zset(sorted set)操作相关
zAdd(key, score, member):向名称为key的zset中添加元素member,score用于排序。如果该元素已经存在,则根据score更新该元素的顺序。
$redis->zAdd('key', 1, 'val1'); $redis->zAdd('key', 0, 'val0'); $redis->zAdd('key', 5, 'val5'); $redis->zRange('key', 0, -1); // array(val0, val1, val5)
zRange(key, start, end,withscores):返回名称为key的zset(元素已按score从小到大排序)中的index从start到end的所有元素
$redis->zAdd('key1', 0, 'val0'); $redis->zAdd('key1', 2, 'val2'); $redis->zAdd('key1', 10, 'val10'); $redis->zRange('key1', 0, -1); // with scores $redis->zRange('key1', 0, -1, true);
zDelete, zRem
zRem(key, member) :删除名称为key的zset中的元素member
$redis->zAdd('key', 0, 'val0'); $redis->zAdd('key', 2, 'val2'); $redis->zAdd('key', 10, 'val10'); $redis->zDelete('key', 'val2'); $redis->zRange('key', 0, -1);
zRevRange(key, start, end,withscores):返回名称为key的zset(元素已按score从大到小排序)中的index从start到end的所有元素.withscores: 是否输出socre的值,默认false,不输出
$redis->zAdd('key', 0, 'val0'); $redis->zAdd('key', 2, 'val2'); $redis->zAdd('key', 10, 'val10'); $redis->zRevRange('key', 0, -1); // with scores $redis->zRevRange('key', 0, -1, true); zRangeByScore, zRevRangeByScore $redis->zRangeByScore(key, star, end, array(withscores, limit ));
返回名称为key的zset中score >= star且score <= end的所有元素
zCount
$redis->zCount(key, star, end);
返回名称为key的zset中score >= star且score <= end的所有元素的个数
zRemRangeByScore, zDeleteRangeByScore $redis->zRemRangeByScore('key', star, end);
删除名称为key的zset中score >= star且score <= end的所有元素,返回删除个数
zSize, zCard
返回名称为key的zset的所有元素的个数
zScore
$redis->zScore(key, val2);
返回名称为key的zset中元素val2的score
zRank, zRevRank
$redis->zRevRank(key, val);
返回名称为key的zset(元素已按score从小到大排序)中val元素的rank(即index,从0开始),若没有val元素,返回“null”。zRevRank 是从大到小排序
zIncrBy
$redis->zIncrBy('key', increment, 'member');
如果在名称为key的zset中已经存在元素member,则该元素的score增加increment;否则向集合中添加该元素,其score的值为increment
zUnion/zInter
参数
keyOutput
arrayZSetKeys
arrayWeights
aggregateFunction Either "SUM", "MIN", or "MAX": defines the behaviour to use on duplicate entries during the zUnion.
对N个zset求并集和交集,并将最后的集合保存在dstkeyN中。对于集合中每一个元素的score,在进行AGGREGATE运算前,都要乘以对于的WEIGHT参数。如果没有提供WEIGHT,默认为1。默认的AGGREGATE是SUM,即结果集合中元素的score是所有集合对应元素进行SUM运算的值,而MIN和MAX是指,结果集合中元素的score是所有集合对应元素中最小值和最大值。
Hash操作
hSet
$redis->hSet('h', 'key1', 'hello');
向名称为h的hash中添加元素key1—>hello
hGet
$redis->hGet('h', 'key1');
返回名称为h的hash中key1对应的value(hello)
hLen
$redis->hLen('h');
返回名称为h的hash中元素个数
hDel
$redis->hDel('h', 'key1');
删除名称为h的hash中键为key1的域
hKeys
$redis->hKeys('h');
返回名称为key的hash中所有键
hVals
$redis->hVals('h')
返回名称为h的hash中所有键对应的value
hGetAll
$redis->hGetAll('h');
返回名称为h的hash中所有的键(field)及其对应的value
hExists
$redis->hExists('h', 'a');
名称为h的hash中是否存在键名字为a的域
hIncrBy
$redis->hIncrBy('h', 'x', 2);
将名称为h的hash中x的value增加2
hMset
$redis->hMset('user:1', array('name' => 'Joe', 'salary' => 2000));
向名称为key的hash中批量添加元素
hMGet
$redis->hmGet('h', array('field1', 'field2'));
返回名称为h的hash中field1,field2对应的value
redis 操作相关
flushDB
清空当前数据库
flushAll
清空所有数据库
randomKey
随机返回key空间的一个key
$key = $redis->randomKey();
select
选择一个数据库
move
转移一个key到另外一个数据库
$redis->select(0); // switch to DB 0 $redis->set('x', '42'); // write 42 to x $redis->move('x', 1); // move to DB 1 $redis->select(1); // switch to DB 1 $redis->get('x'); // will return 42
rename, renameKey
给key重命名
$redis->set('x', '42'); $redis->rename('x', 'y'); $redis->get('y'); // → 42 $redis->get('x'); // → `FALSE`
renameNx
与remane类似,但是,如果重新命名的名字已经存在,不会替换成功
setTimeout, expire
设定一个key的活动时间(s)
$redis->setTimeout('x', 3);
expireAt
key存活到一个unix时间戳时间
$redis->expireAt('x', time() + 3);
keys, getKeys
返回满足给定pattern的所有key
$keyWithUserPrefix = $redis->keys('user*');
dbSize
查看现在数据库有多少key
$count = $redis->dbSize();
auth
密码认证
$redis->auth('foobared');
bgrewriteaof
使用aof来进行数据库持久化
$redis->bgrewriteaof();
slaveof
选择从服务器
$redis->slaveof('10.0.1.7', 6379);
save
将数据同步保存到磁盘
bgsave
将数据异步保存到磁盘
lastSave
返回上次成功将数据保存到磁盘的Unix时戳
info
返回redis的版本信息等详情
type
返回key的类型值
string: Redis::REDIS_STRING set: Redis::REDIS_SET list: Redis::REDIS_LIST zset: Redis::REDIS_ZSET hash: Redis::REDIS_HASH other: Redis::REDIS_NOT_FOUND