PHP8 rnp_op_generate_key
(PECL rnp >= 0.1.1)
rnp_op_generate_key — 生成密钥
说明
rnp_op_generate_key(
RnpFFI $ffi,
string $userid,
string $key_alg,
string $sub_alg = ?,
array $options = ?
): string|false
参数
ffi
rnp_ffi_create返回的 FFI 对象。
userid
PGP 用户 ID - 旨在表示的文本 密钥持有者的姓名和电子邮件地址。
key_alg
主键算法(即“RSA”、“DSA”等)。
sub_alg
子项算法。如果未设置,则不会生成子项。
options
带有选项的关联数组。
钥匙 数据类型 说明 "bits"
整数 主键大小(以位为单位)。仅适用于 RSA、DSA 和 El-Gamal 密钥。 "hash"
字符串 自签名或子键绑定签名中使用的哈希算法。 "dsa_qbits"
整数 设置 DSA 密钥的参数大小。 注意:将设置适当的默认值,具体取决于键位。但是,您可以 如果需要,请覆盖它。 q
"curve"
字符串 设置用于 ECC 键的曲线。注意:这仅适用于 ECDSA、ECDH 和 SM2 密钥。 "request_password"
布尔 启用通过密码提供程序请求密码。此密码 将用于密钥加密。密码提供程序回调函数应设置在 通过调用 rnp_ffi_set_pass_provider() 前进。 注意:如果密码是通过以下方式设置的,则此设置将被忽略 "password"
"password"
字符串 设置用于加密密钥数据的密码。 "expiration"
整数 设置密钥和子密钥过期时间(以秒为单位)。 "sub_bits"
整数 子项大小(以位为单位)。仅适用于 RSA、DSA 和 El-Gamal 密钥。 "sub_hash"
字符串 子项自签名或子项绑定签名中使用的哈希算法。 "sub_curve"
字符串 设置用于 ECC 子项的曲线。注意:这仅适用于 ECDSA、ECDH 和 SM2 密钥。
返回值
生成的主键的指纹 或者在失败时返回 false.可以使用此指纹 稍后在 Sign 和 Encrypt 操作中引用密钥。密钥数据存储在 FFI 中 内存上下文,可以使用 rnp_save_keys() 或 rnp_save_keys_to_path() 保存。