phpEnv下安装SQL Server驱动(sqlsrv)实战-php教程-PHP中文网

phpEnv 下 sqlsrv 扩展安装失败主因是 PHP 架构（x64/x86）、线程模型（NTS/TS）、扩展 DLL 名称及系统 ODBC 驱动三者未严格匹配；须通过 php -i 确认架构与线程类型，下载对应版本 sqlsrv DLL（如 php_sqlsrv_81_nts_x64.dll），放入 ext 目录并配置 php.ini 启用 extension=sqlsrv 和 extension=pdo_sqlsrv，再安装 ODBC Driver 18 for SQL Server，并使用 localhost 而非 127.0.0.1 连接。

phpenv下安装sql server驱动(sqlsrv)实战

phpEnv 下装不了 sqlsrv，基本是因为扩展名、PHP 架构、ODBC 驱动三者没对齐——不是“没下载对”，而是“根本没匹配上”。

确认 phpEnv 的 PHP 架构和线程模型

phpEnv 默认打包的 PHP 多为 NTS（非线程安全）+ x64，但部分旧版或自定义包可能是 TS 或 x86。错配会导致 php_sqlsrv_*.dll 加载失败，且 php -m 不报错、extension_loaded('sqlsrv') 返回 false。

打开终端，执行 php -v 看版本（如 8.1.22）
执行 php -i | findstr "Architecture Thread"（Windows）或 php -i | grep -E "(Architecture|Thread)"（Linux/macOS），确认输出含 x64 和 NTS
若显示 TS，必须用 _ts.dll；若显示 x86，不能用 _x64 后缀的 DLL

下载并启用正确的 sqlsrv 扩展 DLL

微软已停止为 phpEnv 这类集成环境单独打包，必须手动从官方驱动页选对应版本。当前（2026 年）最新稳定版是 SQLSRV 5.11，支持 PHP 8.0–8.3。

访问 https://www.php.cn/link/7322c71e66f72ebb1cf52d9a6abc90ca，找 php_sqlsrv_81_nts_x64.zip（按你实际 PHP 版本调整）
解压后，把 php_sqlsrv_81_nts_x64.dll 和 php_pdo_sqlsrv_81_nts_x64.dll 放进 phpEnv 对应 PHP 版本的 ext/ 目录（例如 phpenv/php/php-8.1.22/ext/）
编辑该 PHP 版本的 php.ini（通常在 phpenv/php/php-8.1.22/conf/php.ini），末尾加两行：
extension=sqlsrv
extension=pdo_sqlsrv
⚠️ 不要写带完整路径或 .dll 后缀的写法，phpEnv 会自动识别

必须安装系统级 ODBC 驱动（Windows）

phpEnv 自带的 PHP 不带 ODBC 驱动，sqlsrv 扩展加载成功也不代表能连——连接时会直接报 Named Pipes Provider: Could not open a connection 或 TCP Provider: Error code 0x2746。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

去 ODBC Driver 18 for SQL Server 下载安装程序（msi）
运行安装，默认路径即可，无需重启，但需确保安装后有 C:\Windows\System32\msodbcsql18.dll
验证：命令行执行 odbcad32 → “驱动程序”页签，能看到 ODBC Driver 18 for SQL Server

连接测试时 localhost 比 127.0.0.1 更可靠

SQL Server 默认启用命名管道（Named Pipes），而 phpEnv 下的 PHP 常因 TCP/IP 设置未开或防火墙拦截导致 127.0.0.1 连接被拒，错误信息常为 Connection refused 或 Server is not found or not accessible。

用 localhost 代替 IP 地址：
$conn = sqlsrv_connect('localhost', ['Database' => 'testdb', 'Uid' => 'sa', 'PWD' => 'xxx']);
如果仍失败，检查 SQL Server 配置管理器 → “SQL Server 网络配置” → 对应实例的 “协议” → 确保 TCP/IP 和 Named Pipes 均为“已启用”
连接字符串中不要硬编码端口（如 localhost,1433），除非明确禁用了动态端口且只用固定端口

最易被忽略的一点：phpEnv 切换 PHP 版本后，php.ini 是独立的，改了 A 版本的配置，B 版本依然无效；ODBC 驱动装一次就行，但扩展 DLL 必须每个 PHP 版本都放一份。