Windows 10环境下PHP CLI无法连接Oracle但网页访问连接正常问题

按照步骤下载了Oracle Instant Client并将其路径添加到系统PATH，同时下载对应版本PHP扩展并在php.ini中完成启用配置。

环境基础信息 #

• OS: Windows 10 Enterprise x64
• PHP: 7.3.30 (cli) (built: Aug 25 2021 09:48:17) ( ZTS MSVC15 (Visual C++ 2017) x64 )
• Oracle instant client: instantclient-basic-windows.x64-12.1.0.2.0
• php extension for oracle database: php_oci8-2.2.0-7.3-ts-vc15-x64

测试情况 #

配置完成后使用以下代码测试Oracle连接：

$conn = oci_connect("testuser", "testpassword", "testtns");
if (!$conn) {
    $m = oci_error();
    echo $m['message'], "\n";
    exit;
}
else {
print "Connected to Oracle!";
}
// Close the Oracle connection
oci_close($conn);

网页访问代码时返回正常结果：Connected to Oracle!。

异常问题 #

命令行环境运行同一段代码时，返回如下报错：

<warning>PHP Warning:  oci_connect(): OCIEnvNlsCreate() failed. There is something wrong with your system - please check that PATH includes the directory with Oracle Instant Client libraries in Psy Shell code on line 1</warning>

PHP OCI8配置输出 #

运行php --ri oci8得到以下结果：

oci8

OCI8 Support => enabled
OCI8 DTrace Support => disabled
OCI8 Version => 2.2.0
Oracle Run-time Client Library Version => 0.0.0.0.0
Oracle Compile-time Instant Client Version => 12.1

Directive => Local Value => Master Value
oci8.max_persistent => -1 => -1
oci8.persistent_timeout => -1 => -1
oci8.ping_interval => 60 => 60
oci8.privileged_connect => Off => Off
oci8.statement_cache_size => 20 => 20
oci8.default_prefetch => 100 => 100
oci8.old_oci_close_semantics => Off => Off
oci8.connection_class => no value => no value
oci8.events => Off => Off

Statistics =>
Active Persistent Connections => 0
Active Connections => 0

可以看到明显异常项：Oracle Run-time Client Library Version => 0.0.0.0.0

已尝试的无效方案：将instantclient的所有内容复制到Apache/bin目录，同时从PATH中移除instantclient目录，无效果。

1. 验证CLI环境的PATH配置
   在当前使用的命令行窗口执行echo %PATH%，确认Oracle Instant Client的目录是否在输出列表中。修改系统PATH后需要关闭所有cmd/PowerShell窗口重新打开生效，必要时重启系统。注意把Instant Client的路径放在PATH列表靠前的位置，避免和其他目录下的同名Oracle库文件冲突。
2. 确认CLI加载的php.ini配置正确
   执行php --ini查看CLI加载的php.ini路径，确认该文件中已经正确添加extension=php_oci8_12c.dll，行首没有分号注释。注意CLI和Apache加载的php.ini可能是不同文件，不要混用配置。
3. 安装对应依赖VC库
   Instant Client 12.1版本依赖Visual C++ Redistributable for Visual Studio 2013，确认系统已经安装x64版本的该VC运行库，不要安装x86版本。
4. 将Instant Client文件复制到PHP根目录
   把Instant Client目录下所有.dll文件直接复制到CLI使用的PHP.exe所在的根目录，CLI运行PHP时会优先读取同目录下的库文件，可避免PATH读取优先级问题。
5. 检查目录权限
   确认Instant Client目录、PHP根目录对当前运行CLI的Windows用户有可读和执行权限，不要放在需要管理员权限的系统目录下。

操作完成后重新打开命令行窗口，执行php --ri oci8，如果Oracle Run-time Client Library Version显示为12.1.0.2.0即修复成功，再运行连接代码即可正常连接。

内容的提问来源于stack exchange，提问作者yong cheng