PHP连接SQLServer详细教程

本文深入剖析了PHP连接SQL Server过程中极易踩坑的关键环节，从驱动扩展（sqlsrv/pdo_sqlsrv）与PHP版本、线程安全（TS/NTS）及系统架构（x64/x86）的精准匹配，到php.ini配置路径与扩展名的严格一致、Web服务与CLI环境的多配置文件区分，再到连接时实例名或端口的正确写法、PDO中CharacterSet=utf8的强制指定以避免中文乱码——每一步都直击实际开发中报错模糊、排查困难的痛点，提供可立即验证的命令行检测方法和经过实战检验的配置范例，助你绕过90%的“连不上”陷阱，高效打通PHP与SQL Server的数据通道。

确认 PHP 版本与 SQL Server 驱动兼容性

PHP 连 SQL Server 不是装个扩展就完事，核心在于 sqlsrv 或 pdo_sqlsrv 扩展是否匹配你的 PHP 版本、线程安全（TS/NTS）和架构（x64/x86）。Windows 下常见坑是：PHP 8.2 NTS + 下载了 TS 版驱动，结果 extension=sqlsrv 加载失败，且错误日志里只报 Unable to load dynamic library 'sqlsrv'，不提示具体原因。

实操建议：

• 用 php -i | findstr "Thread Safety"（Windows）或 php -i | grep "Thread Safety"（Linux/macOS）确认 TS/NTS
• 运行 php -v 查版本号，再对照微软官方页 SQL Server PHP 驱动系统要求 下载对应 ZIP 包（如 php_sqlsrv_82_nts_x64.dll）
• 扩展必须放对位置：extension_dir 指向的目录，不是随便丢进 ext/ 就行；可用 php --ini 查配置文件路径，再确认 extension_dir 值

启用扩展并验证 php.ini 配置

光复制 DLL 文件不够，php.ini 必须显式启用两个扩展（选其一即可，但别同时开）：若用原生 API 就启 sqlsrv，若用 PDO 就启 pdo_sqlsrv。漏掉 extension= 行，或写成 extension=php_sqlsrv.dll（而实际文件名是 php_sqlsrv_82_nts_x64.dll），都会导致连接时抛出 Class 'Sqlsrv' not found 或 Driver not found。

实操建议：

• 在 php.ini 末尾添加（注意路径和文件名完全一致）：

  extension=sqlsrv
  extension=pdo_sqlsrv

  （仅需启用一个；若只用 PDO，可只留第二行）
• 重启 Web 服务（Apache/Nginx）或 CLI 环境后，运行 php -m | findstr sqlsrv 验证是否加载成功
• 如果用 XAMPP/MAMP，注意它可能有多个 php.ini（CLI 和 Apache 各用一份），务必改对那个被 Web 服务读取的

使用 sqlsrv_connect() 建立基础连接

sqlsrv_connect() 是最轻量的连接方式，适合快速验证连通性。它不支持长连接复用，每次调用都新建 TCP 连接，但胜在参数直白、错误反馈明确。常见失败点不是密码错，而是服务器名写成 localhost —— SQL Server 默认不监听 127.0.0.1 的 TCP/IP，得用实例名（如 SERVERNAME\SQLEXPRESS）或启用 TCP/IP 协议并指定端口（如 SERVERNAME,1433）。

实操示例：

$serverName = "DESKTOP-ABC\\SQLEXPRESS";
$connectionOptions = [
    "Database" => "testdb",
    "Uid" => "sa",
    "PWD" => "your_password"
];
$conn = sqlsrv_connect($serverName, $connectionOptions);
if ($conn === false) {
    die(print_r(sqlsrv_errors(), true));
}

注意：\\ 是 Windows 实例名转义必需；Linux/macOS 连 Azure SQL 或 Linux SQL Server 时，用逗号分隔主机和端口："server,1433"。

PDO 方式连接并处理字符集乱码

用 PDO 连 SQL Server 时，默认不设 CharacterSet 会导致中文变问号或空格，尤其在 nvarchar 字段上。这不是 PHP 层编码问题，而是 SQL Server 驱动未协商好通信字符集。必须在 DSN 中显式加 ;CharacterSet=utf8（注意是 utf8，不是 utf8mb4），否则 SET NAMES utf8 类语句无效。

实操要点：

• DSN 格式严格：

  sqlsrv:server=DESKTOP-ABC\\SQLEXPRESS;Database=testdb;CharacterSet=utf8

• 用户名密码传入 new PDO(...) 第二、三参数，不要塞进 DSN
• 若仍乱码，检查 SQL Server 数据库默认排序规则是否含 _UTF8（如 Latin1_General_100_CI_AS_SC_UTF8），旧版规则（如 Chinese_PRC_CI_AS）对 UTF-8 支持有限

真正卡住人的往往不是语法，而是驱动版本错配、INI 文件改错位置、实例名写法不符 SQL Server 实际配置，以及字符集没在 DSN 里硬编码——这些地方一错，错误信息都很模糊，得逐层排除。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~