PHP 8.5.5 连 Oracle 必须用 oci8 扩展，pdo_oci 已废弃；需匹配安装 Oracle Instant Client、正确配置 ORACLE_HOME 和 LD_LIBRARY_PATH、启用 oci8.events=On 并验证 libclntsh.so 加载，否则 oci_connect() 静默失败。
PHP 8.5.5 连 Oracle 数据库，必须用 oci8 扩展，pdo_oci 已彻底废弃（PHP 7.4+ 不再支持），装了也白装，报 Driver not found 是大概率事件。
oci8 扩展安装失败的典型表现和硬性前置条件
很多人卡在 pecl install oci8 报错，比如 undefined symbol: OCINlsGetInfo 或静默返回 false——这根本不是 PHP 的问题，而是 oci8 编译/运行时找不到 Oracle 客户端库。
- 必须下载匹配架构（x86_64 / aarch64）和主版本（如 21, 19, 12）的
oracle-instantclient-basic和oracle-instantclient-devel（RPM 或 ZIP） - 解压路径要统一，例如
/opt/oracle/instantclient_21_12，不能混用不同版本的 basic/devel - 设环境变量：
export ORACLE_HOME=/opt/oracle/instantclient_21_12，export LD_LIBRARY_PATH=/opt/oracle/instantclient_21_12:$LD_LIBRARY_PATH - 执行
ldconfig -p | grep oci，必须看到libclntsh.so；看不到就说明路径错、权限不足（需可执行）、或漏掉ldconfig刷新
php.ini 里漏掉这三项，oci_connect() 就会静默失败
oci_connect() 返回 false 却不报错？八成是 php.ini 配置没生效。默认情况下连 oci_error() 都捕获不到真实错误。
- 确认已启用：
extension=oci8.so（Linux）或extension=php_oci8.dll（Windows） - 必须设置连接行为：
oci8.default_prefetch = 100（防大结果集阻塞）、oci8.connection_class = "WEB"（后续启用 DRCP 时有用） - 调试阶段必开：
oci8.events = On——否则oci_error()拿不到ORA-12514这类关键信息 - 验证是否真生效：
php --ri oci8输出中要有OCI8 Support => enabled且Version与 Instant Client 主版本一致（如 21）
oci_connect() 连接字符串写法和常见坑
即使扩展和配置都对，oci_connect() 仍可能返回 false，问题常出在连接串解析、TNS 配置或数据库端权限上。
立即学习“PHP免费学习笔记（深入）”；
- 推荐用 Easy Connect 格式：
"//host:port/service_name"（Oracle 11g+），例如"//192.168.1.100:1521/XEPDB1"；避免依赖tnsnames.ora文件，除非你明确控制TNS_ADMIN路径 - 用户名密码必须是 Oracle 数据库实际存在的账号，且该用户需有
CREATE SESSION权限；SYSTEM或ADMIN用户默认有，普通用户需 DBA 显式授权 - 若用服务名连接失败，先在服务器上跑
tnsping XEPDB1或sqlplus user/pass@//host:port/service_name确认网络和监听通不通 - 字符集建议显式传参：
oci_connect($user, $pass, $conn_str, 'AL32UTF8')，避免依赖NLS_LANG环境变量导致乱码
oci_pconnect() 和 DRCP 连接池不是 PHP 配出来的
很多人以为改几行 PHP 就能“开启连接池”，其实 DRCP（Database Resident Connection Pooling）是 Oracle 数据库端的功能，PHP 只负责发带 :pooled 后缀的连接请求。
- 先在 Oracle 数据库里执行：
EXEC DBMS_CONNECTION_POOL.START_POOL();（需 DBA 权限） - PHP 连接串末尾加
:pooled，例如"//192.168.1.100:1521/XEPDB1:pooled"，再用oci_pconnect()或oci_connect()发起连接 - 检查池状态得查 Oracle 视图：
SELECT * FROM V$CPOOL_STATS;，PHP 侧无法直接观测池内连接数 - Alpine Linux 用户注意：
musl libc不兼容 RPM 版 Instant Client，必须用basiclite.zip+apk add oracle-instantclient-basiclite（部分镜像源才提供）
最易被忽略的是：oci8.events = On 必须开启，否则所有连接错误都会被吞掉；还有就是 ldconfig -p | grep oci 这一步，不验证就直接装扩展，90% 会栽在运行时找不到符号上。
