2008年12月16日

PHP中的Memcache函數庫(Memcache Functions)

Memcache函數庫是在PECL(PHP Extension Community Library)中,主要作用是搭建大容量的內存數據的臨時存放區域,在分佈式的時候作用體現的非常明顯,否則不建議使用。

《phper》電子雜誌的第一期中,有黑夜路人寫的關於Memcache的詳細安裝教程,本人在ubuntu上安裝完運行的時候報錯:
/usr/local/memcached/bin/memcached: error while loading shared libraries: libevent-1.4.so.2: cannot open shared object file: No such file or directory

按照:《libeven、memcached、libmemcache安裝》中的方法,使用:

sudo ln -s /usr/local/lib/libevent-1.4.so.2 /usr/lib/libevent-1.4.so.2

可以修正這個BUG

通過新得立安裝php的memcached模塊,註銷/etc/php5/conf.d/memcached.ini裡面的「;」,重啟apache,調用phpinfo()出現memcached的信息

執行:

/usr/local/bin/memcached -d -m 10 -u root -l 127.0.0.1 -p 11211 -c 256 -P /tmp/memcached.pid

memcached的服務正式啟動

Memcache::add — 添加一個值,如果已經存在,則返回false
Memcache::addServer — 添加一個可供使用的服務器地址
Memcache::close — 關閉一個Memcache對象
Memcache::connect — 創建一個Memcache對象
memcache_debug — 控制調試功能
Memcache::decrement — 對保存的某個key中的值進行減法操作
Memcache::delete — 刪除一個key值
Memcache::flush — 清除所有緩存的數據
Memcache::get — 獲取一個key值
Memcache::getExtendedStats — 獲取進程池中所有進程的運行系統統計
Memcache::getServerStatus — 獲取運行服務器的參數
Memcache::getStats — 返回服務器的一些運行統計信息
Memcache::getVersion — 返回運行的Memcache的版本信息
Memcache::increment — 對保存的某個key中的值進行加法操作
Memcache::pconnect — 創建一個Memcache的持久連接對象
Memcache::replace — R對一個已有的key進行覆寫操作
Memcache::set — 添加一個值,如果已經存在,則覆寫
Memcache::setCompressThreshold — 對大於某一大小的數據進行壓縮
Memcache::setServerParams — 在運行時修改服務器的參數

建議用面向對象的方式來測試這個庫:


$memcache = new Memcache;
$memcache->connect('localhost', 11211) or die ("Could not connect");
$version = $memcache->getVersion();
echo "Server's version: ".$version."
\n";
?>

Memcache::getVersion方法的作用是返回運行的Memcache的版本信息。

Memcache::getStats 方法的作用是返回服務器的一些運行統計信息。Memcache::getStats方法有三個參數,第一個參數表示要求返回的類型:reset, malloc, maps, cachedump, slabs, items, sizes;第二個參數和第三個參數是在第一個參數設置為「cachedump」時使用的。Memcache::getExtendedStats方法的 作用是獲取進程池中所有進程的運行系統統計。


$memcache = new Memcache;
$memcache->connect('localhost', 11211) or die ("Could not connect");
print_r($memcache->getStats());
/**
* Array
* (
* [pid] => 8052
* [uptime] => 9205
* [time] => 1205898428
* [version] => 1.2.5
* [pointer_size] => 32
* [rusage_user] => 0.008000
* [rusage_system] => 0.000000
* [curr_items] => 1
* [total_items] => 17
* [bytes] => 57
* [curr_connections] => 2
* [total_connections] => 15
* [connection_structures] => 3
* [cmd_get] => 9
* [cmd_set] => 23
* [get_hits] => 5
* [get_misses] => 4
* [evictions] => 0
* [bytes_read] => 671
* [bytes_written] => 850
* [limit_maxbytes] => 10485760
* [threads] => 1
* )
*/

?>

Memcache::connect方法的作用是創建一個Memcache對象。Memcache::pconnect方法的作用是創建一個Memcache的持久連接對象。Memcache::close方法的作用是關閉一個Memcache對象。

Memcache::set 方法的作用是添加一個值,Memcache::set方法有四個參數,第一個參數是key,第二個參數是value,第三個參數可選,表示是否壓縮保存, 第四個參數可選,用來設置一個過期自動銷毀的時間。Memcache::add方法的作用和Memcache::set方法類似,區別是如果 Memcache::add方法的返回值為false,表示這個key已經存在,而Memcache::set方法則會直接覆寫。 Memcache::get方法的作用是獲取一個key值,Memcache::get方法有一個參數,表示key。Memcache::replace 方法的作用是對一個已有的key進行覆寫操作,Memcache::replace方法有四個參數,作用和Memcache::set方法的相同。 Memcache::delete方法的作用是刪除一個key值,Memcache::delete方法有兩個參數,第一個參數表示key,第二個參數可 選,表示刪除延遲的時間。


$memcache = new Memcache;
$memcache->connect('localhost', 11211) or die ("Could not connect");
$memcache->set( 'name', 'leo', 0, 30);
if(!$memcache->add( 'name', 'susan', 0, 30))
{
echo 'susan is exist';
};
$memcache->replace( 'name', 'lion', 0, 300);
echo $memcache->get( 'name');
$memcache->delete( 'name', 5);
?>

memcache_debug()函數的作用是控制調試功能,前提是php在編譯的時候使用了–enable-debug選項,否則這個函數不會有作用。

Memcache::addServer 方法的作用是添加一個可供使用的服務器地址,Memcache::addServer方法有8個參數,除了第一個參數意外,其他都是可選的,第一個參數表 示服務器的地址,第二個參數表示端口,第三個參數表示是否是一個持久連接,第四個參數表示這台服務器在所有服務器中所佔的權重,第五個參數表示連接的持續 時間,第六個參數表示連接重試的間隔時間,默認為15,設置為-1表示不進行重試,第七個參數用來控制服務器的在線狀態,第8個參數允許設置一個回掉函數 來處理錯誤信息。
Memcache::setServerParams方法的作用是在運行時修改服務器的參 數,Memcache::setServerParams方法有六個參數,Memcache::addServer方法少了第三和第四個參數。 Memcache::getServerStatus方法的作用是獲取運行服務器的參數,兩個參數分別表示的地址和端口。


function _callback_memcache_failure($host, $port) {
print "memcache '$host:$port' failed";
}
$memcache = new Memcache;
$memcache->addServer('192.168.1.116', 11211);
$memcache->setServerParams('192.168.1.116', 11211, 1, 15, true, '_callback_memcache_failure');
echo $memcache->getServerStatus('192.168.1.116', 11211);
?>

Memcache::flush方法的作用是清除所有緩存的數據,但是不會削去使用的內存空間。

Memcache::increment方法的作用是對保存的某個key中的值進行加法操作,Memcache::decremen方法的作用是對保存的某個key中的值進行減法操作。


$memcache = new Memcache;
$memcache->connect('localhost', 11211);
$memcache->set('test_item', 8);
$memcache->increment('test_item', 4);
echo $memcache->decrement('test_item', 7);
// 顯示 5
?>

setCompressThreshold方法的作用是對大於某一大小的數據進行壓縮。setCompressThreshold方法有兩個參數,第一個參數表示處理數據大小的臨界點,第二個參數表示壓縮的比例,默認為0.2。


$memcache = new Memcache;
$memcache->addServer('memcache_host', 11211);
$memcache->setCompressThreshold(20000, 0.2);
?>



Memcache


轉自:http://www.csask.com/