MongoDB\Driver\ClientEncryption::getKeyByAltName()
通过指定的备用名称获取客户端加密的密钥
函数名：MongoDB\Driver\ClientEncryption::getKeyByAltName()
适用版本：MongoDB PHP Library 1.9.0 及以上版本
用法：该函数用于通过指定的备用名称获取客户端加密的密钥。
参数：
altName（string）：备用名称，用于查找相应的密钥。
返回值：
如果找到匹配的密钥，将返回一个MongoDB\BSON\Binary对象，其中包含密钥的二进制数据。
如果未找到匹配的密钥，将返回null。
示例：
<?php
// 创建ClientEncryption对象
$clientEncryption = new MongoDB\Driver\ClientEncryption($keyVaultNamespace, $kmsProviders);
// 获取指定备用名称的密钥
$altName = "my_key";
$key = $clientEncryption->getKeyByAltName($altName);
if ($key) {
echo "找到了备用名称为 {$altName} 的密钥！\n";
echo "密钥的二进制数据为：" . bin2hex($key->getData()) . "\n";
} else {
echo "未找到备用名称为 {$altName} 的密钥。\n";
}
?>
注意事项：
在使用该函数之前，必须先创建一个MongoDB\Driver\ClientEncryption对象，并通过构造函数提供密钥库命名空间和密钥管理服务提供者。
该函数需要连接到MongoDB服务器，并且需要有正确的权限才能访问密钥库。
备用名称是在创建密钥时指定的，用于在密钥库中标识密钥。确保提供的备用名称与实际创建密钥时使用的备用名称匹配，否则函数将无法找到对应的密钥。