memcacheq 是一個輕量級、高效能的分散式訊息佇列服務,協議與 memcached 相容(支援 set/get/stats),後端採用 Berkeley DB 持久化儲存,重啟不丟資料,專為高併發 Web 應用的非同步處理設計(如訂單寫入、日誌收集、快取刷新)。
傳統 MQ 為實現 AMQP/STOMP/XMPP 協議,架構重、依賴多、運維複雜。Web 應用多數只需「削峰填谷」的簡單佇列,memcacheq 以極簡協議、極高吞吐、極低延遲完美切中痛點。
# 1. libevent (若已裝 memcached 通常已有)
yum install libevent libevent-devel
# 2. Berkeley DB 5.3 編譯安裝
wget https://download.oracle.com/berkeley-db/db-5.3.28.tar.gz
tar zxvf db-5.3.28.tar.gz
cd db-5.3.28/build_unix
../dist/configure --prefix=/usr/local/berkeleydb
make && make install
# 關鍵:加入動態連結庫路徑
echo "/usr/local/berkeleydb/lib" >> /etc/ld.so.conf
ldconfig
wget https://github.com/memcacheq/memcacheq/archive/refs/tags/0.2.0.tar.gz -O memcacheq-0.2.0.tar.gz
tar zxvf memcacheq-0.2.0.tar.gz
cd memcacheq-0.2.0
# 關鍵:指定 BDB 與 libevent 路徑
./configure --with-bdb=/usr/local/berkeleydb --with-libevent=/usr/local --enable-threads
make && make install
⚠️ 關鍵點:
--with-bdb路徑必須指向 Berkeley DB 的 安裝前綴(含 lib/、include/),而非 source 目錄。路徑錯誤會導致make失敗或執行時找不到libdb-5.3.so。
memcacheq -d -r -u root -p 21201 -H /data/memcacheq -N -v -L 1024 -B 1024 > /data/mq_error.log 2>&1
| 參數 | 說明 |
|---|---|
| -d | 守護程序模式 |
| -r | 最大化 core dump 限制 |
| -u <user> | 指定執行使用者(建議非 root) |
| -p <port> | TCP 監聽埠(預設 22201) |
| -H <dir> | 資料庫家目錄(預設 /data1/memcacheq) |
| -N | 啟用 DB_TXN_NOSYNC,極大提升寫入效能 |
| -v | 詳細輸出錯誤/警告 |
| -L <KB> | 日誌緩衝區大小(預設 32KB) |
| -B <bytes> | 單則訊息最大長度(預設 1024 bytes) |
| -R | 自動清理不再需要的日誌檔 |
# 建立專用使用者
useradd -r -s /sbin/nologin memcacheq
mkdir -p /data/memcacheq && chown memcacheq:memcacheq /data/memcacheq
# 啟動(建議寫入 systemd service)
memcacheq -d -u memcacheq -r -p 11212 -H /data/memcacheq -N -R -v -L 1024 -B 1024 > /var/log/memcacheq.log 2>&1
telnet 127.0.0.1 22201
# 或
telnet 127.0.0.1 11212
# 進入後測試
set q1 0 0 5
hello
STORED
get q1
VALUE q1 0 5
hello
END
stats queue
STAT q1 1/0
END
connect('127.0.0.1', 11212) or die("Connect failed");
// 寫入佇列
$mcq->set('order_queue', '{"order_id":1001,"action":"create"}', 0, 0);
// 讀取佇列
$msg = $mcq->get('order_queue');
echo "Queue: $msg\n";
$mcq->close();
?>
libdb-5.3.so: cannot open shared object fileldconfig 或 /etc/ld.so.conf 路徑錯誤。檢查 ldd /usr/local/bin/memcacheq 確認庫路徑。not_STORED-B 參數限制訊息長度,預設 1024 bytes。大訊息需調大 -B 65535。-N(NOSYNC)、-R(自動清理日誌),-L 設 1024KB 以上,-t 設為 CPU 核心數。memcacheq 以「極簡協議 + 持久化 + 高併發」三大特性,成為 Web 高併發非同步處理的最佳輕量選擇。關鍵在於:正確編譯 Berkeley DB、正確指定 -H/-B/-N 參數、使用專用使用者運行。