Amazon Linux 2 PHP8安装php-memcached依赖报错解决方案

你遇到的依赖报错是版本不匹配导致：当前EPEL源提供的php-pecl-memcached 2.2.0及配套的igbinary、msgpack扩展都是适配PHP5/PHP7的旧版本，要求的zend-abi、api版本和PHP8.0对应的20200930-64版本完全不兼容。不需要等待Amazon官方源或EPEL源更新，这两个源的PHP扩展更新周期普遍很长，有成熟可落地的解决方案。

按生产环境可用性、安全性从高到低排序：

方案1：通过PECL编译安装（最稳妥，推荐生产环境使用） #

PECL是PHP官方的扩展托管平台，所有扩展源码经过官方校验，编译时会自动匹配你当前服务器的PHP环境，不会出现依赖冲突，步骤如下：

• 先安装编译所需的依赖

sudo yum install php-devel php-pear libmemcached-devel gcc make zlib-devel cyrus-sasl-devel

• 安装memcached依赖的高性能序列化扩展igbinary、msgpack

sudo pecl install igbinary msgpack

安装完成后执行以下命令写入扩展配置：

echo "extension=igbinary.so" | sudo tee /etc/php.d/40-igbinary.ini
echo "extension=msgpack.so" | sudo tee /etc/php.d/40-msgpack.ini

• 安装适配PHP8的memcached 3.2.0稳定版

sudo pecl install memcached-3.2.0

编译过程中遇到交互提示直接按回车选择默认配置即可，编译程序会自动检测系统内已安装的libmemcached、igbinary、msgpack依赖。

• 写入memcached扩展配置

echo "extension=memcached.so" | sudo tee /etc/php.d/50-memcached.ini

• 验证安装结果
  命令行执行php -m | grep memcached，如果输出memcached即代表安装成功，也可以执行php --ri memcached查看扩展版本，确认是3.2.0版本即可。如果是web场景使用PHP，记得重启php-fpm进程让扩展生效。

方案2：通过知名第三方RPM源安装（操作简单，适合测试/非核心生产环境） #

REMI是PHP生态内维护超过10年的知名第三方软件源，长期维护各版本PHP的适配扩展，被大量生产环境验证过安全性，收录了适配PHP8.0的memcached 3.2.0预编译包，操作步骤如下：

• 安装对应Amazon Linux 2（兼容RHEL7版本）的REMI源安装包
• 执行安装命令时临时禁用EPEL源，避免拉到旧版本的不兼容包，从REMI源的PHP8.0仓库安装php-pecl-memcached及配套的igbinary、msgpack扩展
• 安装完成后重启php-fpm，执行php -m | grep memcached验证加载状态即可。

• 不需要等官方源更新，Amazon Linux 2的extra源和EPEL源对PHP新版本扩展的跟进速度普遍滞后3-6个月，等待官方更新效率极低。
• 上述两个方案的安全性都有保障：PECL是PHP官方扩展仓库，所有发布的包都经过官方安全审核；REMI源是社区公认的可信第三方源，不存在恶意代码风险。
• 不要从不知名个人仓库、随机资源站下载预编译的memcached扩展包，这类未经过社区验证的包可能植入恶意代码，存在服务器入侵风险。

如果之前尝试安装过旧版本的memcached相关包，先执行sudo yum remove php-pecl-memcached php-pecl-igbinary php-pecl-msgpack清理旧包和残留配置，避免出现扩展加载冲突。如果服务器上同时存在多个PHP版本，执行pecl命令时要确认调用的是PHP8.0对应的pecl版本，避免把扩展装到其他PHP版本目录下。

内容的提问来源于stack exchange，提问作者Seth H