如何解决PHP连接SQL Server时的驱动安装难题_在Linux下部署sqlsrv与pdo

php连sql server报“could not find driver”，90%因sqlsrv/pdo_sqlsrv扩展未正确安装或odbc驱动缺失/版本不匹配，须确保odbc驱动、php扩展、php.ini配置三者严格对齐。

如何解决php连接sql server时的驱动安装难题_在linux下部署sqlsrv与pdo_sqlsrv

直接说结论：PHP 连 SQL Server 报 could not find driver，90% 是因为 sqlsrv 和 pdo_sqlsrv 扩展没装对，或者底层 ODBC 驱动缺失/版本不匹配。不是 PHP 版本太高或太低的问题，而是三个组件（ODBC 驱动、PHP 扩展、PHP 配置）必须严格对齐。

为什么 pecl install 会失败或加载不了

PECL 安装看似简单，但实际常卡在编译环节——它依赖系统级头文件和链接库，而这些往往没装全。比如 unixODBC-devel 缺失会导致 phpize 报 “Cannot find header file(s) for sqlsrv”；gcc 或 make 未安装则根本跑不起来 configure 步骤。

必须先确认已安装：gcc、make、php-devel（对应你的 PHP 版本，如 php74-devel）、unixODBC-devel
pecl install sqlsrv 默认装最新版，但 PHP 7.4 实际兼容性最好的是 sqlsrv-5.10.1 和 pdo_sqlsrv-5.10.1，新版可能触发 segfault 或 502
宝塔用户特别注意：phpize 和 php-config 路径不是系统默认的，得用宝塔实际路径，例如 /www/server/php/74/bin/phpize

ODBC 驱动装哪个版本才不翻车

微软官方驱动有多个主版本（13.x、17.x、18.x），但不是越新越好。SQL Server 2019+ 推荐用 msodbcsql17，但某些国产 Linux 发行版（如 openEuler）或旧内核上，17.x 会引发 libcrypto 符号冲突，导致 PHP-FPM 启动即崩溃。

Linux installer

先解析安全源，运行本地CLI安装、启动、卸载Linux桌面应用。用户请求时使用。

下载

CentOS 7 / RHEL 7 / 宝塔常见环境：优先用 msodbcsql17，命令是 ACCEPT_EULA=Y yum install -y msodbcsql17
如果装完 PHP 报 502 或日志里有 undefined symbol: OPENSSL_sk_num，立刻卸载并换回 msodbcsql13（需手动下载 rpm 并 yum localinstall）
装完务必检查：cat /etc/odbcinst.ini 中是否出现 [ODBC Driver 17 for SQL Server] 及对应 Driver= 路径，且该 so 文件真实存在

扩展加载后仍不生效的隐藏原因

即使 php -m | grep sqlsrv 能看到扩展，Web 环境里还是报错，大概率是 PHP 配置没打到正确位置，或者被宝塔面板的多版本机制绕过去了。

宝塔 PHP 7.4 的真实配置目录是 /www/server/php/74/etc/php.ini，不是 /etc/php.ini；扩展配置应写入 /www/server/php/74/etc/php.d/20-sqlsrv.ini（优先级更可控）
扩展顺序有影响：pdo_sqlsrv.so 必须在 pdo.so 之后加载，否则 PDO::SQLSRV DSN 会被忽略；建议 ini 文件里写成：
extension=pdo.so
extension=sqlsrv.so
extension=pdo_sqlsrv.so
重启服务必须完整：systemctl restart php-fpm-74（宝塔命名规则），而不是只 reload nginx 或重启面板

验证是否真成功，别信 phpinfo() 就完事

phpinfo() 显示扩展名只是“注册了”，不代表能连上 SQL Server。真正有效的验证是执行一段最小连接代码，并捕获异常细节。

写个 test-sqlsrv.php 放 Web 目录下：

<?php try {
    $conn = new PDO("sqlsrv:server=192.168.1.100;Database=testdb", "sa", "yourpass");
    echo "PDO OK";
} catch (PDOException $e) {
    echo "Error: " . $e->getMessage();
}
?>

如果报 SQLSTATE[IMSSP]: This extension requires the Microsoft ODBC Driver for SQL Server，说明 ODBC 驱动路径没被 PHP 进程读到，需检查 LD_LIBRARY_PATH 是否包含 /opt/microsoft/msodbcsql17/lib64
如果报 SQLSTATE[08001]: [Microsoft][ODBC Driver 17 for SQL Server]Login timeout expired，说明驱动已加载，只是网络或认证问题——这才是正常路径

最易被忽略的一点：宝塔面板里「PHP 设置」页面的「禁用函数」列表里，如果误加了 putenv，会导致 ODBC 驱动无法读取环境变量（比如 ODBCSYSINI），从而找不到 odbcinst.ini ——这种问题不会报任何扩展错误，只会静默失败。