PHP 的 Memcached 扩展库中的函数介绍 memcache_connect

zhgc

PHP 的 Memcached 扩展库中的函数介绍  memcache_connect

php memcached方法有：
1、set()；1、add()；3、replace()；4、get()；5、delete()；6、increment()；7、decrement()；8、flush()；9、connect()等等。

PHP操作Memcached的方法汇总

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

#Key存在则更新值，不存在则设置k-v对。注：$var可以存储任何数据

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

#key不存在的时候才添加

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

#替换存在的key值，不存在key则返回错误

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

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

#获取一个或者多个值

5、bool Memcache::delete ( string $key [, int $timeout = 0 ] )

#删除key元素，设置了timeout则多少秒后删除

#【注意】有些版本对应memcached使用timeout将会导致删除失败（0可以）

6、int Memcache::increment ( string $key [, int $value = 1 ] )

#key存在且能转换为数字，则加int；否则直接更换为value。当key不存在，则返回false

7、int Memcache::decrement ( string $key [, int $value = 1 ] )

8、bool Memcache::flush ( void )

#全部元素失效

9、bool Memcache::connect ( string $host [, int $port [, int $timeout=1 ]] )

#连接memcache服务器，执行完脚本后会自动关闭（使用close可以主动关闭）

10、bool Memcache::close ( void )

#关闭memcache的链接（这个函数不会关闭持久化连接）

11、mixed Memcache::pconnect ( string $host [, int $port [, int $timeout ]] )

#建立持久化连接

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

#增加一台服务器到连接池，通过此方法打开的服务，将会在脚本结束的时候关闭或者主动关闭close

#使用此方法，网络连接不一定立即连接，而是等需要使用此服务器的时候，才会进行连接，因此即使添加大量的服务器到连接池也没有开销

参数：

$persistent 是否持久化，默认true

$weight 表示权重

$retry_interval 服务器连接失败时重试时间，默认为15秒，-1表示不重试

$status 控制此服务器是否被标记为在线状态（假若连接失败，连接池少了一个服务器，会影响原有的分配算法）

$failure_callback 连接失败后执行的函数（在故障转移前执行），包含两个参数，失败主机host和port

13、array Memcache::getExtendedStats ([ string $type [, int $slabid [, int $limit = 100 ]]] )

#getExtendedStats()返回一个二维关联数据的服务器统计信息

#getExtendedStats(‘slabs’)获取到每个服务器上活动slabs分块的id

#getExtendedStats('cachedump', $slabid, $limit)获取每个slab里面缓存的项

参数：

#type 期望抓取的统计信息类型，可以使用的值有{reset, malloc, maps, cachedump, slabs, items, sizes}

#slabid 用于与参数type联合从指定slab分块拷贝数据，cachedump命令会完全占用服务器通常用于 比较严格的调试。

#limit 用于和参数type联合来设置cachedump时从服务端获取的实体条数。

14、int Memcache::getServerStatus ( string $host [, int $port = 11211 ] )

#返回一个服务器的状态，0表示服务器离线，非0表示在线。

15、array Memcache::getStats ([ string $type [, int $slabid [, int $limit = 100 ]]] )

#getStats()返回一个关联数据的服务器统计信息。同上

16、string Memcache::getVersion ( void )

#返回版本号

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

#开启对于大值的自动压缩

参数：

#threshold 控制多大值进行自动压缩的阈值。

#min_saving 指定经过压缩实际存储的值的压缩率，支持的值必须在0和1之间。默认值是0.2表示20%压缩率

18、bool Memcache::setServerParams ( string $host [, int $port = 11211 [, int $timeout [, int $retry_interval = false [, bool $status [, callback $failure_callback ]]]]] )

#用于运行时修改服务器参数

#参数同上

zhgc

这篇文章主要介绍了关于memcache类的扩展函数的介绍，有着一定的参考价值，现在分享给大家，有需要的朋友可以参考一下

Memcache — Memcache类

/****连接****/
1.Memcache::connect – 创建一个Memcache对象
语法：bool Memcache::connect ( string $host [, int $port [, int $timeout ]] )
如果成功则返回 TRUE，失败则返回 FALSE
案例参考：$memcache_obj->connect(’memcache_host’, 11211);

2.Memcache::pconnect – 创建一个Memcache的持久连接对象
语法：bool Memcache::pconnect ( string $host [, int $port [, int $timeout ]] )
如果成功则返回 TRUE，失败则返回 FALSE
参数：
$host：指向memcached正在收听的链接的主机，这个参数会有另一种特殊的连接方式unix:///path/to/memcached.sock，即用unix的域名sockets，这种情况下，端口必须设置为0
$port：指向memcached正在收听的链接的端口，用unix的域名sockets的情况下，端口必须设置为0
$timeout：用于连接守护进程的秒数，当你改变默认的1秒的值的时候，你需要考虑一下，如果你的连接太慢的话，你可能会失去缓存的优势。

/****添加****/ ※注意添加对象时要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天)。

/****获取值****/
1.Memcache::get – 获取一个key值
语法：string Memcache::get ( string $key [, int &$flags ] )
      array Memcache::get ( array $keys [, array &$flags ] )
如果成功，则返回key对应的值，如果失败则返回false.
参数：
$key是键值或者一个键的数组值。
$flags如果这个参数存在，那么$flags跟写入这个参数的值相关，这些$flags 类似于Memcache::set()函数里的$flags。

/****删除****/
1.Memcache::delete – 删除一个key值
语法：bool Memcache::delete ( string $key [, int $timeout ] )
如果成功则返回 TRUE，失败则返回 FALSE。

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允许设置一个回掉函数来处理错误信息。

/****获取参数****/
2.Memcache::getServerStatus – 获取运行服务器的状态
语法：int Memcache::getServerStatus ( string $host [, int $port ] )
成功返回服务器状态，服务器没有启动会返回0，其他数字的时候表示服务器是启动状态的。
参数：
$host：正在收听的连接的主机
$port正在收听的连接的主机的端口，默认是11211

3.Memcache::getStats – 返回服务器的一些运行统计信息
语法：array Memcache::getStats ([ string $type [, int $slabid [, int $limit ]]] )
参数：
$type表示要求返回的类型：reset, malloc, maps, cachedump, slabs, items, sizes;
$slabid第一个参数设置为”cachedump”时使用的。
$limit第一个参数设置为”cachedump”时使用的。

4.Memcache::getVersion – 返回运行的Memcache的版本信息
语法：string Memcache::getVersion ( void )
成功返回服务器的版本信息，失败的时候返回false。

/****调试****/
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。
参数：
setCompressThreshold方法有两个参数，第一个参数表示处理数据大小的临界点，第二个参数表示压缩的比例，默认为0.2。

以上就是本文的全部内容，希望对大家的学习有所帮助，更多相关内容请关注PHP中文网！