PHP连SQL Server需确保sqlsrv或pdo_sqlsrv扩展与PHP版本、TS/NTS、架构完全匹配，正确配置php.ini启用扩展，连接时用实例名或端口，PDO需在DSN中指定CharacterSet=utf8。
确认 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免费学习笔记（深入）”；
- 用
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免费学习笔记（深入）”；
- 在
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 里硬编码——这些地方一错，错误信息都很模糊，得逐层排除。
