ThinkPHP连接window版本的ORACLE数据库教程

暴走十八步

已于 2025-02-14 11:42:54 修改

阅读量1.7k

点赞数 24

文章标签：数据库 oracle android

于 2023-12-11 01:59:57 首次发布

本文链接：https://blog.youkuaiyun.com/wayhb/article/details/134917535

版权

前言

PHP7.4以上一般使用64位客户端
刚开始第一次配置PHP连接OARCLE成功时，并没有认真分析各种驱动之间的区别，导致之后的配置时常成功，时常失败，这次在AI的帮助下重新认识了PHP与Oracle连接的细节，再次修改文章。

概念

要连接Oracle数据库，必须有两个东西，一个PHP的扩展oci（分为oci与pdo_oci），一个Oracle官方写的客户端（Instant_Client，除了JAVA外，其他语言都需要进过客户端连接oracle服务器）
PHP是通过扩展去操作oralce客户端连接的服务端数据库，所以两个都不能少，而且版本必须一致
PHP官方写的Oracle扩展：主流分为oci8，pdo_oci，oci_12c（带版本号），区别是oci8是通用的驱动适合各种版本，pdo_oci是规范后的驱动，为了统一各种数据库连接，但是有各种限制，oci_12c是针对oracle_12c特有版本驱动，oci_19c针对oracle_19c。驱动或者必须和PHP版本匹配
Ocracle官方写的客户端：Instant_Client，也分为32位和64位，PHP大部分是32位的，优先安装32位，另外该驱动针对不同平台，需要安装依赖库，比如windows下需要安装vc++支持库，每个版本都写了需要哪种vc++已经下载地址

基本步骤

下载并配置oracle客户端，重启服务器，验证
下载并配置oci8扩展，验证
配置php

注意：配置顺序不要变

详细操作

一. 下载并配置oracle客户端

下载地址：https://www.oracle.com/database/technologies/instant-client/downloads.html
点击后出现很多版本，每个版本有针对的数据库版本，这里的版本和PHP扩展没有必须匹配关系，比如12.1可用连接11G也可用连接19C，版本的区别主要是依赖的VC++版本不同和ojdbc驱动版本不同，已经对数据库的特殊语法支持，我使用的OARCLE19C版本，选择version12.1和version19.25均可用连接19C，但是version19.25使用的是ojdbc8驱动更适合19C数据
下载basic压缩包，该版本需要VC++2017,查看控制面板程序中是否安装了vc++2017，或者vc++2015-2022，没有的话点微软练级下载安装
VC++安装出现不兼容的话，删除其他版本，比如安装VC++2017不成功，就删除程序中VC++2017原有版本，然后安装
解压到任意没有中文路径的地方，如D:/instantclient_19_25
配置环境变量：

添加path
目的：让客户端在任意地方可用执行
添加ORACLE_HOME
目的：让扩展可用找到客户端
添加NLS_LANG
目的：规定字符集，避免乱码
值：SIMPLIFIED CHINESE_CHINA.ZHS16GBK
添加TNS_ADMIN
目的：使用别名访问oracle，实测不可用，但最好还是配置一下
A），创建文件
在客户端下创建文件 network/admin/tnsnames.ora

DHERP =
	(DESCRIPTION =
		(ADDRESS_LIST =
			(ADDRESS = (PROTOCOL = TCP)(HOST = 192.168.0.158)(PORT = 1521))
		)
	(CONNECT_DATA =
		(SERVER = DEDICATED)
		(SERVICE_NAME = ORCL)
	)
)

B），添加环境变量
在这里插入图片描述
5. 重启服务器重点：重启服务器
6. 任意地方打开CMD，输入

genezi -v

成功后显示版本号，如果没有显示，看看配置是否正确，是否重启了电脑
在这里插入图片描述

重点：配置ORACLE客户端后需要重启服务器

二、下载并配置oci8扩展

下载地址：http://pecl.php.net/package/oci8
如何选择版本：
打开phpstudy环境，打开首页phpinfo.php，查看PHP版本
这里7.0.12选择32位的oci8扩展+32位的Instant Client
下载对于版本
7.3以上的PHP要选择2.2.0以上版本，这里选择7.0对于的版本，因为使用的phpstudy2016，使用的PHP版本是php-7.0.12-nts
注意对应版本的位数，32和64不能兼容
解压后把这些全部拷贝到PHP的ext目录下D:\phpStudy\php\php-7.0.12-nts\ext
打开php.ini，找到extension所在，填写以下内容

;extension=php_pdo_oci.dll
extension=php_oci8.dll
;extension=php_oci8_12c.dll

说明：
php_pdo_oci.dll：这个是phpstudy自带的，使用pdo方法去连接oci8,thinkphp默认使用PDO连接，使用thinkphp默认配置需要打开，这里暂时关闭
php_oci8.dll：官网下载的，php_oci8.dll和php_oci8_12c.dll任意打开一个即可
php_oci8_12c.dll：php7自带这个，主要是对12C优化，这里先打开这个
访问PHP自带的phpinfo.php，出现以下扩展说明安装成功，版本是19
安装版本12后，出现以下信息

PHP连接ORACLE19C

<?php
//连接测试
$conn = oci_connect('用户', '密码', '//192.168.1.100:1521/ORCL');
if ($conn) {
    echo "连接成功";
    oci_close($conn);
} else {
    $e = oci_error();
    echo "连接失败: ". $e['message'];
}

// 写一个查询
$username = '用户';
$password = '密码';
$tns_alias = '//192.168.0.158:1521/ORCL';

try {
    // 使用oci_connect函数通过别名进行连接，该函数会根据配置自动查找tnsnames.ora中对应别名的连接信息
    $conn = oci_connect($username, $password, $tns_alias);
    if ($conn) {
        echo "成功连接到Oracle数据库。";
        // 在这里可以进行后续的数据库操作，比如执行SQL查询等
        // 示例：执行一个简单的查询语句
        $sql = "SELECT * FROM ORGDOC";
        $stid = oci_parse($conn, $sql);
        oci_execute($stid);
        while ($row = oci_fetch_assoc($stid)) {
            // 处理查询到的每一行数据，这里简单打印出来
            var_dump($row);
        }
        // 操作完成后关闭连接
        oci_close($conn);
    } else {
        $e = oci_error();
        echo "连接Oracle数据库失败: ". $e['message'];
    }
} catch (Exception $e) {
    echo "出现异常: ". $e->getMessage();
}

thinkphp连接OCRACLE19C

打开extension=php_pdo_oci.dll
common->config中配置

<?php
return array(
	//连接oracle 11g r2
	'DB_TYPE' =>  'oracle',      // 数据库类型
	'DB_HOST' =>  '127.0.0.1',   // 服务器地址
	'DB_NAME' =>  'orcl',    // 数据库名
	'DB_USER' =>  'usr',          // 用户名
	'DB_PWD'  =>  'pwd', // 密码
	'DB_PORT' =>  '1521',        // 端口
	
	//连接oracle 19c CBD模式
	// 'DB_TYPE' =>  'oracle',      // 数据库类型
	// 'DB_HOST' =>  '127.0.0.1',   // 服务器地址
	// 'DB_NAME' =>  'orcl',    // 数据库名
	// 'DB_USER' =>  'C##usr',          // 用户名
	// 'DB_PWD'  =>  'pwd', // 密码
	// 'DB_PORT' =>  '1521',        // 端口
);

书写测试连接方法

<?php
namespace Home\Controller;
use Think\Controller;
class IndexController extends Controller {
    public function index(){
		$sql = " select * from tablea where rownum <10 ";
		$rs = M()->query($sql);
		var_dump($rs);
	}
}

问题排除

oci_connect(): OCIEnvNlsCreate() failed. There is something wrong with your system - please check that PATH includes the directory with Oracle Instant Client libraries

解决方案：Instant Client没有配置在环境变量中，配置一下即可

SQLSTATE[HY000]: OCIEnvNlsCreate: Check the character set is valid and that PHP has access to Oracle libraries and NLS data (ext\pdo_oci\oci_driver.c:688)

解决方案：Instant Client版本不匹配，如果是64位的，换成32位的试一试

pdo_oci 和oci8的区别
pdo_oci 扩展必须依赖oci8，他只是在oci8上进行了一次规范
oci8它提供的是更接近 Oracle 原生的数据库访问接口，其函数命名等和 Oracle 数据库本身的一些操作习惯有一定关联
对于 Oracle 数据库的高级特性如存储过程调用、特定的数据库对象管理等方面可以更直接地通过对应的 oci8 函数去实现

//PDO连接
try {
    $pdo = new PDO('oci:dbname=//localhost/XE', 'username', 'password');
    // 后续执行查询等操作
} catch(PDOException $e) {
    echo "数据库连接失败: ". $e->getMessage();
}
//oci8连接
$conn = oci_connect('username', 'password', '//localhost/XE');
if (!$conn) {
    $e = oci_error();
    trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
}