向Memcache服务端添加数据
添加对象时要new 类名
1.Memcache::set – 添加一个值,如果已经存在,则覆写
方法
bool Memcache::set ( string $key , mixed $var [, int $flag [, int $expire ]] )
返回值
添加一个值,如果已经存在,则覆写;如果成功则返回 TRUE,失败则返回 FALSE。
2.Memcache::add – 添加一个值,如果已经存在,则返回false
方法
bool Memcache::add ( string $key , mixed $var [, int $flag [, int $expire ]] )
返回值
如果成功则返回 TRUE,失败则返回 FALSE。如果$key值已经存在,则会返回FALSE
案例参考:
$memcache_obj->add(’var_key’, ’test variable’, false, 30);
3.Memcache::replace -对一个已有的key进行覆写操作
方法
bool Memcache::replace ( string $key , mixed $var [, int $flag [, int $expire ]] )
返回值
如果成功则返回 TRUE,失败则返回 FALSE。如果$key值已经存在,则会返回FALSE。
参数 | 含义 |
---|---|
$key | 将要存储的键值。 |
$var | 存储的值,字符型和整型会按原值保存,其他类型自动序列化以后保存。 |
$flag | 是否用MEMCACHE_COMPRESSED来压缩存储的值,true表示压缩,false表示不压缩。 |
$expire | 存储值的过期时间,如果为0表示不会过期,你可以用unix时间戳或者描述来表示从现在开始的时间,但是你在使用秒数表示的时候,不要超过2592000秒 (表示30天)。 |
向Memcache服务端获取值
1.Memcache::get – 获取一个key值
方法
string Memcache::get ( string $key [, int &$flags ] )
返回值
如果成功,则返回key对应的值,如果失败则返回false.
参数 | 含义 |
---|---|
$key | 是键值或者一个键的数组值。 |
$flags | 如果这个参数存在,那么$flags跟写入这个参数的值相关,这些$flags 类似于Memcache::set()函数里的$flags |
删除向Memcache服务端
1.Memcache::delete – 删除一个key值
方法
bool Memcache::delete ( string $key [, int $timeout ] )
返回值
如果成功则返回 TRUE,失败则返回 FALSE。
参数 | 含义 |
---|---|
$key | 要删除的元素的key。 |
$timeout | 删除该元素的执行时间。如果值为0,则该元素立即删除,如果值为30,元素会在30秒内被删除 |
2.Memcache::flush – 清除所有缓存的数据
方法
bool Memcache::flush ( void )
返回值
如果成功则返回 TRUE,失败则返回 FALSE。
对存储的值增加减少更改
1.Memcache::decrement – 对保存的某个key中的值进行减法操作
方法
int Memcache::decrement ( string $key [, int $value ] )
返回值
如果成功,返回被减少后的值,如果失败返回false。
2.Memcache::increment – 对保存的某个key中的值进行加法操作
方法
int Memcache::increment ( string $key [, int $value ] )
返回值
如果成功,返回被减少后的值,如果失败返回false。
参数 | 含义 |
---|---|
$Key | 想要减少/增加的键的名字 |
$Value | 想要减少/增加的值 |
案例参考:$memcache->increment(’test_item’, 4);
关闭资源
1.Memcache::close – 关闭一个Memcache对象
方法
bool Memcache::close ( void )
返回值
如果成功则返回 TRUE,失败则返回 FALSE。
服务端的配置
1.Memcache::addServer – 添加一个可供使用的服务器地址
方法
bool Memcache::addServer ( string $host [, int $port [, bool $persistent [, int $weight [, int$timeout [, int $retry_interval [, bool $status [, callback $failure_callback ]]]]]]] )
返回值
如果成功则返回 TRUE,失败则返回 FALSE。
参数 | 含义 |
---|---|
$persistent | 是否是一个持久连接 |
$weight | 这台服务器在所有服务器中所占的权重 |
2.Memcache::setServerParams – 在运行时修改服务器的参数
方法
bool Memcache::setServerParams ( string $host [, int $port [, int $timeout [, int$retry_interval [, bool $status [, callback $failure_callback ]]]]] )
返回值
如果成功则返回 TRUE,失败则返回 FALSE。
参数 | 含义 |
---|---|
$host | 服务器的地址 |
$port | 服务器端口 |
$timeout | 连接的持续时间 |
$retry_interval | 连接重试的间隔时间,默认为15,设置为-1表示不进行重试 |
$status | 控制服务器的在线状态 |
$failure_callback | 允许设置一个回掉函数来处理错误信息。 |
获取服务端的参数
1.Memcache::getServerStatus – 获取运行服务器的状态
方法
int Memcache::getServerStatus ( string $host [, int $port ] )
返回值
成功返回服务器状态,服务器没有启动会返回0,其他数字的时候表示服务器是启动状态的。
参数 | 含义 |
---|---|
$host | 正在收听的连接的主机 |
$port | 正在收听的连接的主机的端口,默认是11211 |
2.Memcache::getStats – 返回服务器的一些运行统计信息
方法
array Memcache::getStats ([ string $type [, int $slabid [, int $limit ]]] )
参数 | 含义 |
---|---|
$type | 表示要求返回的类型reset, malloc, maps, cachedump, slabs, items, sizes; |
$slabid | 第一个参数设置为”cachedump”时使用的。 |
$limit | 第一个参数设置为”cachedump”时使用的。 |
3.Memcache::getVersion – 返回运行的Memcache的版本信息
方法
string Memcache::getVersion ( void )
返回值
成功返回服务器的版本信息,失败的时候返回false。
_debug开启关闭
1.memcache_debug – 控制调试功能
属性
bool memcache_debug ( bool $on_off )
返回值
如果php在编译的时候使用了-enable-debug选项,返回true,否则返回false
参数 | 含义 |
---|---|
$on_off | true表示开启调试,false表示关闭调试 |
2.Memcache::getExtendedStats – 获取进程池中所有进程的运行系统统计
方法
array Memcache::getExtendedStats ([ string $type [, int $slabid [, int $limit ]]] )
返回值
如果成功,返回统计信息,失败会返回false
参数 | 含义 |
---|---|
$type | 表示要求返回的类型:reset, malloc, maps, cachedump, slabs, items, sizes; |
$slabid | 第一个参数设置为”cachedump”时使用的。 |
$limit | 第一个参数设置为”cachedump”时使用的。 |
开启大值自动压缩
1.Memcache::setCompressThreshold – 对大于某一大小的数据进行压缩
方法
bool Memcache::setCompressThreshold ( int $threshold [, float $min_savings ] )
返回值
如果成功则返回 TRUE,失败则返回 FALSE。
参数 | 含义 |
---|---|
$threshold | 控制多大值进行自动压缩的阈值。 |
$min_saving | 指定经过压缩实际存储的值的压缩率,支持的值必须在0和1之间。默认值是0.2表示20%压缩率。 |