函式名稱:Memcached::set()
適用版本:該函式適用於所有 PHP 版本,但要求安裝了 Memcached 擴充套件。
函式描述:Memcached::set() 函式用於將一個鍵值對儲存到 Memcached 伺服器中。如果鍵已經存在,則會覆蓋舊的值。
用法:
$memcached = new Memcached();
$memcached->addServer('localhost', 11211);
$key = 'my_key';
$value = 'my_value';
$expiration = 3600; // 過期時間,單位為秒
$result = $memcached->set($key, $value, $expiration);
if ($result) {
echo 'Value stored successfully.';
} else {
echo 'Failed to store value.';
}
引數:
- key:要儲存的鍵名,必須為字串型別。
- value:要儲存的值,可以是任意型別。
- expiration:過期時間,可選引數,預設為 0,表示永不過期。如果設定了過期時間,Memcached 會在該時間後自動刪除該鍵值對。
返回值:
- 成功時返回 true。
- 失敗時返回 false。
示例解釋: 以上示例中,首先建立了一個 Memcached 物件,並新增了 Memcached 伺服器的地址和埠。然後,定義了要儲存的鍵名和對應的值。最後,呼叫 Memcached::set() 函式將鍵值對儲存到 Memcached 伺服器中,並根據返回值判斷儲存是否成功。如果成功,則輸出"Value stored successfully.";如果失敗,則輸出"Failed to store value."。
注意事項:
- 在使用 Memcached::set() 函式之前,需要確保已經安裝了 Memcached 擴充套件,並且 Memcached 伺服器在執行狀態。
- 如果要儲存的值是物件或陣列,會自動進行序列化。在獲取值時,需要進行反序列化操作。
- 如果儲存的鍵已經存在,Memcached::set() 函式會覆蓋舊的值。如果不希望覆蓋舊值,可以使用 Memcached::add() 函式。
- 如果儲存的鍵不存在,使用 Memcached::set() 函式會建立新的鍵值對。如果希望僅在鍵不存在時才建立新的鍵值對,可以使用 Memcached::add() 函式。