Cassandra扩展1.3.4不支持PHP8，需手动编译适配；须安装≥2.15.0的cpp-driver及≥1.44.0的libuv；zval宏需替换为PHP8兼容写法，或改用php8-support分支；也可切换为pdo_cassandra驱动。
确认Cassandra扩展与PHP8兼容性
PHP8连Cassandra报错，首要排查点是扩展本身是否支持PHP8——官方pecl.php.net上cassandra扩展最新稳定版（1.3.4）仅明确支持至PHP7.4，【PHP8.0+需手动编译适配，直接启用.so会触发CompileError或Segmentation Fault】。访问 http://pecl.php.net/package/cassandra 查看“Supported PHP versions”字段，若未列出8.0及以上，说明该版本未经官方PHP8 ABI验证。
跳过此步直接编译，大概率在phpize阶段失败或运行时崩溃。
解决 configure 阶段的 cpp-driver 依赖缺失
执行 ./configure 时若报错 “checking for supported DataStax C/C++ driver version … cannot open file `/include/cassandra.h'”，说明系统缺少cpp-driver头文件。这不是简单 yum install 能解决的，必须源码编译安装：
方法一：使用系统包管理器（仅限CentOS 8+/RHEL 8+）yum install cassandra-cpp-driver-devel —— 若仓库存在且版本≥2.15.0，可跳过后续步骤。
方法二：源码编译（通用方案）
① 进入 /usr/local/src 目录
② git clone --branch v2.16.0 https://github.com/datastax/cpp-driver.git
③ mkdir cpp-driver/build && cd cpp-driver/build
④ cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo -DBUILD_SHARED_LIBS=ON ..
⑤ make -j$(nproc) && make install
【注意：必须指定 -DBUILD_SHARED_LIBS=ON，否则PHP扩展加载时找不到动态符号】
修复 libuv 版本冲突导致的 uv_print_all_handles 未声明错误
报错 “‘uv_print_all_handles’ was not declared in this scope” 是典型 libuv 版本不匹配：cpp-driver v2.16.0 要求 libuv ≥1.44.0，而 CentOS 默认源仅提供 1.40.x。强行用旧版编译会导致 event_loop.cpp 第63行调用失败。
立即学习“PHP免费学习笔记（深入）”；
执行以下命令升级 libuv：wget https://github.com/libuv/libuv/archive/refs/tags/v1.46.0.tar.gztar -xzf v1.46.0.tar.gzcd libuv-1.46.0sh autogen.sh && ./configure --prefix=/usr && make && sudo make installldconfig
这一步做完再重新编译 cpp-driver，否则 configure 通过、make 也会卡在 event_loop.cpp。
绕过 PHP8 的 zval 结构变更引发的编译失败
PHP8 重写了 zval 内存布局，cassandra 扩展旧版源码中大量使用 Z_STRVAL_P、Z_STRLEN_P 等宏，在 PHP8 下已废弃。若 configure 通过但 make 报错 “unknown type name ‘znode_op’” 或 “‘Z_TYPE’ undeclared”，说明扩展未适配 PHP8 zval API。
临时解决方案（仅开发测试）：
编辑 cassandra-1.3.4/src/php_cassandra.c 文件，将所有 Z_STRVAL_P(zv) 替换为 Z_STRVAL(*zv)，Z_STRLEN_P(zv) 替换为 Z_STRLEN(*zv)，Z_TYPE_P(zv) 替换为 Z_TYPE(*zv)。
【警告：此修改不保证运行时稳定性，仅用于快速验证连接通路；生产环境必须使用已适配PHP8的扩展分支】
更稳妥做法：改用社区维护的 php-cassandra 分支，例如 github.com/Orange-OpenSource/php-cassandra/tree/php8-support，该分支已重构 zval 操作逻辑并修复内存泄漏。
启用 PDO Cassandra 驱动替代原生扩展
若上述编译始终失败，可切换技术路线：放弃原生 cassandra.so，改用 PDO 方式连接。需安装 pdo_cassandra 驱动（非 pecl 包，需单独编译）：
① 克隆驱动源码：git clone https://github.com/datastax/php-pdo-cassandra.git
② 进入目录执行：/usr/local/php/bin/phpize && ./configure --with-php-config=/usr/local/php/bin/php-config --with-cassandra-dir=/usr
③ make && make install
④ 编辑 php.ini，添加：extension=pdo_cassandra.so 和 pdo.cassandra.default_timeout=5
连接代码改为：$pdo = new PDO('cassandra:host=127.0.0.1;port=9042', '', '', [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
