MongoDB\Driver\ClientEncryption::addKeyAltName()函式—用法及示例

函式名：MongoDB\Driver\ClientEncryption::addKeyAltName()

函式描述：此函式用於向客戶端加密物件新增金鑰的備用名稱。備用名稱是一個字串，用於標識金鑰的其他別名。

引數：

1. keyId (string)：金鑰的唯一識別符號。
2. altName (string)：金鑰的備用名稱。

返回值：無返回值。

適用版本：MongoDB PHP Library 1.7.0 及以上版本。

示例：

<?php

// 建立加密客戶端物件
$encryption = new MongoDB\Driver\ClientEncryption($kmsProvider, $keyVaultNamespace, $options);

// 新增金鑰的備用名稱
$keyId = "5f6d0e7d4d9e7e0012345678";
$altName = "my_key_alias";
$encryption->addKeyAltName($keyId, $altName);

?>

以上示例演示瞭如何使用addKeyAltName()函式向客戶端加密物件新增金鑰的備用名稱。首先，我們建立了一個加密客戶端物件$encryption，然後透過呼叫addKeyAltName()函式，傳遞金鑰的唯一識別符號$keyId和備用名稱$altName，將備用名稱新增到金鑰中。