PDO不能直接连接Cassandra——PHP官方无pdo_cassandra驱动，new PDO('cassandra:host=...')必报Invalid data source name错误；唯一可靠路径是DataStax官方php-driver v1.7.5或更低版本，需匹配libuv≤1.44、禁用--enable-openssl，并用Cassandra::quoted()防注入。

PDO 不能直接连接 Cassandra —— PHP 官方没有 pdo_cassandra 驱动，所有 new PDO('cassandra:host=...') 写法都会报 Invalid data source name 错误。你真正可用的路径只有两条：DataStax 官方 C 扩展（推荐），或旧版 Thrift 封装库（如 phpcassa）。PHP 7.2 下，前者更可控、更贴近 Cassandra 4.0 原生能力。

用 DataStax php-driver 连接 Cassandra 4.0（PHP 7.2）

这是目前最可靠的方式，但必须严格匹配版本：

• 必须使用 php-driver v1.7.5 或更低（v1.8+ 要求 PHP ≥7.4）
• 编译时需指定 libuv≤1.44，否则运行时可能 segfault
• 禁用 --enable-openssl（PHP 7.2 自带 OpenSSL 与驱动 TLS 实现有兼容问题）
• 安装后运行 php -m | grep cassandra，应输出 cassandra

验证连通性后，最小连接代码如下：

<?php
$cluster = Cassandra::cluster()
    ->withContactPoints(['127.0.0.1'])
    ->withPort(9042)
    ->build();
$session = $cluster->connect('my_keyspace');
$result = $session->execute("SELECT * FROM users WHERE id = ?", [123]);
?>

注意：execute() 支持问号占位符，但**不是 prepare/bind 语义**——参数在客户端拼成字符串再发给服务端，不防 SQL 注入；复杂值建议手动用 Cassandra::quoted() 包裹。

为什么不能用 PDO 或 mysqli 风格写法

• PDO 是抽象层，依赖具体驱动实现；Cassandra 没有官方 pdo_cassandra，社区也无人维护
• mysqli 专为 MySQL 协议设计，与 Cassandra 的 CQL 协议完全不兼容
• 所有试图复用 PDO 接口的封装库（如 YACassandraPDO）都绕不开底层缺失，最终要么阉割功能（无 LWT、无分页上下文），要么崩溃

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

如果你已在项目中重度依赖 PDO 抽象，硬切到 Cassandra 类会带来明显侵入性——这不是配置问题，是协议和驱动生态的根本断层。

phpcassa 等 Thrift 封装库还能用吗

• phpcassa 基于已废弃的 Thrift RPC（端口 9160），Cassandra 4.0 默认**禁用 Thrift**，需手动开启且不被推荐
• 它依赖 ext-thrift_protocol，该扩展早已停止更新，PHP 7.2 下编译成功率极低
• 即便跑通，也不支持 CQLv4+ 特性（如集合类型、UDT、物化视图）

立即学习“PHP免费学习笔记（深入）”；

除非你维护的是 2012 年遗留系统且无法升级 Cassandra，否则不要选这条路。

连接参数里最容易错的三个地方

• contact_points 写成域名但未配 DNS 或 /etc/hosts，导致 Connection refused（建议先用 telnet 127.0.0.1 9042 测试端口）
• keyspace 名称大小写敏感，且必须提前用 cqlsh 创建好，否则 connect() 抛 Keyspace 'xxx' does not exist
• 未关闭防火墙或云服务器安全组限制了 9042 端口，现象是连接超时而非拒绝

Cassandra 的连接不像 MySQL 那样“试一下就知道”，它对网络拓扑、权限、预置 schema 的要求是刚性的。别跳过 cqlsh -u username -p password -k my_keyspace 这一步直连验证。