Memcached::setByKey

    (PECL memcached >= 0.1.0)

    Memcached::setByKey — Store an item on a specific server

    Beschreibung

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

    Memcached::setByKey() is functionally equivalent to Memcached::set(), except that the free-form server_key can be used to map the key to a specific server. This is useful if you need to keep a bunch of related keys on a certain server.

    Parameter-Liste

    server_key

    Ein Schlüssel, der den Server bestimmt, auf dem die Daten abgelegt oder von dem Daten abgerufen werden sollen. Anstatt den tatsächlichen Schlüssel des Wertes zu hashen, wird der Server-Key gehasht, um den Memcached-Server ausfindig zu machen, mit dem gesprochen werden soll. Dies erlaubt es, alle zusammengehörigen Daten auf einem einzigen Server abzulegen, um multiple Operationen effizienter zu gestalten.

    key

    Der Schlüssel, unter dem der Wert abgelegt werden soll.

    value

    Der zu speichernde Wert.

    expiration

    Die Verfallszeit, Vorgabewert ist 0. Siehe Verfallszeiten für weiterführende Informationen.

    Rückgabewerte

    Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben. Benutzen Sie wenn nötig Memcached::getResultCode().

    Beispiele

    Beispiel #1 Memcached::setByKey() example

    <?php
    $m     = new Memcached();
    $m->addServer('localhost', 11211);


    $m->setByKey('api-cache', 'block-ip:169.254.253.252', 1);
    $m->setByKey('api-cache', 'block-ip:169.127.127.202', 1);
    ?>

    Siehe auch

    To Top