Memcache::getServerStatus

(PECL memcache >= 2.1.0)

Memcache::getServerStatus — サーバーの状態を返す

説明

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

Memcache::getServerStatus() は、サーバーがオンライン/オフラインのどちらであるかを返します。 memcache_get_server_status() 関数を使用することも可能です。

注意:
この関数は、Memcache バージョン 2.1.0 で追加されました。

パラメータ

host: memcached が接続を待ち受けるホストを指定します。
port: memcached が接続を待ち受けるポートを指定します。

返り値

サーバーの状態を返します。サーバーに接続できなかった場合に 0、それ以外の場合にはゼロ以外の値を返します。

例

例1 Memcache::getServerStatus() の例


<?php

/* オブジェクト指向の API */
$memcache = new Memcache;
$memcache->addServer('memcache_host', 11211);
echo $memcache->getServerStatus('memcache_host', 11211);

/* 手続き型の API */
$memcache = memcache_connect('memcache_host', 11211);
echo memcache_get_server_status($memcache, 'memcache_host', 11211);

?>

参考

Memcache::addServer() - コネクションプールに memcached サーバーを追加する
Memcache::setServerParams() - サーバーのパラメータおよび状態を、実行時に変更する

add a note User Contributed Notes Memcache::getServerStatus

tom at all dash community dot de 06-Dec-2011 08:01


Note: the result of the function is cached. The cached is not automatically refreshed.



Call MemCache::getExtendedStats() to force a cache-update.

geoffrey dot hoffman at gmail dot com 21-Jul-2010 12:10


Beware... this method does not actually attempt to connect to the server and port you specify! It is not a health check to tell whether memcached is actually running or not!



It merely returns the server status from the pool, which defaults to TRUE when using addServer( ) with only required arguments. 



Try it - stop your memcached and run the sample code above - it will output 1.

add a note