连不上Oracle先检查三件事：1.是否安装匹配版本的Oracle Instant Client并配置好环境变量；2.是否正确配置tnsnames.ora及TNS_ADMIN；3.用户是否解锁、密码大小写及特殊字符是否转义。
oci_connect() 连不上 Oracle，先检查这三件事
连不上不是代码写错了，大概率是环境没配对。PHP 用 Oracle 不像 MySQL 那么“开箱即用”，oci_connect() 失败时，90% 的情况卡在底层驱动或网络配置上。
-
Oracle 客户端必须装：PHP 的 OCI 扩展不自带 Oracle 库，得单独装 Oracle Instant Client（19c 或 21c 均可），且版本要和服务器兼容；只装 PHP 扩展
oci8是没用的 -
TNS 名称解析失败很常见：别硬写
//host:port/service_name，优先用本地tnsnames.ora配置，路径要加到TNS_ADMIN环境变量里（Linux 下常漏设） -
用户权限和密码策略要对得上：Oracle 12c+ 默认密码区分大小写，且账户可能被锁（
ALTER USER xxx ACCOUNT UNLOCK），连接时若报ORA-01017: invalid username/password，先确认是不是被锁或密码含特殊字符未转义
oci8 扩展启用后仍报 “Call to undefined function oci_connect()”
扩展加载成功 ≠ 函数可用。这个错误说明 PHP 进程根本没认出 oci_connect()，常见于多 SAPI 场景。
- CLI 和 Web（如 Apache/FPM）用的是两套
php.ini，extension=oci8.so（Linux）或extension=php_oci8_12c.dll（Windows）必须分别配好 - 扩展依赖 Oracle 客户端的共享库路径：
LD_LIBRARY_PATH（Linux）或PATH（Windows）里必须包含 Instant Client 的 bin 目录，否则扩展加载会静默失败 - 用
php -m | grep oci检查 CLI 是否生效；用phpinfo()页面确认 Web 环境是否真加载了 oci8 —— 很多人只测了命令行，上线就崩
OCI 连接字符串中 service_name、SID、PDB 名称怎么选
Oracle 12c 起引入 PDB，连接串稍不注意就连错实例或容器，报 ORA-12514: TNS listener does not currently know of service requested。
- 传统单机库用
service_name（推荐）或SID；但 12c+ 多租户环境下，service_name对应的是 PDB 的服务名（如orclpdb1），不是 CDB 名（如ORCLCDB） - 不确定服务名时，登录数据库执行
SELECT name, pdb FROM v$services;，找pdb IS NOT NULL的那条记录 - 连接串格式统一用
//host:port/service_name，别混用 SID 格式（(DESCRIPTION=(ADDRESS=...))），除非你明确需要高级路由控制
长连接、连接池和超时设置的实际影响
企业级应用不是连上就行，OCI 的连接生命周期管理直接影响稳定性。
立即学习“PHP免费学习笔记（深入）”；
-
oci_connect()每次都新建连接，高并发下容易耗尽 Oracle 的processes参数；改用oci_pconnect()可复用连接，但要注意 Apache prefork 模式下它不真正“持久”，FPM 下才有效 - Oracle 默认连接空闲 30 分钟断开，PHP 层不感知，下次用可能报
ORA-03113: end-of-file on communication channel；建议在连接后立即执行SELECT 1 FROM DUAL心跳检测 - 设置连接超时需两层：PHP 层用
oci_connect($u, $p, $c, $cset, OCI_SYS_NO_CACHE | OCI_DEFAULT)避免缓存干扰；Oracle 层在sqlnet.ora加SQLNET.EXPIRE_TIME=10主动探活
OCI 的坑不在语法，而在 Oracle 本身的部署形态和 PHP 运行环境的耦合深度。配通只是第一步，真正难的是让连接在负载变化、PDB 切换、客户端升级这些真实场景里不掉链子。
