PHP 7.0.6 Released

    Memcache::delete

    (PECL memcache >= 0.2.0)

    Memcache::delete — Delete item from the server

    Description

    bool Memcache::delete ( string $key [, int $timeout = 0 ] )

    Memcache::delete() deletes an item with the key.

    Parameters

    key

    The key associated with the item to delete.

    timeout

    This deprecated parameter is not supported, and defaults to 0 seconds. Do not use this parameter.

    Changelog

    Version Description
    Unknown It's not recommended to use the timeout parameter. The behavior differs between memcached versions, but setting to 0 is safe. Other values for this deprecated feature may cause the memcache delete to fail.

    Return Values

    Returns TRUE on success or FALSE on failure.

    Examples

    Example #1 Memcache::delete() example

    <?php

    /* procedural API */
    $memcache_obj = memcache_connect('memcache_host', 11211);

    /* item will be deleted by the server */
    memcache_delete($memcache_obj, 'key_to_delete');

    /* OO API */
    $memcache_obj = new Memcache;
    $memcache_obj->connect('memcache_host', 11211);

    $memcache_obj->delete('key_to_delete');

    ?>

    See Also

    User Contributed Notes

    nibblebot at gmail dot com
    5 years ago
    the Memcache::delete(key) function is broken on several combinations of memcached+pecl-memcache combinations.

    pecl-memcache 2.2.5 + memcached 1.4.2 - Memcache::delete(key) WORKS

    pecl-memcache 2.2.5 + memcached 1.4.3 - Memcache::delete(key) DOES NOT WORK

    pecl-memcache 2.2.5 + memcached 1.4.4 - Memcache::delete(key) WORKS

    pecl-memcache 2.2.5 + memcached 1.4.5 - Memcache::delete(key) WORKS

    pecl-memcache 3.0.4 + memcached 1.4.2 - Memcache::delete(key) WORKS

    pecl-memcache 3.0.4 + memcached 1.4.3 - Memcache::delete(key) DOES NOT WORK

    pecl-memcache 3.0.4 + memcached 1.4.4 - Memcache::delete(key) DOES NOT WORK

    pecl-memcache 3.0.4 + memcached 1.4.5 - Memcache::delete(key) DOES NOT WORK
    me at adamhahn dot com
    3 years ago
    I could not get the delete to work properly, so I ended up trying the 'set' method and setting the timeout value to -1.

    <?php
    $memcache    ->set('index', 'deleted', 0, -1);
    ?>

    It solved my problem with the delete method.

    (using memcached 1.4.5 and pecl-memcache 3.0.6)
    vbaspcppguy at gmail dot com
    5 years ago
    According to the documents, $timeout is not required, but for me if I did not include it regardless of value, it fired an error. I made a simple fix for it.

    <?php
    class memcache_tools extends memcache
    {
        public function     delete($key, $expire=0)
        {
                parent::delete($key, $expire);   
        }
    }
    ?>

    This will force it to behave as it should regardless of version.
    padys
    3 years ago
    In my case this code does NOT work:
    <?php
    $memcache    ->set('index', 'deleted', 0, -1);
    ?>
    because of expire == -1.

    I set expire = 1 (and I prefer "replace"):
    <?php
    $memcache    ->replace('index', '', 0, 1);
    ?>
    Anonymous
    5 years ago
    Regardless of whether or not it succeeds, for me on Ubuntu 10.04 it always returns false.  Just an FYI, you can't seem to rely on the result.
    To Top