PHP连接Oracle需先安装OCI8扩展并配置Instant Client，使用oci_connect()时推荐Easy Connect格式指定服务名，SQL执行须经oci_parse()和oci_execute()两步，字符集应显式声明为AL32UTF8。
PHP 连接 Oracle 数据库前，先确认 OCI8 扩展是否就位
PHP 本身不自带 Oracle 支持，必须通过 oci8 扩展才能连接。没装这个扩展，oci_connect() 会直接报 Call to undefined function oci_connect() —— 这是最常见的“连不上”原因，不是用户名密码错，是根本没通电。
检查方法很简单：php -m | grep oci8（命令行）或 phpinfo() 页面搜 oci8。没看到？那就得装：Linux 下通常用 pecl install oci8，但前提是已安装 Oracle Instant Client；Windows 则需下载对应 PHP 版本的 php_oci8_*.dll，并在 php.ini 中启用 extension=php_oci8_*.dll。
注意：PHP 8.2+ 默认不再支持旧版 oci8 的某些编译方式，建议用 Oracle 官方提供的 PECL 最新版，并确保 Instant Client 版本 ≥ 19.10。
用 oci_connect() 连接时，TNS 名、服务名、SID 到底填哪个？
Oracle 连接字符串最容易混淆的就是这三者。简单说：oci_connect() 第三个参数（$connection_string）推荐用 Easy Connect 格式，避免依赖本地 tnsnames.ora：
立即学习“PHP免费学习笔记（深入）”；
$conn = oci_connect('scott', 'tiger', '//192.168.1.100:1521/ORCLPDB1');其中 ORCLPDB1 是服务名（SERVICE_NAME），不是 SID。查服务名可连上数据库后执行：SELECT value FROM v$parameter WHERE name = 'service_names';。若用 SID（如 ORCL），格式应为 //host:port/SID，但 Oracle 12c+ 多租户环境下 SID 常不可用，优先认服务名。
常见错误现象：
-
ORA-12154: TNS:could not resolve the connect identifier→ 字符串格式错，或用了未配置的 TNS 别名 -
ORA-12514: TNS:listener does not currently know of service requested→ 服务名写错，或监听器没加载该 PDB
执行查询时，oci_parse() + oci_execute() 缺一不可
Oracle 不像 MySQL 那样有 mysqli_query() 一步到位。所有 SQL 必须显式解析再执行，否则会报 Warning: oci_execute(): ORA-01008: not all variables bound 或直接失败。
典型流程：
$conn = oci_connect('usr', 'pwd', '//host:port/SERVICENAME');
$stmt = oci_parse($conn, 'SELECT * FROM employees WHERE department_id = :dept_id');
oci_bind_by_name($stmt, ':dept_id', $deptId);
oci_execute($stmt);
while ($row = oci_fetch_assoc($stmt)) {
var_dump($row);
}关键点：
- 绑定变量用
oci_bind_by_name()，别漏掉冒号前缀 -
oci_fetch_assoc()返回大写键名（如'EMPLOYEE_ID'），不是小写，注意数组访问 - 长文本（CLOB）、日期字段可能需要额外处理：
oci_fetch_array($stmt, OCI_RETURN_NULLS | OCI_ASSOC)可保留 NULL
连接池与字符集问题：中文乱码、连接慢、资源耗尽
Oracle 默认字符集常为 AL32UTF8，但 PHP 脚本若用 GBK 或未声明，插入/查询中文就会变问号或乱码。解决方法是在 oci_connect() 第四个参数指定字符集：
$conn = oci_connect('u', 'p', $connstr, 'AL32UTF8');如果没传，PHP 会尝试读环境变量 NLS_LANG，但 Windows 和 Docker 环境下极易失效。所以显式传参最稳。
连接池方面：Oracle 官方不推荐在 Web 场景下复用长连接（比如全局 $conn 变量），因为连接状态难管理，容易出现 ORA-03135: connection lost contact。更稳妥的做法是按需连接、用完 oci_close()，或使用连接池中间件（如 Oracle Wallet + DRCP）——但那是 DBA 层的事，PHP 侧少碰。
最后提醒：OCI8 的错误信息很“硬”，不会自动转成异常。要用 oci_error() 主动捕获，比如：
if (!$stmt = oci_parse($conn, $sql)) {
$e = oci_error($conn);
trigger_error(htmlentities($e['message']), E_USER_ERROR);
}OCI8 的调试成本比 PDO 高，一旦出错，往往要同时查 PHP 日志、Oracle alert.log、网络连通性 —— 这不是代码写得不对，而是 Oracle 生态本身的分层太深。
