函式名:Memcache::set()
適用版本:PHP 4 >= 4.3.3, PHP 5, PHP 7
用法:Memcache::set() 函式用於向Memcache伺服器儲存一個鍵值對。如果鍵不存在,則會建立一個新的鍵值對;如果鍵已經存在,則會替換現有的值。
語法:bool Memcache::set ( string $key , mixed $var [, int $flag [, int $expire ]] )
引數:
- key: 要儲存的鍵名,必須是一個字串。
- var: 要儲存的值,可以是任意型別的變數。
- flag: 可選引數,用於指定儲存的值的型別。預設為0,表示儲存為普通字串。可以使用Memcache::MEMCACHE_COMPRESSED常量來指定儲存為壓縮的字串。
- expire: 可選引數,用於指定儲存的值的過期時間,以秒為單位。預設為0,表示永不過期。
返回值:成功時返回true,失敗時返回false。
示例:
<?php
$memcache = new Memcache;
$memcache->connect('localhost', 11211) or die ("無法連線到Memcache伺服器");
$key = "my_key";
$value = "Hello, Memcache!";
// 儲存一個鍵值對,不指定過期時間
$result = $memcache->set($key, $value);
if ($result) {
echo "儲存成功";
} else {
echo "儲存失敗";
}
// 儲存一個鍵值對,指定過期時間為60秒
$result = $memcache->set($key, $value, 0, 60);
if ($result) {
echo "儲存成功";
} else {
echo "儲存失敗";
}
// 儲存一個壓縮的鍵值對,指定過期時間為1小時
$result = $memcache->set($key, $value, Memcache::MEMCACHE_COMPRESSED, 3600);
if ($result) {
echo "儲存成功";
} else {
echo "儲存失敗";
}
?>
在上面的示例中,我們首先建立了一個Memcache物件並連線到Memcache伺服器。然後,我們使用set()
函式儲存了三個鍵值對,分別是不指定過期時間的普通鍵值對、指定過期時間的普通鍵值對和指定過期時間和壓縮型別的鍵值對。最後,根據set()
函式的返回值,我們判斷儲存是否成功,並輸出相應的提示資訊。