Memcache::getServerStatus

(PECL memcache >= 2.1.0)

Memcache::getServerStatus — Returns server status

Beschreibung

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

Memcache::getServerStatus() returns a the servers online/offline status. You can also use memcache_get_server_status() function.

Hinweis:
This function has been added to Memcache version 2.1.0.

Parameter-Liste

host: Point to the host where memcached is listening for connections.
port: Point to the port where memcached is listening for connections.

Rückgabewerte

Returns a the servers status. 0 if server is failed, non-zero otherwise

Beispiele

Beispiel #1 Memcache::getServerStatus() example

<?php

/* OO API */
$memcache = new Memcache;
$memcache->addServer('memcache_host', 11211);
echo $memcache->getServerStatus('memcache_host', 11211);

/* procedural API */
$memcache = memcache_connect('memcache_host', 11211);
echo memcache_get_server_status($memcache, 'memcache_host', 11211);

?>

Siehe auch

Memcache::addServer() - Add a memcached server to connection pool
Memcache::setServerParams() - Changes server parameters and status at runtime

add a note

User Contributed Notes 2 notes

down

tom at all dash community dot de ¶

12 years ago


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

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

down

geoffrey dot hoffman at gmail dot com ¶

14 years ago


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