PHP调用odbc_connect出现未定义函数Fatal error报错如何解决

DevOps 小满

2026-10-8

报错原因

这个错误出现的核心原因是当前PHP环境没有启用ODBC扩展，odbc_connect 是PHP ODBC扩展提供的专属函数，扩展未开启时调用就会触发未定义函数的报错。

解决步骤

1. 开启ODBC扩展

根据你使用的操作系统选择对应操作：

Windows环境（含XAMPP、WAMP等集成环境）
找到PHP配置文件php.ini，搜索以下两行配置，删掉行首的分号（注释符号）：
```
extension=odbc
extension=pdo_odbc # 后续如果要用PDO方式连接数据库可以同步开启这行
```
保存配置后重启Apache/Nginx等Web服务即可。
Linux环境
根据发行版执行对应命令安装扩展包：
「Debian/Ubuntu系列」
```
sudo apt install php-odbc
```
「CentOS/RHEL系列」
```
sudo yum install php-odbc
```
安装完成后重启Web服务和PHP-FPM服务生效。

2. 验证扩展生效状态

新建一个测试PHP文件，写入如下代码：

<?php
phpinfo();
?>

运行文件后在输出的页面搜索ODBC相关配置项，能搜到就说明扩展已经开启成功。

3. 测试数据库连接

扩展开启后再执行你的连接代码即可，建议补充错误判断排查连接问题：

$connection = odbc_connect('MyDatabaseName', 'MyUsername', 'MyPassword');
if ($connection) {
  echo "数据库连接成功";
} else {
  echo "连接失败，错误信息：" . odbc_errormsg();
}