启用igbinary作为php-redis序列化器时WordPress触发致命错误求助

环境信息 #

• 系统：Debian 11
• 组件版本：lighttpd 1.4.69、PHP-fpm 8.2.3、MariaDB 10.5.18、php-redis 5.3.7（已启用lz4压缩）、Object Cache Pro插件
• PHP配置：igbinary 3.2.13已启用，php-redis支持php/json/igbinary三种序列化器，会话序列化处理器设为igbinary

问题情况 #

使用默认PHP序列化器时网站运行正常，但在WP_REDIS_CONFIG中设置'serializer' => 'igbinary'后，WordPress触发致命错误，报错栈指向WP_Roles相关代码；已尝试停用所有插件、调整Redis参数，问题未解决。

排查修复步骤 #

1. 清空Redis缓存，消除新旧序列化数据冲突 #

旧的PHP序列化缓存与igbinary序列化数据混合会引发兼容性问题，先清空Redis所有缓存：

redis-cli FLUSHALL

清空后重启PHP-FPM和lighttpd：

systemctl restart php8.2-fpm
systemctl restart lighttpd

2. 测试igbinary对WP_Roles对象的序列化支持 #

WordPress的WP_Roles类包含WP_Role等特殊实例，可能与igbinary存在兼容性问题。创建测试脚本验证：
在网站根目录新建test-igbinary.php：

<?php
require_once('wp-load.php');
$roles = wp_roles();
// 序列化WP_Roles对象
$serialized = igbinary_serialize($roles);
// 反序列化验证
$unserialized = igbinary_unserialize($serialized);
var_dump($unserialized);

访问该脚本，若触发错误，说明igbinary对WP_Roles的序列化存在问题。可尝试更新igbinary至最新版本：
Debian 11的apt源版本偏旧，通过PECL安装新版：

pecl install igbinary

安装后修改php.ini，确保extension=igbinary.so优先于redis.so加载（redis依赖igbinary），随后重启PHP-FPM。

3. 调整Object Cache Pro配置 #

部分版本的Object Cache Pro需显式开启igbinary支持，在配置中添加'igbinary' => true：

define('WP_REDIS_CONFIG', [
    'serializer' => 'igbinary',
    'igbinary' => true,
    // 你的其他现有配置
]);

同时可临时关闭lz4压缩，排查是否为压缩与序列化的组合冲突：

define('WP_REDIS_CONFIG', [
    'serializer' => 'igbinary',
    'compression' => false,
    // 你的其他现有配置
]);

若关闭压缩后问题解决，说明lz4与igbinary存在兼容问题，可更换为gzip压缩或升级php-redis版本。

4. 确认php-redis对igbinary的支持 #

执行命令验证php-redis是否正确启用igbinary支持：

php -r "var_dump(extension_loaded('redis') && Redis::SERIALIZER_IGBINARY);"

输出bool(true)则为正常状态。若输出异常，重新安装php-redis与igbinary：

apt purge php-redis
apt install php-redis php-igbinary

同时检查扩展加载顺序，在/etc/php/8.2/fpm/conf.d/目录下，确保20-igbinary.ini在20-redis.ini之前（数字越小加载优先级越高）。

总结 #

优先通过清空缓存排除残留数据冲突，再验证igbinary对WP_Roles对象的序列化兼容性，最后调整插件配置与扩展加载顺序。若问题仍存在，可尝试升级php-redis或igbinary至兼容PHP 8.2的最新版本。

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