phpEnv怎么安装SQL Server驱动 phpEnv连接MSSQL配置-php教程-PHP中文网

php连接sql server需手动安装sqlsrv/pdo_sqlsrv扩展及microsoft odbc driver 17/18；须严格匹配php版本、线程模型（ts/nts）与系统位数；扩展名用短名（extension=sqlsrv），odbc驱动未安装会导致连接静默失败。

phpenv怎么安装sql server驱动 phpenv连接mssql配置

phpEnv 本身不内置 SQL Server 驱动，必须手动安装 sqlsrv 和 pdo_sqlsrv 扩展，并配套安装 Microsoft ODBC Driver —— 否则 sqlsrv_connect() 或 PDO sqlsrv: DSN 会直接报“Call to undefined function”或“Driver not found”错误。

确认 phpEnv 的 PHP 版本与线程模型

phpEnv 多版本共存，每个 PHP 实例独立配置。你必须针对**当前启用的 PHP 版本**做匹配：

运行 php -v 查看版本（如 PHP 8.2.12）
运行 php -i | findstr "Thread Safety"（Windows）或 php -i | grep "Thread Safety"（Linux/macOS via WSL）确认是 enabled（TS）还是 disabled（NTS）
检查系统位数：php -i | findstr "Architecture" → 得到 x64 或 x86
去微软官方 GitHub Release 页面下载对应包：php_sqlsrv_82_ts_x64.dll（TS+64位+PHP 8.2）这类命名的文件

复制 DLL 并修改 php.ini（仅 Windows phpEnv）

phpEnv 的 php.ini 通常位于 phpenv\versions\{version}\etc\php.ini，不是系统默认路径；扩展目录一般为 phpenv\versions\{version}\ext\：

btpanel phpsite 宝塔面板PHP网站

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

下载

把下载好的 php_sqlsrv_82_ts_x64.dll 和 php_pdo_sqlsrv_82_ts_x64.dll 放进 ext/ 目录
在 php.ini 末尾添加两行（顺序无关，但不能注释掉）：
```
extension=sqlsrv<br>extension=pdo_sqlsrv
```
⚠️ 不要写成 extension=php_sqlsrv_82_ts_x64.dll —— phpEnv 的 extension= 指令只认短名，否则加载失败且无提示
保存后，在 phpEnv 控制台执行 phpenv rehash 并重启 Web 服务（如 Apache 或 Nginx）

必须安装 Microsoft ODBC Driver 17/18 for SQL Server

即使扩展加载成功，sqlsrv_connect() 仍会报错 SQLSTATE: 08001, code: -19 或 “Client unable to establish connection”，本质是底层缺 ODBC 驱动：

Windows：直接下载安装 msodbcsql18.msi（推荐 18，兼容性更好），地址见微软官网；安装时勾选“ODBC Driver 18 for SQL Server”
Linux（WSL）：按官方步骤执行 curl + apt-get install msodbcsql18，并确保 unixodbc-dev 已就位
验证驱动是否注册：运行 odbcinst -j 看 Drivers 路径，再查该路径下是否有 ODBC Driver 18 for SQL Server 条目
不装这个，php -m | grep sqlsrv 显示已加载，但连接必败

测试连接时注意服务器地址和加密选项

本地连接不等于 localhost 能通 —— SQL Server 默认禁用 TCP/IP，且 Windows 防火墙常拦 1433：

连接字符串中不要用 localhost，改用 127.0.0.1,1433（显式端口可绕过命名管道歧义）
若 SQL Server 启用了强制加密，但你没配证书或设 "TrustServerCertificate"=>true，连接会静默失败或卡住

最简测试脚本应包含错误捕获：

$conn = sqlsrv_connect("127.0.0.1,1433", [<br>    "Database" => "master",<br>    "UID" => "sa",<br>    "PWD" => "your_password",<br>    "Encrypt" => true,<br>    "TrustServerCertificate" => false<br>]);<br>if (!$conn) { var_dump(sqlsrv_errors()); }