[函数]rnp_list_keys()函数—用法及示例

函数名：rnp_list_keys()

适用版本：PHP 7.4.0 及以上版本

函数描述：rnp_list_keys() 函数用于获取指定路径下的所有 OpenPGP 密钥。

用法：

rnp_list_keys(string $keyring, int $flags = 0): array|false

参数：

• $keyring：要获取密钥的路径，可以是文件或目录的路径。
• $flags（可选）：一个整数值，用于指定额外的选项。默认为0。

返回值：

• 如果成功获取密钥，则返回一个包含所有密钥信息的关联数组。
• 如果发生错误，则返回 false。

示例：

$keyring = '/path/to/keyring.gpg';
$keys = rnp_list_keys($keyring);

if ($keys !== false) {
    foreach ($keys as $key) {
        echo "Key ID: " . $key['keyid'] . "\n";
        echo "User ID: " . $key['userid'] . "\n";
        echo "Algorithm: " . $key['alg'] . "\n";
        echo "Creation Time: " . date('Y-m-d H:i:s', $key['creation_time']) . "\n";
        echo "Expiration Time: " . date('Y-m-d H:i:s', $key['expiration_time']) . "\n";
        echo "--------------------------------------\n";
    }
} else {
    echo "Failed to retrieve keys.\n";
}

注意事项：

• 在调用此函数之前，请确保已经安装了 rnp 扩展。
• $keyring 参数可以是一个单独的密钥文件路径，也可以是一个包含多个密钥文件的目录路径。
• $flags 参数是一个位掩码，可以使用 RNP_KEY_FLAG_PUBLIC、RNP_KEY_FLAG_SECRET、RNP_KEY_FLAG_SUBKEY 和 RNP_KEY_FLAG_UID 常量来指定不同的选项。
• 返回的关联数组中包含的键值有：keyid（密钥ID）、userid（用户ID）、alg（加密算法）、creation_time（创建时间）和 expiration_time（过期时间）。