Memcached::replaceByKey

    (PECL memcached >= 0.1.0)

    Memcached::replaceByKey — 指定したサーバーで既存のキーのアイテムを入れ替える

    説明

    publicMemcached::replaceByKey(
        string$server_key,
        string$key,
        mixed$value,
        int$expiration = 0
    ): bool

    Memcached::replaceByKey() は機能的に Memcached::replace() と同等です。しかし、自由形式の server_key を使用して、 key を特定のサーバーに関連付けることができます。 これは、関連するキーを特定のサーバーに置き続けたいときなどに便利です。

    パラメータ

    server_key

    値を格納したりデータを取得したりするサーバーを表すキー。 アイテムの実際のキーをハッシュするかわりにサーバーのキーをハッシュして、どの memcached サーバーとやりとりするのか選びます。 これで、関連するアイテムを一つのサーバーにまとめられるようになり、マルチ操作の効率が上がります。

    key

    値の格納先のキー。

    value

    格納する値。

    expiration

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

    戻り値

    成功した場合に true を、失敗した場合に false を返します。 キーが存在しない場合、 Memcached::getResultCode() は Memcached::RES_NOTSTORED を返します。

    参考

    To Top