OCI8 是 PHP 连接 Oracle 数据库的官方扩展，自 PHP 8.4.0 起已解耦为独立扩展；必须配合 Oracle Instant Client 使用，pdo_oci 在 PHP 7.4+ 已废弃且不可用。
PHP 连 Oracle 数据库，必须用 oci8 扩展，不是 pdo_oci —— 后者在 PHP 7.4+ 已废弃，编译失败、驱动找不到、连接报 Driver not found 都是它惹的祸。
确认系统已装 Oracle Instant Client 并能被动态链接器识别
没它，pecl install oci8 必然失败，常见报错如 undefined symbol: OCINlsGetInfo 或静默返回 false。这不是 PHP 的问题，是运行时找不到 Oracle 客户端库。
- 下载匹配架构和版本的
oracle-instantclient-basic和oracle-instantclient-devel（RPM 或 ZIP），例如instantclient_21_12；解压路径统一，推荐/opt/oracle/instantclient_21_12 - 设环境变量：
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刷新
编译并启用 oci8 扩展（Linux / Alpine 分开看）
扩展装完不等于能用，php -m | grep oci8 显示模块名只是第一步，php --ri oci8 才能看出是否加载成功、版本是否匹配。
- Linux（glibc 系统）：运行
pecl install oci8，提示输入路径时填/opt/oracle/instantclient_21_12；完成后确保php.ini有extension=oci8.so - Alpine（musl libc）：不能用 RPM，改用
apk add oracle-instantclient-basiclite（仅限部分镜像源），或手动下载basicliteZIP 版；安装前必须apk add php82-dev autoconf g++ make openssl-dev，且pecl install oci8时路径要与ORACLE_HOME严格一致 - Windows 用户请直接用官方预编译包：下载对应 PHP 版本的
php_oci8.dll，放进ext/目录，php.ini中写extension=php_oci8.dll
php.ini 关键配置项漏一项就可能静默失败
oci_connect() 返回 false 却不报错？大概率是这些配置没生效。默认情况下它连 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() 仍可能卡在连接字符串、TNS 解析或权限上。别急着重装，先快速过一遍：
- 连接串用 Easy Connect 格式最稳：
"localhost:1521/XE"或"192.168.1.100:1521/ORCLPDB1"；避免依赖tnsnames.ora，除非你显式调用了putenv('TNS_ADMIN=/path/to/tns') - 用户必须有
CREATE SESSION权限，且密码未过期；Oracle 12c+ 默认 PDB 账户需带容器名，比如user@ORCLPDB1 - 运行时路径断裂常被忽略：用
ldd $(php-config --extension-dir)/oci8.so | grep clntsh确认libclntsh.so是否能被动态加载；若显示not found，说明LD_LIBRARY_PATH没传进 PHP worker 进程（尤其是 Nginx + PHP-FPM 场景，需在www.conf里加env[LD_LIBRARY_PATH]）
OCI8 在 PHP 8.4.0 起已解耦为独立扩展，不再随 PHP 源码发布。这意味着未来升级 PHP 大版本时，oci8 必须单独维护、单独测试兼容性——这点容易被忽略，但直接影响长期运维成本。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
