Memcache::getServerStatus
(PECL memcache >= 2.1.0)
Memcache::getServerStatus — Returns server status
Description
int Memcache::getServerStatus
( string
$host
[, int $port
= 11211
] )Memcache::getServerStatus() returns a the servers online/offline status. You can also use memcache_get_server_status() function.
Note:
This function has been added to Memcache version 2.1.0.
Parameters
-
host
-
Point to the host where memcached is listening for connections.
-
port
-
Point to the port where memcached is listening for connections.
Return Values
Returns a the servers status. 0 if server is failed, non-zero otherwise
Examples
Example #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);
?>
See Also
- Memcache::addServer() - Add a memcached server to connection pool
- Memcache::setServerParams() - Changes server parameters and status at runtime
- Функция Memcache::add() - Add an item to the server
- Функция Memcache::addServer() - Add a memcached server to connection pool
- Функция Memcache::close() - Close memcached server connection
- Функция Memcache::connect() - Open memcached server connection
- Функция Memcache::decrement() - Decrement item's value
- Функция Memcache::delete() - Delete item from the server
- Функция Memcache::flush() - Flush all existing items at the server
- Функция Memcache::get() - Retrieve item from the server
- Функция Memcache::getExtendedStats() - Get statistics from all servers in pool
- Функция Memcache::getServerStatus() - Returns server status
- Функция Memcache::getStats() - Get statistics of the server
- Функция Memcache::getVersion() - Return version of the server
- Функция Memcache::increment() - Increment item's value
- Функция Memcache::pconnect() - Open memcached server persistent connection
- Функция Memcache::replace() - Replace value of the existing item
- Функция Memcache::set() - Store data at the server
- Функция Memcache::setCompressThreshold() - Enable automatic compression of large values
- Функция Memcache::setServerParams() - Changes server parameters and status at runtime
Коментарии
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.
Note: the result of the function is cached. The cached is not automatically refreshed.
Call MemCache::getExtendedStats() to force a cache-update.