PHP连接SQLServer配置方法（Windows版）

前往下载Windows工具

欢迎各位小伙伴来到golang学习网，相聚于此都是缘哈哈哈！今天我给大家带来《PHP连接SQL Server配置教程（Windows）》，这篇文章主要讲到等等知识，如果你对文章相关的知识非常感兴趣或者正在自学，都可以关注我，我会持续更新相关文章！当然，有什么建议也欢迎在评论留言提出！一起学习！

PHP连接SQL Server的关键在于安装驱动、配置php.ini并确保SQL Server允许远程连接。1. 安装sqlsrv和pdo_sqlsrv扩展：从微软GitHub下载对应PHP版本的驱动，复制DLL文件到ext目录，并在php.ini中添加扩展引用。2. 安装ODBC驱动：推荐使用Microsoft ODBC Driver 17，并通过ODBC数据源管理器验证安装。3. 编写连接代码：可使用PDO或sqlsrv扩展建立连接。4. 常见问题包括防火墙阻止、SQL Server未启用TCP/IP、驱动未加载及版本不匹配，需逐一排查。

PHP连接SQL Server在Windows环境下其实并不复杂，但对新手来说可能会遇到一些配置问题。关键在于正确安装驱动、设置php.ini文件，并确保SQL Server允许远程连接。

1. 安装SQL Server驱动

PHP默认不自带连接SQL Server的驱动，你需要手动下载并安装微软提供的驱动程序。目前主流使用的是sqlsrv和pdo_sqlsrv扩展。

操作步骤：

• 前往微软官方GitHub页面下载对应版本的驱动：https://github.com/Microsoft/msphpsql
• 解压后找到两个DLL文件（如 php_sqlsrv_80_ts.dll 和 php_pdo_sqlsrv_80_ts.dll），复制到你的PHP安装目录下的 ext 文件夹中。
• 打开 php.ini 文件，添加以下两行：

extension=php_sqlsrv_80_ts.dll
extension=php_pdo_sqlsrv_80_ts.dll

注意：根据你的PHP版本选择合适的驱动，比如7.4、8.0等，还有ts（线程安全）和nts（非线程安全）的区别。

2. 配置ODBC驱动支持

除了PHP扩展，还需要安装ODBC驱动来支持连接SQL Server。

推荐安装：

• Microsoft ODBC Driver 17 for SQL Server（适用于较新版本的Windows）
• 如果你用的是旧系统，可能需要安装ODBC Driver 11或13

你可以通过控制面板 → 管理工具 → ODBC 数据源管理器 来确认是否已安装成功。

3. 编写连接代码

一旦环境配置好，就可以使用PDO或sqlsrv扩展进行连接了。下面是一个使用PDO的例子：

<?php
$serverName = "your_server_name_or_ip";
$database = "your_database_name";
$username = "your_username";
$password = "your_password";

try {
    $conn = new PDO("sqlsrv:Server=$serverName;Database=$database", $username, $password);
    $conn->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    echo "连接成功！";
} catch (PDOException $e) {
    echo "连接失败: " . $e->getMessage();
}
?>

如果你更习惯使用sqlsrv函数，也可以这样写：

<?php
$serverName = "your_server_name_or_ip";
$connectionOptions = array(
    "Database" => "your_database_name",
    "Uid" => "your_username",
    "PWD" => "your_password"
);

$conn = sqlsrv_connect($serverName, $connectionOptions);

if ($conn === false) {
    die(print_r(sqlsrv_errors(), true));
}

echo "连接成功！";
?>

4. 常见问题排查

有时候即使配置看起来没问题，也会出现连接失败的情况。以下是一些常见原因：

• 防火墙阻止连接：检查服务器端防火墙是否放行1433端口（SQL Server默认端口）。
• SQL Server不允许远程连接：打开SQL Server配置管理器 → SQL Server网络配置 → 协议 → TCP/IP 启用，并重启服务。
• 驱动未加载：运行 php -m 查看 sqlsrv 或 pdo_sqlsrv 是否出现在模块列表中。
• PHP版本与驱动不匹配：一定要确认你下载的dll是对应当前PHP的版本和线程类型。

基本上就这些。虽然步骤有点多，但只要一步步来，问题不大。重点还是版本匹配和驱动安装这两个环节容易出错。

好了，本文到此结束，带大家了解了《PHP连接SQLServer配置方法（Windows版）》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！