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

泥巴客

已于 2025-05-23 11:44:03 修改

阅读量656

点赞数 9

分类专栏： Laravel 文章标签： laravel sqlserver配置 unixodbc odbc驱动安装

于 2025-05-23 11:40:12 首次发布

本文链接：https://blog.csdn.net/zhu_lizhen/article/details/148160098

版权

Laravel 专栏收录该内容

10 篇文章

订阅专栏

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;