アイテムを格納する

# Memcached::set

(PECL memcached >= 0.1.0)

Memcached::set — アイテムを格納する

### 説明

public function Memcached::set(string `$key`, mixed `$value`, int `$expiration` = 0): bool

Memcached::set() は、 指定したキー `key` で memcache サーバー上に `value` を格納します。 `expiration` パラメータで、 この値をいつ有効期限切れにするのかを制御することができます。

値に指定できるのは、リソース型以外の PHP の任意の型です。 リソース型はシリアライズすることができないため、使用することができません。 `Memcached::OPT_COMPRESSION` オプションをオンにすると、 シリアライズしたデータを格納する前に圧縮を行います。

### パラメータ

`key`

  値の格納先のキー。

`value`

  格納する値。

`expiration`

  期限切れとなるまでの時間。デフォルトは 0。詳細な情報は有効期限 を参照ください。

### 戻り値

成功した場合に `true` を、失敗した場合に `false` を返します。 必要に応じて Memcached::getResultCode() を使用しましょう。

### 例

例1 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));
    /* expire 'object' key in 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'));
    ?>

上の例の出力は、 たとえば以下のようになります。

    int(99)
    string(15) "a simple string"
    array(2) {
      [0]=>
      int(11)
      [1]=>
      int(12)
    }
    object(stdClass)#1 (0) {
    }

### 参考

- Memcached::setByKey() - 指定したサーバーにアイテムを格納する
- Memcached::add() - アイテムを新しいキーで追加する
- Memcached::replace() - 既存のキーのアイテムを入れ替える

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open