如何使用PHP的LDAP扩展通过Active Directory密码认证连接指定数据库

嘿，我来帮你搞定这个Active Directory（AD）密码认证连接数据库的问题！首先得纠正一个小误区：LDAP扩展主要是用来直接和AD服务器做身份校验的，但针对你这个examplesite.database.windows.net（看起来是Azure SQL服务器）的场景，用微软官方的SQL Server PHP扩展（pdo_sqlsrv或sqlsrv）就能直接实现AD密码认证连接，不需要单独用LDAP扩展绕一圈，这样更简单也更符合官方推荐的方式。

下面是具体的实现步骤和代码示例，完全贴合你的需求：

第一步：确认PHP环境安装了对应扩展 #

你需要先确保你的PHP环境已经安装了**pdo_sqlsrv或者sqlsrv**扩展——这俩是微软官方维护的PHP连接SQL Server/Azure SQL的扩展，原生支持AD密码认证功能。可以通过在PHP脚本里执行phpinfo();来查看扩展是否已经启用。

第二步：代码实现（两种常用方式） #

方式一：使用PDO_SQLSRV扩展（推荐，更符合PHP现代开发规范） #

<?php
// 数据库配置信息
$serverName = "examplesite.database.windows.net";
$databaseName = "Database";
$adUsername = "account@example.com";
$adPassword = "password";

// 核心连接选项，明确指定认证方式为AD密码
$connectionOptions = [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    "Database" => $databaseName,
    "Authentication" => "ActiveDirectoryPassword"
];

try {
    // 建立数据库连接
    $pdoConn = new PDO(
        "sqlsrv:server=$serverName;",
        $adUsername,
        $adPassword,
        $connectionOptions
    );
    
    echo "AD密码认证连接成功！";

    // 这里可以添加你的数据库操作代码，比如查询示例
    // $stmt = $pdoConn->query("SELECT TOP 10 * FROM YourTableName");
    // while ($row = $stmt->fetch(PDO::FETCH_ASSOC)) {
    //     print_r($row);
    // }

} catch (PDOException $e) {
    die("连接或操作失败: " . $e->getMessage());
} finally {
    // 记得关闭连接
    if (isset($pdoConn)) {
        $pdoConn = null;
    }
}
?>

方式二：使用SQLSRV扩展（过程式风格） #

<?php
// 数据库配置信息
$serverName = "examplesite.database.windows.net";
$databaseName = "Database";
$adUsername = "account@example.com";
$adPassword = "password";

// 连接选项配置
$connectionOptions = [
    "Database" => $databaseName,
    "Uid" => $adUsername,
    "PWD" => $adPassword,
    "Authentication" => "ActiveDirectoryPassword"
];

// 建立连接
$conn = sqlsrv_connect($serverName, $connectionOptions);

if ($conn === false) {
    die("连接失败: " . print_r(sqlsrv_errors(), true));
}
echo "AD密码认证连接成功！";

// 执行查询示例
// $sql = "SELECT TOP 10 * FROM YourTableName";
// $stmt = sqlsrv_query($conn, $sql);
// if ($stmt === false) {
//     die(print_r(sqlsrv_errors(), true));
// }
// while ($row = sqlsrv_fetch_array($stmt, SQLSRV_FETCH_ASSOC)) {
//     print_r($row);
// }

// 关闭连接
sqlsrv_close($conn);
?>

几个关键的注意事项 #

• 防火墙配置：一定要确认你的应用服务器IP已经被添加到Azure SQL服务器的防火墙允许列表里，否则会直接被拒绝连接，这是新手常踩的坑！
• 账号权限：你的AD账号account@example.com必须被授予目标数据库Database的相应权限（比如读写权限），不然就算认证通过了也没法操作数据库。
• 敏感信息安全：绝对不要在代码里硬编码明文密码！实际项目中一定要用环境变量（比如getenv('AD_DB_PASSWORD')）或者加密的配置文件来存储账号密码，避免泄露风险。
• 版本兼容：建议使用PHP 7.4及以上版本，搭配最新版的pdo_sqlsrv/sqlsrv扩展，避免因版本过旧导致的认证逻辑不支持问题。

内容来源于stack exchange