PDO_OCI扩展未启用是连接Oracle的第一道关卡，需确认php.ini中已启用extension=php_pdo.dll和extension=php_pdo_oci.dll，且两DLL文件存在于php/ext目录；同时确保Instant Client路径正确加入系统Path环境变量，并使用IP+端口+service_name格式的DSN（如'oci:dbname=//192.168.1.100:1521/ORCL12C'）及显式charset参数。
pdo_oci扩展是否已启用
没启用就根本连不上，这是最常卡住的第一步。PHP 7.1 的 php_pdo_oci.dll 不是默认开启的，且必须和你的 PHP 架构（32/64位）、VC编译器版本（VC14/VC15）严格匹配。Windows 下常见错误是：PHP Startup: Unable to load dynamic library 'php_pdo_oci.dll' 或直接报 Class 'PDO' not found（说明 PDO 核心没加载）。
检查方式：运行 php -m 看输出里有没有 pdo_oci；或写个 phpinfo() 页面搜索 “pdo_oci”。若没出现，确认以下几点：
-
extension=php_pdo.dll和extension=php_pdo_oci.dll在php.ini中已取消注释 - 这两个
.dll文件确实在php/ext/目录下（注意：PHP 7.1 对应的是php_pdo_oci.dll，不是php_oci8.dll） - Apache 或 PHP-FPM 进程已完全重启（不是仅刷新页面）
Instant Client 路径与环境变量是否正确设置
即使扩展加载成功，pdo_oci 仍依赖 Oracle Instant Client 提供的底层库（如 oci.dll）。Windows 下典型报错是：OCIEnvCreate failed、Unable to load Oracle client library 或 ORA-12154: TNS:could not resolve the connect identifier —— 后者往往其实是前两者导致的假象。
关键操作不是“放对文件”，而是让 Windows 找得到它们：
立即学习“PHP免费学习笔记（深入）”；
- 下载与 Oracle 12c 兼容的 Instant Client Basic（如
instantclient-basic-windows.x64-12.1.0.2.0.zip），解压后路径不能含空格或中文（推荐C:\oracle\instantclient_12_1） - 在系统环境变量
Path中追加该路径（不是子目录） - 设置
ORACLE_HOME指向同一路径（虽然pdo_oci实际不读它，但某些 OCI 库会检查） -
不要设
TNS_ADMIN除非你真用了tnsnames.ora；多数直连场景反而因它干扰解析
DSN 字符串怎么写才不报 ORA-12154
报这个错，90% 是 DSN 格式或网络层问题，不是权限或密码错。Oracle 12c 默认监听的是 SERVICE_NAME（不是 SID），而 PDO_OCI 对 DSN 解析很敏感。
推荐用 IP+端口+service_name 的显式写法，避免依赖本地 tnsnames.ora：
$dsn = 'oci:dbname=//192.168.1.100:1521/ORCL12C';
其中 ORCL12C 是数据库的服务名（可通过 DBA 查 SELECT value FROM v$parameter WHERE name = 'service_names';），不是实例名。其他常见写法风险：
-
oci:dbname=ORCL12C→ 仅当本地tnsnames.ora存在且路径被正确识别时才有效，调试阶段慎用 -
oci:dbname=(DESCRIPTION=...)→ 容易因括号、空格、换行引发解析失败，不建议手写 - 漏写端口（1521）→ 默认走 1521，但若远程库改过监听端口，必须显式指定
字符集乱码或中文插入失败
连接成功但查出来是问号、插入报 ORA-12705 或 ORA-01804，基本是客户端字符集没对齐。Oracle 12c 默认使用 AL32UTF8，但 Windows 的 CMD/PowerShell/IDE 终端可能用 GBK，PHP 脚本本身编码也可能是 UTF-8 或 ANSI。
解决方法优先级从高到低：
- 在 DSN 中显式指定字符集：
$dsn = 'oci:dbname=//...;charset=AL32UTF8'; - 确保 PHP 文件保存为 UTF-8 无 BOM 格式
- 避免在连接后执行
ALTER SESSION SET NLS_LANGUAGE类语句——PDO 不支持 session 级别 NLS 设置，会直接报错 - 如果必须兼容旧系统（如 ZHS16GBK），则 Instant Client 和数据库服务端都需一致，且 DSN 中写
charset=ZHS16GBK
真正麻烦的不是连不上，而是连上了却查不到数据、插不进中文、日期解析错位——这些往往发生在 DSN 没带 charset、Instant Client 版本和 Oracle 12c 小版本不匹配、或者 PHP 进程继承了错误的系统 locale 时。动手前先确认三件事：PHP 架构位数、Instant Client 版本、数据库服务名，缺一不可。
