phpEnv怎么配置PHP连接SQL Server phpEnv安装pdo_sqlsrv扩展

phpEnv怎么配置PHP连接SQL Server phpEnv安装pdo_sqlsrv扩展

一个关键事实是：phpEnv 本身并不内置 pdo_sqlsrv 扩展。这意味着，如果你不手动下载匹配的 DLL 文件并进行配置，那么尝试执行 new PDO("sqlsrv:...") 时，等待你的大概率会是“Class 'PDO' not found”或“Driver not found”这类令人沮丧的错误。

确认 phpEnv 的 PHP 版本和线程安全（TS/NTS）类型

配置的第一步，也是最容易踩坑的地方，就是版本匹配。pdo_sqlsrv 扩展对 PHP 版本、编译器（VC15/VC17）以及线程模型（TS/NTS）这三者有着近乎苛刻的匹配要求。虽然 phpEnv 在 PHP 8.0+ 版本上默认使用 VC17 编译和非线程安全（NTS）模式，但经验告诉我们，最好还是亲自验证一下：

• 打开命令行，运行 php -v，确认你的 PHP 版本（例如 8.2.12）。
• 接着，运行 php -i | findstr "Thread Safety"（Windows）或 php -i | grep "Thread Safety"（Linux/macOS）。如果输出显示 enabled，那就是线程安全（TS）版本；如果是 disabled，则是非线程安全（NTS）版本。
• 最后，运行 php -i | findstr "Compiler" 确认编译器版本，通常是 MSVC17，也可能是 MSVC15。

记住，使用一个不匹配的 DLL 文件，后果要么是 Apache 或 Nginx 服务直接启动失败，要么就是扩展加载静默失败，排查起来相当麻烦。

下载并放置正确的 pdo_sqlsrv DLL 文件

确认好环境信息后，下一步就是获取正确的扩展文件。直接前往微软官方的 GitHub 发布页（https://github.com/microsoft/msphpsql/releases），根据你的 PHP 版本和线程类型下载对应的 pdo_sqlsrv*.dll 文件。

立即学习“PHP免费学习笔记（深入）”；

• 举个例子，如果你的环境是 PHP 8.2、NTS、VC17，那么应该寻找类似 php_pdo_sqlsrv_82_nts.dll 这样的文件。这里有个小细节需要注意：早期版本的文件名中 ts 可能指代线程安全，而 nts 指代非线程安全，但新版本的命名已经统一规范了，务必以实际下载的文件名为准。
• 下载解压后，将这个 DLL 文件放到 phpEnv 的 ext 目录下。完整路径通常类似于：C:\phpEnv\php\php-8.2.12\ext\php_pdo_sqlsrv_82_nts.dll。
• 还有一点千万别漏了：同目录下通常还需要存在一个 sqlsrv*.dll 文件，因为 pdo_sqlsrv 扩展在内部会依赖它，记得一并放入。

修改 phpEnv 的 php.ini 启用扩展

文件放好了，接下来就是告诉 PHP 去加载它。打开 phpEnv 对应 PHP 版本的 php.ini 配置文件（路径通常是 C:\phpEnv\php\php-8.2.12\php.ini）。

• 在文件中找到类似 ;extension=php_pdo_sqlsrv 这样的行（前面有分号表示注释）。去掉行首的分号，并将文件名补全为刚才放入的完整名称，例如：extension=php_pdo_sqlsrv_82_nts.dll。
• 同时，确保 extension=php_pdo.dll 这一行已经启用（没有被注释掉），因为 pdo_sqlsrv 是建立在 PDO 核心之上的。
• 保存修改后，重启 phpEnv 的 Web 服务（Apache 或 Nginx）以及 PHP-FPM（如果使用了的话）。
• 最后，在命令行中执行 php -m | findstr pdo_sqlsrv，如果能看到输出，恭喜你，扩展已经成功加载了。

连接时 server 参数别写成 127.0.0.1

扩展加载成功，只是万&里长征走完了第一步。在编写连接字符串时，另一个高频错误点在于 server 参数的写法。即使你的 SQL Server 就在本机运行，直接使用 127.0.0.1 也极有可能触发“命名管道提供程序: 无法打开与 SQL Server 的连接”的错误。这其实是 Windows 环境下 TCP/IP 和命名管道协议协商失败的典型表现。

• 最稳妥的做法是，在 DSN 中优先使用 server=localhost。这样连接会尝试使用共享内存或命名管道，通常比纯 TCP/IP 更稳定。
• 如果因为某些原因必须使用 IP 地址，请务必显式指定端口号，格式为：server=127.0.0.1,1433。注意，逗号是必须的，并且中间不能有空格。
• 此外，还需要确保在 SQL Server 配置管理器中已经启用了 TCP/IP 协议，并且在 IPAll 设置中，TCP端口 明确设置为 1433，同时将 TCP动态端口 一项清空。
• 最后，别忘了检查 Windows 防火墙（尤其是 Windows Defender 防火墙）是否放行了 1433 端口。

说到底，连接 SQL Server 失败，90%以上的问题都出在这三个环节：扩展没正确加载、server 参数写错了、或者 SQL Server 自身的网络协议没配置好。至于其他诸如 LoginTimeout、MultipleActiveResultSets 等连接选项，那都是后话了。