Memcache函数库是在PECL(PHP Extension Community Library)中,主要作用是搭建大容量的内存数据的临时存放区域,在分布式的时候作用体现的非常明 显,否则不建议使用。
Memcache::add -?添加一个值,如果已经存在,则返回false
Memcache::addServer -?添加一个可供使用的服务器地址
Memcache::close -?关闭一个Memcache对象
Memcache::connect -?创建一个Memcache对象
memcache_debug -?控制调试功能! [4 F8 C2 e, X
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()。
例子:
$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允许设置 一个回掉函数来处理错误信息。
返 回值:* M0 L/ q9 ^2 O5 c* q/ J
如果成功则返回?TRUE,失败则返回?FALSE。
例子:
$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。
例 子:?
$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_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。
例子:?
$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.?
例子:
$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’);