PHP连接SQL Server必须使用sqlsrv或pdo_sqlsrv扩展,禁用mysql/mysqli;Windows选sqlsrv(函数式API)或pdo_sqlsrv(PDO接口),Linux/macOS仅支持pdo_sqlsrv;需正确配置DSN、认证、加密及UTF-8编码。

PHP 连接 SQL Server 需要装对扩展,不是 mysql 或 mysqli
PHP 原生不支持 SQL Server,mysql_connect() 和 mysqli_connect() 完全无效,强行用会报 Fatal error: Uncaught Error: Call to undefined function mysqli_connect() 或类似连接拒绝错误。必须启用 Microsoft 官方维护的 sqlsrv 或 pdo_sqlsrv 扩展。
这两个扩展不能共存于同一 PHP 实例(尤其 Windows 下),选一个即可;Linux/macOS 必须用 pdo_sqlsrv(通过 ODBC 驱动)。
-
sqlsrv:仅 Windows,函数式 API(如sqlsrv_connect()),无需 PDO 层 -
pdo_sqlsrv:Windows/Linux/macOS 均支持,PDO 接口(new PDO()),推荐新项目使用 - 确认已安装:运行
php -m | findstr sqlsrv(Windows)或php -m | grep sqlsrv(Linux/macOS)
Windows 下启用 sqlsrv 扩展的三步实操
以 PHP 8.1 + Apache 为例(其他版本路径微调):
- 下载对应 PHP 版本和线程安全(TS/NTS)的 Microsoft Drivers for PHP for SQL Server ZIP 包,解压后取
php_sqlsrv_81_ts.dll(TS)或php_sqlsrv_81_nts.dll(NTS) - 把 DLL 放进 PHP 的
ext目录(如C:\php\ext\),然后在php.ini末尾加一行:extension=php_sqlsrv_81_ts.dll - 重启 Web 服务(Apache/Nginx)或 CLI,执行
php --ri sqlsrv看是否显示扩展信息;若报“unable to load dynamic library”,检查 DLL 位数(x64/x86)是否与 PHP 一致
pdo_sqlsrv 连接字符串写法和常见认证失败原因
连接 SQL Server 不是填个 IP 和端口就行,认证方式、实例名、加密设置都会导致 SQLSTATE[08001]: [Microsoft][ODBC Driver 17 for SQL Server]Login timeout expired 或 Cannot connect: Login failed for user。
立即学习“PHP免费学习笔记(深入)”;
$dsn = 'sqlsrv:server=192.168.1.100;Database=testdb;Encrypt=no;TrustServerCertificate=yes;';
$user = 'sa';
$pass = 'your_password';
try {
$pdo = new PDO($dsn, $user, $pass);
} catch (PDOException $e) {
echo $e->getMessage();
}
-
Encrypt=no是关键:SQL Server 默认要求加密,但本地开发常关掉;生产环境务必设为yes并配好证书 - 如果连的是命名实例(如
SQLEXPRESS),写成server=192.168.1.100\\SQLEXPRESS,注意双反斜杠转义 - Windows 身份验证不可用于远程连接(除非配置 Kerberos),一律用 SQL 登录(sa 或普通用户),且该用户需在 SQL Server 中启用混合模式并授予权限
- 防火墙要放行 TCP 1433(或实例实际端口),SQL Server 配置管理器里确认“SQL Server 网络配置 → 协议”中 TCP/IP 已启用
查询时中文乱码?别硬改 SET NAMES
SQL Server 没有 SET NAMES utf8 这种语法,sqlsrv_query() 或 PDO::query() 执行它会直接报错。乱码根源通常是字段用 varchar 存中文但客户端没声明编码,或数据库排序规则不兼容。
- 建表时优先用
nvarchar(Unicode),而非varchar;如果已有varchar字段,连接 DSN 加CharacterSet=UTF-8(pdo_sqlsrv支持,sqlsrv不支持) - 检查数据库默认排序规则是否含
_UTF8(如Chinese_PRC_CI_AS_UTF8),旧规则如Chinese_PRC_CI_AS对 UTF-8 字符串支持有限 - PHP 输出前确保 HTTP 头或 HTML meta 声明了 UTF-8,否则浏览器渲染仍可能出错
php --ri sqlsrv 和 telnet 192.168.1.100 1433,再写第一行 new PDO()。











