PHP连接SQL Server完整教程：从环境搭建到执行查询的全流程实战指南-猿码集

1. 环境搭建与依赖准备

1.1 Windows 环境搭建

在Windows系统下，搭建本地开发环境时需要关注 PHP 版本、Web 服务（如 IIS、Apache）以及与 SQL Server 的连接驱动。这个阶段的关键点是确保你使用的SQL Server 驱动与所安装的 PHP 版本兼容，以实现稳定的连接。

为了实现与 SQL Server 的连接，通常要安装 Microsoft 提供的 PHP for SQL Server 驱动，并在 php.ini 中开启相应扩展。请优先采用官方推荐的驱动，以获得更好的稳定性和官方支持。下面给出常见的启用方式要点：

在 php.ini 中正确加载扩展后，务必重启 Web 服务器以应用变更，确保后续的连接测试能够成功完成。

; PHP ini 配置示例（启用 SQL Server 驱动）
extension=php_pdo_sqlsrv.dll
extension=php_sqlsrv.dll

1.2 Linux 环境搭建

对于 Linux环境，通常需要安装 Open Database Connectivity (ODBC) 驱动以及相应的 PHP 扩展，例如 pdo_sqlsrv 或 sqlsrv。这一步的要点在于确保系统中存在兼容的 ODBC 驱动，以及 PHP 能正确加载对应的扩展。

常用的安装步骤包括添加 Microsoft 的软件源、安装 msodbcsql、以及 PHP 的 pdo_sqlsrv 与 sqlsrv 扩展，随后重启 Web 服务以使扩展生效。成功之后，可以通过简单的命令确认扩展已加载。

一个可执行的快速检查是通过命令行查看加载的扩展列表，若出现 pdo_sqlsrv 与 sqlsrv，表示配置基本完成。以下给出常用验证命令的示例：

# Linux 示例（Ubuntu/Debian 系列）
sudo apt-get update
sudo apt-get install -y msodbcsql17 php-pdo_sqlsrv
php -m | grep -E 'pdo_sqlsrv|sqlsrv'

2. 连接驱动与环境检查

2.1 安装并验证 PDO_SQLSRV 驱动

在PDO驱动层面，pdo_sqlsrv 提供了对 SQL Server 的原生支持，能够让你通过 PDO 接口执行参数化查询、事务控制等操作，具备更好的可维护性与跨数据库能力。确保在系统中已经正确安装并加载该扩展，是后续使用 PDO 连接的前提。

验证是否成功加载，可以通过简单的 PHP 代码或命令行来检查加载状态。若未加载，请参考前一节中的安装步骤，确保与你的 PHP 版本匹配的二进制文件被使用。

下面给出一个快速的代码级别检查，帮助你确认是否已加载 pdo_sqlsrv：

2.2 安装与验证 SQLSRV 扩展（可选）

除了 PDO 方式，SQLSRV 作为原生 PHP 扩展也提供直接的 API 查看与执行能力。对于某些旧有项目或性能对比需求，直接使用 sqlsrv 扩展仍然是值得考虑的路径。

若你选择使用 SQLSRV，同样需要确保扩展已可用，可以借助简单的查询示例进行验证。

下面的 PHP 代码演示了一个最小的连接与查询流程，便于快速验证：

 'TestDB', 'UID' => 'sa', 'PWD' => 'YourStrongPassword');
$conn = sqlsrv_connect($serverName, $connectionInfo);
if ($conn) {echo 'SQLSRV 连接成功';sqlsrv_close($conn);
} else {echo 'SQLSRV 连接失败: '.print_r(sqlsrv_errors(), true);
}
?>

3. 使用 PDO 连接 SQL Server 的全流程

3.1 基于 PDO 的基本连接

本节展示一个最小可运行的 PDO 连接示例，包含对异常的处理以及后续的查询准备。该方法是现代 PHP 应用中推荐的连接方式，具有更好的错误处理和参数化支持能力。

PHP连接SQL Server完整教程：从环境搭建到执行查询的全流程实战指南

在连接阶段，DSN 字符串需要正确指定服务器地址和数据库名称，通常形如 sqlsrv:Server=你的服务器;Database=你的数据库。如果连接成功，你将得到一个可以执行预处理语句的对象。

setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);echo 'PDO 连接成功';
} catch (PDOException $e) {echo 'PDO 连接失败: '.$e->getMessage();
}
?>

3.2 参数化查询与结果获取

使用 准备语句 可以显著降低 SQL 注入风险，并提升查询性能。下面示例演示如何进行参数化查询并获取结果集，常用于获取表中符合条件的多行数据。

prepare($sql);
$stmt->execute([1]);
$rows = $stmt->fetchAll(PDO::FETCH_ASSOC);
foreach ($rows as $row) {echo $row['id'].'|'.$row['name'].'|'.$row['email']."\n";
}
?>

3.3 使用事务进行多步更新

在涉及多步业务操作时，事务是确保数据一致性的关键。使用 PDO 的事务接口可以原子性地提交或回滚一组语句。

beginTransaction();$pdo->exec("UPDATE Accounts SET balance = balance - 100 WHERE id = 2");$pdo->exec("UPDATE Accounts SET balance = balance + 100 WHERE id = 3");$pdo->commit();
} catch (Exception $e) {$pdo->rollBack();echo "事务失败: ".$e->getMessage();
}
?>

4. 直接使用 SQLSRV 扩展实现连接与查询

4.1 直接连接并执行查询

在某些场景下，直接使用 SQLSRV 扩展进行连接与查询，可能带来更低的额外开销与更原生的 API 控制。下面的示例展示了连接、准备语句及结果遍历的完整流程。重点在于正确处理错误信息与资源释放。

 "TestDB", "UID" => "sa", "PWD" => "YourStrongPassword");
$conn = sqlsrv_connect($serverName, $connectionInfo);
if ($conn) {$tsql = "SELECT id, name FROM Users WHERE status = ?";$params = array(1);$stmt = sqlsrv_query($conn, $tsql, $params);while ($row = sqlsrv_fetch_array($stmt, SQLSRV_FETCH_ASSOC)) {echo $row['id'].'|'.$row['name']."\n";}sqlsrv_free_stmt($stmt);sqlsrv_close($conn);
} else {die(print_r(sqlsrv_errors(), true));
}
?>

4.2 使用事务与错误处理

当使用 SQLSRV 扩展进行多语句操作时，显式地控制事务边界可以提高数据的一致性。下面示例展示了如何在一个连接上开启事务、执行多步操作并在出错时回滚。相关的错误处理信息对排查问题很有帮助。

5. 性能、错误排查与安全性要点

5.1 性能优化要点

在实际项目中，性能通常来自于合适的查询、合理的字段裁剪，以及对连接的正确管理。优先使用 参数化查询、尽量避免在循环中拼接 SQL，并利用数据库端的索引优化查询计划。

另外，采用 连接池（如果运行环境支持）可以减少每次请求的连接建立成本，同时使用 FETCH 模式和分页查询降低单次查询的数据量。对于大数据量查询，考虑分批处理和服务端游标，而非一次性加载全部数据。

在生产环境中，请通过合适的日志与监控来追踪查询性能，确保不出现长时间执行的查询被无意触发的情况。

`5.2 错误排查与安全性要点`


在排查连接问题或查询错误时，开启详细错误信息对定位很有帮助。使用 PDO 时，设置 ERRMODE_EXCEPTION，当发生异常就能得到错误信息；使用 SQLSRV 时，读取 sqlsrv_errors() 的返回值可以帮助定位错误代码与描述。
在安全性方面，不要直接拼接 SQL，尽量使用 参数化查询；为数据库账户设置最小权限，避免使用 SA 等超级账户在应用层直接暴露；对敏感信息如数据库密码，应采用环境变量或密钥管理方案进行保护。
prepare("SELECT id FROM Users WHERE id = ?");$stmt->execute([10]);
} catch (PDOException $e) {error_log($e->getMessage());
}
?>