解读

在国内高并发、日志收集、实时大屏等场景下，Kafka 几乎成了消息队列的事实标准。面试官问“怎么装 RdKafka”，并不是让你背两条命令，而是想确认三件事：

1. 你是否真的在 Linux 生产环境装过扩展，而不是在 Windows 图形面板里点两下；
2. 你是否理解“PHP 扩展 + 系统库”两层依赖，以及版本对齐的重要性；
3. 你是否能把安装过程脚本化、可重复，符合 CI/CD 规范。
   答得过于简单（“pecl install rdkafka”）会被追问“如果 pecl 源被墙怎么办”“librdkafka 版本冲突怎么排查”；答得过于学术（“先编译 librdkafka 再编译扩展”）又会被质疑“线上敢不敢自己编”。因此，答案要给出“最小可落地”方案，同时预留“可回滚”空间。

知识点

1. 扩展与系统库关系：php-rdkafka 是 PHP 的 C 扩展，依赖系统级 librdkafka；两者主版本必须匹配（0.11.x/3.x、1.x/4.x、2.x/5.x）。
2. 国内镜像：pecl.php.net 常被墙，需配置国内镜像（腾讯、阿里云、清华）。
3. 包管理器优先级：CentOS 7/8 优先用 remi 源，Ubuntu 20.04+ 优先用 ondrej PPA，避免“编译救一切”的运维债。
4. 运行时验证：php -m | grep rdkafka、php --ri rdkafka、producer/consumer 连通性测试，三步缺一不可。
5. 容器化：官方 php:8.2-fpm-alpine 镜像缺少 librdkafka-dev，需写多阶段构建，保证“构建依赖”与“运行依赖”分离。
6. 回滚策略：扩展升级前先在预发布容器打 tag，保留旧 so 文件，通过 php.ini 里绝对路径切换，30 秒内可回滚。

答案

以 CentOS 7 + PHP 8.2 + php-rdkafka 6.0（对应 librdkafka 1.x）为例，给出一条可直接写进 Dockerfile 的脚本，兼顾“国内网络”与“版本锁定”：

# 1. 系统依赖：一次装好 dev 包与工具
yum install -y epel-release
yum install -y librdkafka1 librdkafka-devel gcc make autoconf

# 2. 配置国内 PECL 镜像，防止下载超时
pecl channel-update pecl.php.net
pecl config-set preferred_mirror pecl.php.net

# 3. 明确版本，避免“latest”带来的 ABI 断裂
pecl install rdkafka-6.0.3

# 4. 启用扩展，并写死绝对路径，方便回滚
echo "extension=/usr/lib64/php/modules/rdkafka.so" > /etc/php.d/50-rdkafka.ini

# 5. 验证三步走
php -m | grep rdkafka
php --ri rdkafka | head -5
php -r "
$conf = new RdKafka\Conf();
$conf->set('bootstrap.servers', '127.0.0.1:9092');
$producer = new RdKafka\Producer($conf);
$producer->addBrokers('127.0.0.1:9092');
echo 'OK'.PHP_EOL;
"

如果宿主机无法连外网，可提前在构建机下载 librdkafka-1.x-el7.x86_64.rpm 与 rdkafka-6.0.3.tgz，用 rpm -ivh 与 pecl install rdkafka-6.0.3.tgz 离线安装，保证 SHA256 校验一致即可。

拓展思考

1. 版本矩阵维护：把“PHP 版本—librdkafka 版本—rdkafka 扩展版本”写进内部 Wiki，每月由运维自动扫描 CVE，触发流水线重新构建镜像。
2. 非 root 安装：在共享开发机没有 sudo 权限时，可用 phpize && ./configure --with-php-config=$HOME/php/bin/php-config && make install 把扩展装到 $HOME/php/lib，通过 PHP_INI_SCAN_DIR 加载，避免污染全局环境。
3. 性能调优：生产环境打开 php.ini 中的 rdkafka.log_level=6 定位延迟，再关闭；使用 socket.keepalive.enable=true 与 queue.buffering.max.ms=10 降低长尾延迟。
4. 与 Swoole 共存：Swoole 的 hook 会替换底层 socket，需在 swoole.use_shortname=off 的情况下，先加载 rdkafka，再加载 swoole，防止符号冲突导致 core dump。
5. 故障演练：在测试环境周期性使用 tc qdisc 模拟 5% 丢包，验证 PHP 长连接重试参数 metadata.max.age.ms 与 retry.backoff.ms 是否合理，确保真正网络抖动时不会堆积消息或耗尽 FD。