phpEnv 下连接 Oracle 必须手动安装 Oracle Instant Client 并配置 oci8 扩展：下载匹配架构和版本的 Instant Client ZIP 包，解压并添加路径到系统 PATH；下载对应 PHP 版本的 php_oci8.dll 放入 ext 目录，修改 php.ini 启用扩展；连接时使用 Easy Connect 格式字符串，确保监听开启、防火墙放行，并验证 CLI 与 Web 环境使用同一份 php.ini。
phpEnv 是 Windows 下的 PHP 多版本环境管理工具，它本身不提供 Oracle 客户端，也不能自动配置 oci8；想让它连 Oracle，必须手动装 Oracle Instant Client 并正确挂载到 phpEnv 所用的 PHP 版本里——否则 oci_connect() 一定失败，报错通常是 Call to undefined function oci_connect() 或静默返回 false。
phpEnv 环境下必须手动部署 Oracle Instant Client
phpEnv 不像 XAMPP 或 WAMP 那样预集成 Oracle 支持。它只管理 PHP 二进制和 php.ini，所有扩展依赖都得你来补全。
- 去 Oracle 官网下载匹配你 PHP 架构（x64 / x86）和版本（如 PHP 8.2 → Instant Client 21.x 最稳）的 ZIP 包：
instantclient-basic-windows.x64-21.12.0.0.0dbru.zip和instantclient-sdk-windows.x64-21.12.0.0.0dbru.zip - 解压到固定路径，例如
C:\oracle\instantclient_21_12，确保里面含oci.dll、oraocci21.dll、oraocci21d.dll（调试版）等文件 - 把该路径加进系统环境变量
PATH（不是LD_LIBRARY_PATH，Windows 不认这个），重启命令行或 IDE 让变量生效 - 验证是否就位：在 CMD 中运行
where oci.dll，应能定位到你刚解压的目录
phpEnv 中启用 oci8 扩展的三步硬操作
phpEnv 自带的 PHP 编译包默认不含 oci8，你必须用官方预编译 DLL 替换或补充。
- 确认你用的 PHP 版本（如
phpenv local 8.2.12），然后去 pecl.php.net 的 oci8 Windows 发布页 下载对应版本的php_oci8.dll（注意匹配 TS/NTS 和架构） - 把下载的
php_oci8.dll放进 phpEnv 对应版本的ext/目录，例如C:\phpenv\versions\8.2.12\ext\php_oci8.dll - 编辑该版本的
php.ini（路径类似C:\phpenv\versions\8.2.12\php.ini），添加：extension=php_oci8.dlloci8.default_prefetch = 100oci8.events = On - 执行
phpenv exec php --ri oci8，输出中必须有OCI8 Support => enabled且Version => 21.12（与 Instant Client 主版本一致）
oci_connect() 在 phpEnv 下连不上？先查这四个点
即使扩展加载成功，oci_connect() 仍可能返回 false 且无错误——这是 Windows + phpEnv 组合最典型的静默失败场景。
立即学习“PHP免费学习笔记（深入）”；
- 连接字符串格式必须是 Easy Connect：例如
//192.168.1.100:1521/ORCLPDB1（服务名）或//db-host:1521/XE（XE 默认实例），避免用 TNSNAMES.ORA 文件方式（phpEnv 默认不读取） - 用户名密码区分大小写，且用户必须已授权
CREATE SESSION；测试时优先用SYSTEM或SYS AS SYSDBA排查权限问题 - Oracle 数据库监听必须开启，且防火墙放行对应端口（默认 1521）；可在 CMD 运行
tnsping //192.168.1.100:1521/ORCLPDB1验证网络和解析 - 若仍失败，在 PHP 脚本开头加
error_reporting(E_ALL); ini_set('display_errors', 1);，连接后立刻调用var_dump(oci_error());——oci8.events = On没开的话，这里永远拿不到真实 ORA 错误码
最易被忽略的是：phpEnv 启动的 CLI 和 Web（如 Apache/Nginx）用的是两套 php.ini，改完必须确认你测试的是同一份配置；phpinfo() 页面里的 Loaded Configuration File 路径，才是 Web 端真正读的那份。
