PHP连接SQL Server需手动安装sqlsrv/pdo_sqlsrv扩展及Microsoft ODBC Driver 17/18；须严格匹配PHP版本、线程模型（TS/NTS）与系统位数；扩展名用短名（extension=sqlsrv），ODBC驱动未安装会导致连接静默失败。
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<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 驱动：
立即学习“PHP免费学习笔记（深入）”；
- 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()); } - 常见坑：sa 账户被禁用、混合模式未开启、SQL Server Browser 服务未启动（尤其命名实例）
真正卡住的地方往往不在 PHP 代码里，而在 ODBC 驱动注册状态、SQL Server 网络协议开关、以及 Windows 防火墙对 1433 端口的放行 —— 这三处任一缺失，sqlsrv_connect() 都不会给出明确提示，只会返回 false。
