PHP 通过 ODBC 连接数据库的函数用法详解

听雨眠

发布时间：2026-10-16| 6人浏览过

原创

在使用 PHP 访问通过 ODBC（Open Database Connectivity）驱动配置的数据源时，开发者需要了解一套特定的 API 函数集。本文将解析连接、执行查询、获取数据及关闭连接的完整生命周期，并通过实际代码示例展示如何处理游标与结果集。

实现目标

本教程旨在演示如何使用原生 PHP ODBC 扩展与外部数据源建立连接，执行 SQL 语句并提取结果。这通常用于连接未提供原生 PHP MySQL/MongoDB/PostgreSQL 驱动的遗留系统或企业级数据源（如 SQL Server 通过 ODBC 桥接）。

准备条件

服务器环境：已安装 PHP 且启用 php_odbc 扩展。Windows 下通常为内置 DLL，Linux 下需安装 php7.x-odbc 及对应的 unixODBC 库。
DSN 配置：在操作系统层面（ODBC Data Source Administrator）已创建好数据源名称（DSN）。例如文中配置的 DSN 名为 yuange。
网络权限：确保 PHP 运行环境有权访问该 ODBC 数据源指向的物理数据库服务。

真实操作顺序

第 1 步：认识核心 ODBC 函数

PHP ODBC 功能主要通过以下四个步骤的函数完成：

odbc_connect(string $dsn, string $username, string $password [, int $cursor_type])
- 目的：建立与 ODBC 数据源的连接。
- 参数：$dsn 是预先配置好的数据源名称；$username 和 $password 为认证信息（某些只读或匿名配置可留空字符串）；$cursor_type 可选，控制游标类型，默认值为 0。
- 返回：成功时返回连接标识符（connection ID），失败返回 false。
odbc_do(int $connection_id, string $query)
- 目的：向数据库发送 SQL 查询或命令。
- 参数：$connection_id 来自上一步的连接ID；$query 是要执行的 SQL 语句字符串。
- 返回：结果标识符（result ID）或布尔值（对于非 SELECT 语句）。
odbc_result(int $result_id, mixed $field)
- 目的：从当前结果集中提取特定字段的数据。
- 参数：$result_id 来自查询返回的结果ID；$field 可以是字段名或从 1 开始的数字索引。
odbc_close(int $connection_id)
- 目的：显式关闭指定的数据库连接，释放资源。

第 2 步：编写连接与查询代码

以下示例展示了完整的操作流程：连接到名为 yuange 的 DSN，查询 counter 表，筛选并输出结果。

<?php
// 1. 建立连接 (假设用户密码为空)
$conid = odbc_connect("yuange", "", ""); 

if (!$conid) {
    die("连接失败: " . odbc_errormsg());
}

// 2. 定义并执行 SQL 查询
$sql = "SELECT * FROM counter";
$resid = odbc_do($conid, $sql);

// 3. 遍历结果集
while (odbc_fetch_row($resid)) {
    // 获取第1列作为序列号，第2列作为日期
    $serial = odbc_result($resid, 1); 
    $riqi   = odbc_result($resid, 2);
    
    // 逻辑处理：仅输出偶数序号的记录
    if ($serial % 2 == 0) {
        echo $serial . "      " . $riqi . "<br>";
    }
}

// 4. 关闭连接
odbc_close($conid);
?>

完成判断与排错

验证方法：运行上述脚本，如果浏览器正确输出了满足条件的数据行，且没有报错，则证明 ODBC 配置、PHP 扩展及 SQL 语法均正确无误。

常见问题排查：

连接拒绝：检查 ODBC 管理员中 DSN (yuange) 的配置是否正确，且 PHP 进程有权限访问该驱动。
SQL 错误：使用 odbc_error() 或 odbc_errormsg() 捕获具体的数据库引擎报错信息。
性能考量：odbc_fetch_row() 是逐行读取，在处理千万级大数据量时可能较慢，此时应考虑分页或使用更现代的 PDO/OCI 扩展（如果支持）。