当前位置：首页 > 文章列表 > 文章 > php教程 > PHP连接SQLServer配置方法详解

PHP连接SQLServer配置方法详解

2025-08-12 15:07:52 0浏览收藏

PHP连接SQL Server配置是PHP开发中常见的需求，本文提供详细的配置教程，助你轻松实现PHP与SQL Server数据库的连接。首先，你需要安装sqlsrv和pdo_sqlsrv扩展，从微软GitHub下载对应PHP版本的驱动，并配置php.ini文件。其次，安装ODBC驱动，推荐使用Microsoft ODBC Driver 17，并通过ODBC数据源管理器验证安装。文章还提供了使用PDO和sqlsrv扩展的连接代码示例。最后，针对常见问题，如防火墙阻止、SQL Server未启用TCP/IP、驱动未加载及版本不匹配等，提供了详细的排查方案，确保连接顺利。掌握这些关键步骤，即可在Windows环境下成功配置PHP连接SQL Server，为你的Web应用开发奠定基础。

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连接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配置方法详解》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于php,sqlserver,驱动,odbc,连接配置的内容请关注golang学习网公众号！

php sqlserver 驱动 odbc 连接配置