PHPEnv安装SQLServer驱动及配置教程

本文详细解析了在phpEnv环境下成功连接SQL Server的关键步骤与常见陷阱：必须严格匹配PHP版本、线程模型（TS/NTS）和系统位数来手动安装sqlsrv/pdo_sqlsrv扩展（仅用短名extension=sqlsrv启用），同时不可或缺地安装Microsoft ODBC Driver 17或18——缺少它会导致连接静默失败，即使扩展显示已加载；还需正确配置SQL Server的TCP/IP协议、防火墙端口（推荐使用127.0.0.1,1433而非localhost）、加密选项及身份验证方式。真正阻碍连接的往往不是PHP代码本身，而是ODBC驱动注册、SQL Server网络配置和系统级安全策略这三大隐蔽环节，掌握这些才能彻底打通phpEnv与SQL Server的稳定通信链路。

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\：

• 把下载好的 php_sqlsrv_82_ts_x64.dll 和 php_pdo_sqlsrv_82_ts_x64.dll 放进 ext/ 目录
• 在 php.ini 末尾添加两行（顺序无关，但不能注释掉）：

  extension=sqlsrv
  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", [
      "Database" => "master",
      "UID" => "sa",
      "PWD" => "your_password",
      "Encrypt" => true,
      "TrustServerCertificate" => false
  ]);
  if (!$conn) { var_dump(sqlsrv_errors()); }

• 常见坑：sa 账户被禁用、混合模式未开启、SQL Server Browser 服务未启动（尤其命名实例）

真正卡住的地方往往不在 PHP 代码里，而在 ODBC 驱动注册状态、SQL Server 网络协议开关、以及 Windows 防火墙对 1433 端口的放行 —— 这三处任一缺失，sqlsrv_connect() 都不会给出明确提示，只会返回 false。

好了，本文到此结束，带大家了解了《PHPEnv安装SQLServer驱动及配置教程》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！