萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 安装 memcached 扩展完整指南:libmemcached、pecl、php.ini 配置

环境准备

  • 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 之前加载
copyright © 萬盛學電腦網 all rights reserved