环境准备
- CentOS/RHEL 7+、PHP 7.4+、已安装
php-devel、gcc、make
- 区分两个扩展:
memcache:旧扩展,功能少,不推荐新项目使用
memcached (基于 libmemcached):功能全、性能强、支持二进制协议、SASL、一致性哈希
步骤 1:安装 libmemcached 库
# 下载最新稳定版 (https://launchpad.net/libmemcached/+download)
cd /tmp
wget https://launchpad.net/libmemcached/1.0/1.0.18/+download/libmemcached-1.0.18.tar.gz
tar zxf libmemcached-1.0.18.tar.gz
cd libmemcached-1.0.18
./configure --prefix=/usr/local/libmemcached
make && make install
步骤 2:安装 php-memcached 扩展
# 通过 PECL 安装(自动下载编译)
pecl install memcached
# 交互提示:
# enable memcached sasl support? [no] : no
# enable memcached session handler? [yes] : yes
# enable memcached igbinary support? [no] : yes # 推荐开启高效序列化
# enable memcached json support? [no] : yes
# libmemcached directory? [autodetect] : /usr/local/libmemcached
# 或手动编译指定版本
cd /usr/src/php
wget https://pecl.php.net/get/memcached-3.2.0.tgz
tar xf memcached-3.2.0.tgz
cd memcached-3.2.0
phpize
./configure --with-php-config=/usr/local/php/bin/php-config \
--with-libmemcached-dir=/usr/local/libmemcached \
--enable-memcached-json --enable-memcached-igbinary
make && make install
步骤 3:配置 php.ini
; 找到 extension_dir,确认 memcached.so 已复制过去
extension=memcached.so
[Memcached]
; 会话存储到 memcached
session.save_handler = memcached
session.save_path = "127.0.0.1:11211"
; 压缩阈值
memcached.compression_factor = 1.3
memcached.compression_threshold = 2000
memcached.compression_type = fastlz
; 序列化器
memcached.serializer = igbinary
; 连接池/超时
memcached.default_connect_timeout = 1000
memcached.default_retry_timeout = 1
验证安装
php -m | grep memcached
php -r 'new Memcached(); echo "OK\n";'
常见报错解决
configure: error: libmemcached not found → 指定 --with-libmemcached-dir 或 PKG_CONFIG_PATH
undefined symbol: sasl_client_start → 安装 cyrus-sasl-devel 并重新编译 libmemcached
igbinary not found → pecl install igbinary 并 extension=igbinary.so 在 memcached 之前加载