当前位置：首页 > news >正文

Laravel 连接 SQL Server 之 Linux 系统安装 unixODBC 和 Microsoft ODBC 驱动

news 来源：原创 2025/6/8 3:28:05

Laravel 连接 SQL Server 数据库需要进行以下配置：

1. 安装必要的扩展

对于 Linux 系统，需要安装 unixODBC 和 Microsoft ODBC 驱动
对于 Windows 系统，确保安装了 SQL Server Native Client 或 ODBC Driver for SQL Server
PHP 需要安装 pdo_sqlsrv 和 sqlsrv 扩展

2. Linux 安装 SQL Server 驱动

laravel 报错

[previous exception] [object] (PDOException(code: IMSSP): SQLSTATE[IMSSP]: This extension requires the Microsoft ODBC Driver for SQL Server to communicate with SQL Server. Access the following URL to download the ODBC Driver for SQL Server for x64: https://go.microsoft.com/fwlink/?LinkId=163712

这个错误表明你的 PHP 环境缺少 Microsoft ODBC Driver for SQL Server

CentOS/RHEL 系统安装配置：

# 安装 unixODBC
sudo yum install -y unixODBC unixODBC-devel

此处注意下，安装的是 msodbcsql18

# 添加 Microsoft 仓库并安装 ODBC 驱动
sudo curl -o /etc/yum.repos.d/msprod.repo https://packages.microsoft.com/config/rhel/$(rpm -E %rhel)/prod.repo
sudo yum remove -y unixODBC-utf16 unixODBC-utf16-devel
sudo ACCEPT_EULA=Y yum install -y msodbcsql18 mssql-tools18

验证 ODBC 驱动安装

odbcinst -q -d

在这里插入图片描述

3. 常见问题

msodbcsql18 装上后，laravel 运行报错：

[previous exception] [object] (PDOException(code: 08001): SQLSTATE[08001]: [unixODBC][Microsoft][ODBC Driver 18 for SQL Server]SSL Provider: [error:1416F086:SSL routines:tls_process_server_certificate:certificate verify failed:self signed certificate]

官方解释是应用程序无法验证 SQL Server 的 SSL 证书，通常是因为 SQL Server 使用了自签名证书

找了好久没解决这个问题，而且以前也没遇见过。想别的办法

考虑下是否是版本问题

sudo yum list available | grep msodbcsql

在这里插入图片描述
前面安装的是msodbcsql18 ，卸载，重新安装13

#卸载18
yum remove msodbcsql18
# 安装 msodbcsql 13，注意文件名
ACCEPT_EULA=Y yum install -y msodbcsql

测试

 //数据库服务器地址,注意实例和端口的写法
$serverName = '192.168.116.180\testsyna,11552';
$uid = 'mssa';     //数据库用户名
$pwd = '123456'; //数据库密码
$connectionInfo = array("UID" => $uid, "PWD" => $pwd, "Database" => 'test001');
$conn = sqlsrv_connect($serverName, $connectionInfo);
if($conn == FALSE){echo "连接失败！";var_dump(sqlsrv_errors());exit;
}else{echo "链接成功";
}echo "连接成功！";exit;