phpEnv 不支持安装或管理 Cassandra，因其仅提供 PHP 运行时环境隔离，不包含 Java 运行时、Cassandra 服务及驱动编译支持；需独立部署 Cassandra 并通过 Composer 安装 DataStax PHP Driver 实现连接。
phpEnv 本身**不支持直接安装或管理 Cassandra**。它是一个用于在 Windows 上快速切换 PHP 版本和扩展的本地开发环境工具（类似 XAMPP 的轻量替代），核心能力仅限于 PHP 解释器、Apache/Nginx 和常见扩展（如 pdo_mysql、redis），**不包含数据库服务管理功能**，更不内置 Cassandra 服务或驱动编译支持。
你真正需要的是：**独立部署 Cassandra 服务 + 手动集成 PHP 驱动**。下面直说怎么做、为什么这么干、以及最容易卡住的地方。
为什么 phpEnv 无法“安装 Cassandra”
phpEnv 的设计目标是 PHP 运行时环境隔离，不是数据库平台。它不提供：
– Java 运行时（Cassandra 是 Java 应用）
– cassandra 命令行服务管理
– pecl install cassandra 所需的 C 编译链（Windows 下尤其难配）
– php-cassandra 扩展的预编译 DLL（官方未发布 Windows 兼容版）
Windows 下连上本地 Cassandra 的可行路径
绕过 phpEnv 的限制，用最简方式打通 PHP ↔ Cassandra：
- 单独下载并运行 Cassandra：从 cassandra.apache.org/download/ 获取最新
apache-cassandra-x.x.x-bin.tar.gz，解压后双击bin\cassandra.bat启动（确保已装 JDK 8+） - 确认服务跑起来：
curl -X GET http://127.0.0.1:9042应返回空响应（端口通）；用cqlsh连：bin\cqlsh.bat - PHP 驱动只能走 DataStax 官方 PHP Driver（
datastax/php-driver），必须用 Composer 安装：composer require datastax/php-driver - 代码里不能用
new CassandraConnection()这类不存在的类——正确入口是：Cassandra::cluster()->withContactPoints('127.0.0.1')->build() - phpEnv 的
php.ini不需要加任何 Cassandra 相关 extension 行，因为该驱动是纯 PHP 实现（基于 cURL + socket），不依赖cassandra.so或 DLL
连接失败时先查这三件事
90% 的“连不上”问题出在这几个硬性前提上：
- Cassandra 必须已启动且监听
rpc_address: 127.0.0.1（检查conf\cassandra.yaml中的rpc_address和start_rpc: true） - 防火墙/杀软没拦截 9042 端口（Windows Defender 默认会拦）
- PHP 脚本执行用户（比如 phpEnv 用的
www-data或当前 Windows 用户）能访问网络——某些公司内网策略会禁用 localhost 外部连接 - 别信网上那些
pecl install cassandra在 Windows 成功的截图，那是旧版（2017 年前）且严重依赖 Visual Studio 工具链，现在基本不可复现
Keyspace 和表操作必须手动初始化
PHP 驱动不帮你建库建表，所有 DDL 都得自己写 CQL 并 $session->execute()：
立即学习“PHP免费学习笔记（深入）”；
$session->execute("CREATE KEYSPACE IF NOT EXISTS demo WITH replication = {'class': 'SimpleStrategy', 'replication_factor': 1};");
$session->execute("USE demo;");
$session->execute("CREATE TABLE IF NOT EXISTS users (id UUID PRIMARY KEY, name TEXT, email TEXT);");
注意：IF NOT EXISTS 很关键——Cassandra 对重复建表会抛 Cassandra\Exception\RuntimeException，不是 MySQL 那种警告。
Cassandra\Cluster 配置里，而不是靠 phpEnv 这类前端工具去“配置”。别试图让环境工具越界做事，先确保 Java 服务、网络、CQL 权限这三层稳了，PHP 层反而最简单。 
