PHP 8 必须使用统一的 oci8 扩展而非 oci8_12c，后者已从PECL下架；需匹配Instant Client主版本（如21）、正确设置LD_LIBRARY_PATH或PATH、启用oci8.events=On，并验证php --ri oci8中Version与客户端一致。
PHP 8 环境下执行 pecl install oci8_12c 报错或静默失败，根本原因不是扩展名写错，而是 PHP 8 已彻底移除对 oci8_12c 这类旧式命名扩展的支持——该命名仅适用于 PHP 5.6–7.3 且 Oracle 12c 客户端的组合，PHP 8 必须使用统一的 oci8 扩展，并匹配对应主版本的 Instant Client。
确认错误本质：oci8_12c 在 PHP 8 中根本不存在
运行 pecl search oci8，输出中只会出现 oci8（最新稳定版），绝无 oci8_12c 或 oci8_11g。强行执行 pecl install oci8_12c 会返回 No releases available for package "oci8_12c" 或直接 404。这不是网络问题，是 PECL 仓库已下架所有带版本后缀的旧包。
PHP 8.0+ 的 oci8 扩展不再按 Oracle 服务端版本分包，而是通过编译时链接的 Instant Client 主版本（如 21、19）自动适配连接任意 Oracle 数据库（11g–23c）。
正确安装 oci8 扩展（PHP 8 兼容路径）
方法一：使用 pecl install oci8（推荐）
立即学习“PHP免费学习笔记（深入）”；
① 确保已下载并解压匹配架构的 Oracle Instant Client Basic + Devel ZIP 包（例如 instantclient-basic-linux.x64-21.12.0.0.0.zip 和 instantclient-sdk-linux.x64-21.12.0.0.0.zip），解压到统一路径：【/opt/oracle/instantclient_21_12】
② 进入该目录，检查是否存在 libclntsh.so 且有正确软链接：ls -l libclntsh* —— 必须看到 libclntsh.so -> libclntsh.so.21.1，若只有 libclntsh.so.21.1 而无软链接，手动创建：ln -sf libclntsh.so.21.1 libclntsh.so
③ 执行 pecl install oci8，当提示 Enter the path to ORACLE_HOME 时，**必须输入完整路径**：/opt/oracle/instantclient_21_12，不能留空、不能填 $ORACLE_HOME、不能只写 /opt/oracle
④ 安装成功后，检查 php.ini 是否自动添加了 extension=oci8.so；若未添加，手动追加该行，并确认 extension_dir 指向正确目录（通常为 /usr/lib/php/20230831 或类似）
验证运行时库加载是否生效
CLI 下运行：php -r "echo getenv('LD_LIBRARY_PATH');"，输出必须包含 /opt/oracle/instantclient_21_12。若为空，说明环境变量未在 PHP 进程启动前设置。
立即执行：export LD_LIBRARY_PATH=/opt/oracle/instantclient_21_12:$LD_LIBRARY_PATH，再运行 php --ri oci8 —— 输出中 Oracle Run-time Client Library Version 必须显示 21.12.0.0.0，而非 0.0.0.0.0。
若仍显示 0.0.0.0.0，说明动态链接器在 PHP 启动时完全没找到库。此时需强制注册：echo "/opt/oracle/instantclient_21_12" > /etc/ld.so.conf.d/oracle.conf && ldconfig，然后重启终端或重新登录。
Windows 下替换 dll 文件的致命误区
不要试图把 php_oci8_12c.dll 复制进 PHP 的 ext 目录并写 extension=php_oci8_12c.dll —— PHP 8 的 Windows 官方二进制包只提供 php_oci8.dll（对应 Instant Client 21c），不提供任何带 _12c 后缀的 DLL。
正确做法：从 PHP for Windows PECL 页面 下载与你 PHP 版本（如 8.3 TS x64）、VC 版本（VC17）、线程安全（TS）完全匹配的 php_oci8-3.3.0-8.3-ts-vc17-x64.zip，解压后将 php_oci8.dll 放入 ext 目录，php.ini 中仅写 extension=php_oci8.dll。
【关键前提】：Oracle Instant Client Basic Lite ZIP（如 instantclient-basiclite-windows.x64-21.12.0.0.0.zip）必须解压到固定路径（如 C:\oracle\instantclient_21_12），且该路径必须加入系统 PATH 环境变量，并置于所有其他 Oracle 相关路径之前。
