zoukankan      html  css  js  c++  java
  • Memcache所有方法及参数详解以及使用方法

    参考http://www.php.net/manual/zh/function.Memcache-add.php

    Memcache::add - 添加一个值,如果已经存在,则返回false

    Memcache::addServer - 添加一个可供使用的服务器地址

    Memcache::close - 关闭一个Memcache对象

    Memcache::connect - 创建一个Memcache对象

    memcache_debug - 控制调试功能

    Memcache::decrement - 对保存的某个key中的值进行减法操作

    Memcache::delete - 删除一个key值

    Memcache::flush - 清除所有缓存的数据

    Memcache::get - 获取一个key值

    Memcache::getExtendedStats - 获取进程池中所有进程的运行系统统计

    Memcache::getServerStatus - 获取运行服务器的参数

    Memcache::getStats - 返回服务器的一些运行统计信息

    Memcache::getVersion - 返回运行的Memcache的版本信息

    Memcache::increment - 对保存的某个key中的值进行加法操作

    Memcache::pconnect - 创建一个Memcache的持久连接对象

    Memcache::replace -对一个已有的key进行覆写操作

    Memcache::set - 添加一个值,如果已经存在,则覆写

    Memcache::setCompressThreshold - 对大于某一大小的数据进行压缩

    Memcache::setServerParams - 在运行时修改服务器的参数

    Memcache::add用法

    bool Memcache::add ( string $key , mixed $var [, int $flag [, int $expire ]] )

    说明:

    如果$key不存在的时候,使用这个函数来存储$var的值。功能相同的函数是memcache_add()。

    参数:

    $key :将要存储的键值。

    $var :存储的值,字符型和整型会按原值保存,其他类型自动序列化以后保存。

    $flag:是否用MEMCACHE_COMPRESSED来压缩存储的值,true表示压缩,false表示不压缩。

    $expire:存储值的过期时间,如果为0表示不会过期,你可以用unix时间戳或者描述来表示从现在开始的时间,但是你在使用秒数表示的时候,不要超过2592000秒 (表示30天)。

    返回值:

    如果成功则返回 TRUE,失败则返回 FALSE。如果$key值已经存在,则会返回FALSE。 其他情况下Memcache::add()的用法类似于Memcache::set()。

    例子:

    <?php

    $memcache_obj = memcache_connect("localhost", 11211);


    memcache_add($memcache_obj, 'var_key', 'test variable', false, 30);


    $memcache_obj->add('var_key', 'test variable', false, 30);

    ?>

    Memcache::addServer用法

    bool Memcache::addServer ( string $host [, int $port [, bool $persistent [, int $weight [, int $timeout [, int$retry_interval [, bool $status [, callback $failure_callback ]]]]]]] )

    说明:

    添加一个可供使用的服务器地址到连接池中,连接用Memcache::addServer打开,脚本执行完后自动关闭,或者可以用Memcache::close()手动关闭。相同函数是memcache_add_server()。

    当用这个方法的时候(相对于Memcache::connect()和 Memcache::pconnect()方法),网络连接只有等需要的时候才会建立,因此不会因为增加很多的服务器到连接池而增加系统负担,因为很多服务器可能没有使用。

    故障恢复会发生在这个方法执行的任何阶段,只要其他的服务器是正常的,这些连接请求的失败用户不会注意到。任何一种socket或者memcached服务器级的错误可以触发故障恢复。正常的客户端错误比如增加一个存在的键值不会引发故障恢复。

    参数:

    $host服务器的地址

    $port服务器端口

    $persistent是否是一个持久连接

    $weight这台服务器在所有服务器中所占的权重

    $timeout连接的持续时间

    $retry_interval连接重试的间隔时间,默认为15,设置为-1表示不进行重试

    $status控制服务器的在线状态

    $failure_callback允许设置一个回掉函数来处理错误信息。

    返回值:

    如果成功则返回 TRUE,失败则返回 FALSE。

    例子:

    <?php

    $memcache = new Memcache;
    $memcache->addServer('memcache_host', 11211);
    $memcache->addServer('memcache_host2', 11211);

    $memcache_obj = memcache_connect('memcache_host', 11211);
    memcache_add_server($memcache_obj, 'memcache_host2', 11211);

    ?>

    Memcache::close用法

    bool Memcache::close ( void )

    说明:

    关闭memcache服务器连接。这个函数不会关闭长连接,长连接只有在web服务器关闭或者重启的时候才会关闭。相同的函数memcache_close()

    返回值:

    如果成功则返回 TRUE,失败则返回 FALSE。

    例子:

    <?php


    $memcache_obj = memcache_connect('memcache_host', 11211);

    memcache_close($memcache_obj);


    $memcache_obj = new Memcache;
    $memcache_obj->connect('memcache_host', 11211);

    $memcache_obj->close();

    ?>

    Memcache::connect用法

    bool Memcache::connect ( string $host [, int $port [, int $timeout ]] )

    说明:

    打开memcached服务器连接,建立一个到memcached服务器的连接,用Memcache::connect打开的连接会在脚本执行完毕后自动关闭。你也可以用Memcache::close()去关闭连接。相同的函数是memcache_connect()。

    参数:

    $host:指向memcached正在收听的链接的主机,这个参数会有另一种特殊的连接方式unix:///path/to/memcached.sock,即用unix的域名sockets,这种情况下,端口必须设置为0

    $port:指向memcached正在收听的链接的端口,用unix的域名sockets的情况下,端口必须设置为0

    $timeout:用于连接守护进程的秒数,当你改变默认的1秒的值的时候,你需要考虑一下,如果你的连接太慢的话,你可能会失去缓存的优势。

    返回值:

    如果成功则返回 TRUE,失败则返回 FALSE。

    例子:

    <?php

    $memcache_obj = memcache_connect('memcache_host', 11211);

    $memcache = new Memcache;
    $memcache->connect('memcache_host', 11211);

    ?>

    memcache::debug

    bool memcache_debug ( bool $on_off )

    说明:

    控制调试功能,前提是php在编译的时候使用了-enable-debug选项,否则这个函数不会有作用。

    参数:

    $on_off:true表示开启调试,false表示关闭调试

    返回值:

    如果php在编译的时候使用了-enable-debug选项,返回true,否则返回false

    Memcache::decrement用法

    int Memcache::decrement ( string $key [, int $value ] )

    说明:

    Memcache::decremen方法的作用是对保存的某个key中的值进行减法操作,用法跟Memcache::increment类似。

    你也可以用memcache_decrement()函数。

    参数:

    Key:想要减少的键的名字

    Value:想要减少的值。

    返回值:

    如果成功,返回被减少后的值,如果失败返回false。

    例子:

    <?php

    $memcache = new Memcache;

    $memcache->connect('localhost', 11211);

    $memcache->set('test_item', 8);

    $memcache->increment('test_item', 4);

    echo $memcache->decrement('test_item', 7);

    // 显示 5

    ?>

    这个例子连Memcache::increment函数都一块演示了。

    Memcache::delete用法

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

    说明:

    删除一个key值,如果参数$timeout被设置,那么存储的值会在设置的秒数以后过期,你也可以用函数memcache_delete()

    返回值:

    如果成功则返回 TRUE,失败则返回 FALSE。

    例子:

    <?php


    $memcache_obj = memcache_connect('memcache_host', 11211);


    memcache_delete($memcache_obj, 'key_to_delete', 10);


    $memcache_obj = new Memcache;
    $memcache_obj->connect('memcache_host', 11211);

    $memcache_obj->delete('key_to_delete', 10);

    ?>

    Memcache::flush

    bool Memcache::flush ( void )

    说明:

    清除所有缓存的数据。Memcache::flush实际上没有释放资源,它仅仅将所有的缓存标记为过期,这样可以使新的缓存来覆盖被占的内存空间。一样的函数是memcache_flush()

    返回值:

    如果成功则返回 TRUE,失败则返回 FALSE。

    例子:

    <?php


    $memcache_obj = memcache_connect('memcache_host', 11211);

    memcache_flush($memcache_obj);

    $memcache_obj = new Memcache;
    $memcache_obj->connect('memcache_host', 11211);

    $memcache_obj->flush();

    ?>

    Memcache::get

    string Memcache::get ( string $key [, int &$flags ] )

    array Memcache::get ( array $keys [, array &$flags ] )

    说明:

    方法的作用是获取一个key值,key值可以是一个数组,结果会包含键值对。

    参数:

    $key是键值或者一个键的数组值。

    $flags如果这个参数存在,那么$flags跟写入这个参数的值相关,这些$flags 类似于Memcache::set()函数里的$flags。

    返回值:

    如果成功,则返回key对应的值,如果失败则返回false.

    例子:

    <?php


    $memcache_obj = memcache_connect('memcache_host', 11211);
    $var = memcache_get($memcache_obj, 'some_key');


    $memcache_obj = new Memcache;
    $memcache_obj->connect('memcache_host', 11211);
    $var = $memcache_obj->get('some_key');


    $memcache_obj = memcache_connect('memcache_host', 11211);
    $var = memcache_get($memcache_obj, Array('some_key', 'another_key'));


    $memcache_obj = new Memcache;
    $memcache_obj->connect('memcache_host', 11211);
    $var = $memcache_obj->get(Array('some_key', 'second_key'));

    ?>

    Memcache::getExtendedStats

    array Memcache::getExtendedStats ([ string $type [, int $slabid [, int $limit ]]] )

    说明:

    获取进程池中所有进程的运行系统统计。相同函数是memcache_get_extended_stats()

    参数:

    $type表示要求返回的类型:reset, malloc, maps, cachedump, slabs, items, sizes;

    $slabid第一个参数设置为"cachedump"时使用的。

    $limit第一个参数设置为"cachedump"时使用的。

    返回值:

    如果成功,返回统计信息,失败会返回false

    例子:

    <?php
         $memcache_obj = new Memcache;
         $memcache_obj->addServer('memcache_host', 11211);
         $memcache_obj->addServer('failed_host', 11211);
        
         $stats = $memcache_obj->getExtendedStats();

       //slabs机制分配管理内存的情况

    $statsslab = $memcache_obj->getExtendedStats(slabs);
        
    ?>

    Memcache::getServerStatus

    int Memcache::getServerStatus ( string $host [, int $port ] )

    说明:

    获取运行服务器的参数。返回一个服务器在线或者离线的状态。相同的函数是memcache_get_server_status()

    参数:

    $host:正在收听的连接的主机

    $port正在收听的连接的主机的端口,默认是11211

    返回值:

    成功返回服务器状态,服务器没有启动会返回0,其他数字的时候表示服务器是启动状态的。

    例子:

    <?php


    $memcache = new Memcache;
    $memcache->addServer('memcache_host', 11211);
    echo $memcache->getServerStatus('memcache_host', 11211);


    $memcache = memcache_connect('memcache_host', 11211);
    echo memcache_get_server_status($memcache, 'memcache_host', 11211);

    ?>

    Memcache::getStats

    array Memcache::getStats ([ string $type [, int $slabid [, int $limit ]]] )

    说明:

    返回服务器的一些运行统计信息。相同的函数是memcache_get_stats()

    参数:

    $type表示要求返回的类型:reset, malloc, maps, cachedump, slabs, items, sizes;

    $slabid第一个参数设置为"cachedump"时使用的。

    $limit第一个参数设置为"cachedump"时使用的。

    返回值:

    成功返回服务器的统计信息数组,失败返回false。

  • 相关阅读:
    hashmap的一些基础原理
    关于uuid
    读锁跟写锁的区别
    栈为什么效率比堆高
    MySQL行级锁、表级锁、页级锁详细介绍
    MYSQL MyISAM与InnoDB对比
    MYSQL锁表问题解决
    mysql查询锁表语句
    三种排序方法
    正则表达式
  • 原文地址:https://www.cnblogs.com/jackluo/p/2920266.html
Copyright © 2011-2022 走看看