您好,欢迎来到三六零分类信息网!老站,搜索引擎当天收录,欢迎发信息

PHP中Memcache类函数详解

2024/2/18 4:55:42发布15次查看
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()。
例子:
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。
例子:
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。
例子:
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。
例子:
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。
例子:
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。
例子:
connect(’memcache_host’, 11211);
$memcache_obj->delete(’key_to_delete’, 10);
?>
memcache::flush
bool memcache::flush ( void )
说明:
清除所有缓存的数据。memcache::flush实际上没有释放资源,它仅仅将所有的缓存标记为过期,这样可以使新的缓存来覆盖被占的内存空间。一样的函数是memcache_flush()
返回值:
如果成功则返回 true,失败则返回 false。
例子:
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.
例子:
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
例子:
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,其他数字的时候表示服务器是启动状态的。
例子:
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。
例子:
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
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。
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。
例子:
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。
例子:
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');
?>
该用户其它信息

VIP推荐

免费发布信息,免费发布B2B信息网站平台 - 三六零分类信息网 沪ICP备09012988号-2
企业名录 Product