【memcache/redis】memcache常用函数集汇总

memcache函数所有的方法列表如下:

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”时使用的。

Memcache::getVersion

string  Memcache :: getVersion ( void )

 

说明:

返回运行的Memcache的版本信息。相同函数memcache_get_version()

 

返回值:

成功返回服务器的版本信息,失败的时候返回false。

 

例子:

复制代码
<? php

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

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

?>
复制代码

 

 

Memcache::increment

 

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

 

对保存的某个key中的值进行加法操作

用法参考Memcache::decrement

 

 

Memcache::pconnect

 

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

 

说明:

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

用法与Memcache::connect()相似,不同点地方是Memcache::pconnect是建立的持久连接。这个连接在脚本执行完或者Memcache::close()函数运行也不会被关闭。与它相同的函数是memcache_pconnect()

 

参数:

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

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

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

 

返回值:

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

复制代码
<? php

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

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

?>
复制代码

 

Memcache::replace

 

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

 

说明:

对一个已有的key进行覆写操作。相同函数是memcache_replace()

 

参数:

$key :将要存储的键值。

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

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

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

 

返回值:

如果成功则返回 TRUE,失败则返回 FALSE。如果$key值已经存在,则会返回FALSE。

 

复制代码
<? php

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

memcache_replace(
$memcache_obj ,   " test_key " ,   " some variable " ,   false ,   30 );

$memcache_obj -> replace( " test_key " ,   " some variable " ,   false ,   30 );

?>
复制代码

 

 

Memcache::set

 

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

 

说明:

添加一个值,如果已经存在,则覆写。相同函数是memcache_set()

 

参数:

$key :将要存储的键值。

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

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

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

 

返回值:

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

 

例子:

 

复制代码
$memcache_obj  =   new  Memcache;

$memcache_obj
-> connect( ' memcache_host ' 11211 );

$memcache_obj
-> set ( ' var_key ' ' some really big variable ' , MEMCACHE_COMPRESSED,  50 );

echo $memcache_obj
-> get ( ' var_key ' );
复制代码

 

Memcache::setCompressThreshold

bool Memcache :: setCompressThreshold ( int  $threshold  [ ,   float   $min_savings  ] )

 

说明:

对大于某一大小的数据进行压缩。相同的函数是memcache_set_compress_threshold()

 

参数:

setCompressThreshold方法有两个参数,第一个参数表示处理数据大小的临界点,第二个参数表示压缩的比例,默认为0.2。

 

返回值:

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

 

例子:

复制代码
<? php

$memcache_obj   =   new  Memcache;
$memcache_obj -> addServer( ' memcache_host ' ,   11211 );
$memcache_obj -> setCompressThreshold( 20000 ,   0.2 );

$memcache_obj   =  memcache_connect( ' memcache_host ' ,   11211 );
memcache_set_compress_threshold(
$memcache_obj ,   20000 ,   0.2 );

?>
复制代码

 

 

Memcache::setServerParams         

 

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

 

说明:

在运行时修改服务器的参数。相同函数是memcache_set_server_params()。

 

参数:

$host服务器的地址

$port服务器端口

$timeout连接的持续时间

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

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

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

 

返回值:

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

 

例子:

 

复制代码
<? php

function  _callback_memcache_failure( $host ,   $port ) {
    
print   " memcache ' $host : $port ' failed " ;
}

$memcache   =   new  Memcache;

//  离线模式增加一个服务器
$memcache -> addServer( ' memcache_host ' ,   11211 ,   false ,   1 ,   1 ,   - 1 ,   false );

//  把服务器设成在线
$memcache -> setServerParams( ' memcache_host ' ,   11211 ,   1 ,   15 ,   true ,   ' _callback_memcache_failure ' );

$memcache_obj   =  memcache_connect( ' memcache_host ' ,   11211 );
memcache_set_server_params(
$memcache_obj ,   ' memcache_host ' ,   11211 ,   1 ,   15 ,   true ,   ' _callback_memcache_failure ' );

?>
复制代码
  • 0
    点赞
  • 3
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值