(PECL memcached >= 0.1.0)
Memcached::set — Stocke un élément
Memcached::set() stocke la valeur value
sur une serveur memcache, avec la clé d'identification key.
Le paramètre expiration permet de contrôler le délai d'expiration
automatique de la valeur.
La valeur peut être n'importe quelle type de valeur PHP, hormis une ressource, car elles
ne peuvent pas être représentée sous forme linéaire. Si l'option
Memcached::OPT_COMPRESSION est activée, la valeur sérialisée sera
aussi compressée avant stockage.
keyLa clé avec laquelle stocker la valeur.
valueLa valeur à stocker.
expirationLe délai d'expiration, par défaut à zéro. Voyez délais d'expiration pour plus d'informations.
Cette fonction retourne true en cas de succès ou false si une erreur survient.
Utilisez Memcached::getResultCode()
si nécessaire.
Exemple #1 Exemple avec Memcached::set()
<?php
$m = new Memcached();
$m->addServer('localhost', 11211);
$m->set('int', 99);
$m->set('string', 'a simple string');
$m->set('array', array(11, 12));
/* L''object' va etre détruit dans 5 minutes */
$m->set('object', new stdClass, time() + 300);
var_dump($m->get('int'));
var_dump($m->get('string'));
var_dump($m->get('array'));
var_dump($m->get('object'));
?>Résultat de l'exemple ci-dessus est similaire à :
int(99)
string(15) "a simple string"
array(2) {
[0]=>
int(11)
[1]=>
int(12)
}
object(stdClass)#1 (0) {
}
@PeterNYou said that this was wrong:$m->set('object', new stdclass, time() + 300);And instead this is the correct way:$m->set('object', new stdclass, 300);When actually, they are both correct. Expiration looks at the time given, if the number is less than or equal to 30 days(60 * 60 * 24 * 30 = 2,592,000), then it expires in that many seconds. If the number is greater than 30 days, then it expires at that UNIX time.Unlike Memcache, Memcached will not replace spaces in keys with underscores for you, and will instead send the key as provided which will cause an error that can result in keys and values being mismatched. You can avoid this problem by removing/replacing spaces before storage or setting the option Memcached::OPT_BINARY_PROTOCOL to true.In the example it shows:/* expire 'object' key in 5 minutes */$m->set('object', new stdclass, time() + 300);But this is wrong.It will not expire, at least, not for a long long time.So instead of time() + seconds, you use:$m->set('object', new stdclass, 300);And it will correctly expire after 5 minutes.Note: Using memcached 2.1.0 stable through PECL.00 = MEMCACHED_SUCCESS01 = MEMCACHED_FAILURE02 = MEMCACHED_HOST_LOOKUP_FAILURE // getaddrinfo() and getnameinfo() only03 = MEMCACHED_CONNECTION_FAILURE04 = MEMCACHED_CONNECTION_BIND_FAILURE // DEPRECATED see MEMCACHED_HOST_LOOKUP_FAILURE05 = MEMCACHED_WRITE_FAILURE06 = MEMCACHED_READ_FAILURE07 = MEMCACHED_UNKNOWN_READ_FAILURE08 = MEMCACHED_PROTOCOL_ERROR09 = MEMCACHED_CLIENT_ERROR10 = MEMCACHED_SERVER_ERROR // Server returns "SERVER_ERROR"11 = MEMCACHED_ERROR // Server returns "ERROR"12 = MEMCACHED_DATA_EXISTS13 = MEMCACHED_DATA_DOES_NOT_EXIST14 = MEMCACHED_NOTSTORED15 = MEMCACHED_STORED16 = MEMCACHED_NOTFOUND17 = MEMCACHED_MEMORY_ALLOCATION_FAILURE18 = MEMCACHED_PARTIAL_READ19 = MEMCACHED_SOME_ERRORS20 = MEMCACHED_NO_SERVERS21 = MEMCACHED_END22 = MEMCACHED_DELETED23 = MEMCACHED_VALUE24 = MEMCACHED_STAT25 = MEMCACHED_ITEM26 = MEMCACHED_ERRNO27 = MEMCACHED_FAIL_UNIX_SOCKET // DEPRECATED28 = MEMCACHED_NOT_SUPPORTED29 = MEMCACHED_NO_KEY_PROVIDED /* Deprecated. Use MEMCACHED_BAD_KEY_PROVIDED! */30 = MEMCACHED_FETCH_NOTFINISHED31 = MEMCACHED_TIMEOUT32 = MEMCACHED_BUFFERED33 = MEMCACHED_BAD_KEY_PROVIDED34 = MEMCACHED_INVALID_HOST_PROTOCOL35 = MEMCACHED_SERVER_MARKED_DEAD36 = MEMCACHED_UNKNOWN_STAT_KEY37 = MEMCACHED_E2BIG38 = MEMCACHED_INVALID_ARGUMENTS39 = MEMCACHED_KEY_TOO_BIG40 = MEMCACHED_AUTH_PROBLEM41 = MEMCACHED_AUTH_FAILURE42 = MEMCACHED_AUTH_CONTINUE43 = MEMCACHED_PARSE_ERROR44 = MEMCACHED_PARSE_USER_ERROR45 = MEMCACHED_DEPRECATED46 = MEMCACHED_IN_PROGRESS47 = MEMCACHED_SERVER_TEMPORARILY_DISABLED48 = MEMCACHED_SERVER_MEMORY_ALLOCATION_FAILURE49 = MEMCACHED_MAXIMUM_RETURN /* Always add new error code before */11 = MEMCACHED_CONNECTION_SOCKET_CREATE_FAILURE = MEMCACHED_ERRORThe method correctly returns false if you set the value to false. This means that in order to have proper fault checking mechanism in place you need to check the result code.<?php$Memcached = new Memcached();$Memcached->addServer('localhost', 11211);$Memcached->set('key', false);var_dump($Memcached->get('key')); // boolean falsevar_dump($Memcached->getResultCode()); // int 0 which is Memcached::RES_SUCCESS ?>