PHP - Função openssl_pkey_export_to_file ()
Definição e Uso
o openssl_pkey_export_to_file() função irá exportar a chave para um arquivo.
Descrição
A função openssl_pkey_export_to_file () salva a chave em um formato PEM. PEM significa Privacy-Enhanced Mail e armazena principalmente chaves criptográficas e certificados.
Sintaxe
openssl_pkey_export_to_file ( mixed $key , string $outfilename [, string $passphrase [, array $configargs ]] ) : bool
Parâmetros
Sr. Não | Parâmetro | Descrição |
---|---|---|
1 | key |
A chave que você deseja exportar para o arquivo. |
2 | outfilename |
O outfilename é o caminho onde você deseja salvar o arquivo .pem. |
3 | passphrase |
A senha que você pode usar para proteger o arquivo. |
4 | configargs |
O parâmetro configargs são os detalhes de configuração que precisam ser fornecidos à função para gerar o par de chaves privada / pública. Os detalhes são descritos abaixo. |
configargs
Por padrão, o openssl_pkey_new () faz uso dos detalhes de configuração presentes no openssl.cnf. Mas usando configargs, você pode substituí-los. Os detalhes de configuração são os seguintes:
chave em configargs | tipo | chave usada em openssl.conf | descrição |
---|---|---|---|
digest_alg | corda | default_md | Métodos resumidos que você obtém em openssl_get_md_methods (). |
x509_extensions | corda | x509_extensions | Extensões usadas ao criar um certificado x509. |
req_extensions | corda | req_extensions | Extensões usadas ao criar um CSR. |
private_key_bits | inteiro | default_bits | Especifica quantos bits devem ser usados ao gerar uma chave privada. |
private_key_type | inteiro | Nenhum | O tipo de chave privada a ser criada. Pode ser um de OPENSSL_KEYTYPE_DSA, OPENSSL_KEYTYPE_DH, OPENSSL_KEYTYPE_RSA ou OPENSSL_KEYTYPE_EC. O valor padrão é OPENSSL_KEYTYPE_RSA. |
encrypt_key | boleano | encrypt_key | Se a chave exportada deve ser criptografada? |
encrypt_key_cipher | inteiro | Nenhum | Constantes de codificação como OPENSSL_CIPHER_RC2_40 (inteiro), OPENSSL_CIPHER_RC2_128 (inteiro), OPENSSL_CIPHER_RC2_64 (inteiro), OPENSSL_CIPHER_DES (inteiro), OPENSSL_CIPHER_3DES (inteiro) etc. |
curve_name | corda | Nenhum | Um dos nomes da curva retornado por esta função openssl_get_curve_names (). |
config | corda | N / D | Você pode alterar a configuração em openssl.conf de acordo com suas necessidades e fornecer o caminho aqui. |
Valores Retornados
A função PHP openssl_pkey_export_to_file () retorna verdadeiro se houver sucesso e falso se houver falha.
Versão PHP
Esta função funcionará na versão do PHP superior a 5.0.0.
Exemplo 1
Trabalho de openssl_pkey_export_to_file () -
<?php
//creating private key
$privkey = openssl_pkey_new();
openssl_pkey_export_to_file($privkey, 'C:/xampp/htdocs/modules/openssl/keytest.pem');
?>
Os detalhes armazenados no arquivo keytest.pem são os seguintes -
-----BEGIN PRIVATE KEY-----
MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQDaqNK97A+mL9Xu
IDt3rz9yfFUvrLcDEvsDa9JsjQByJVbdRtaNl6nfg91/LfKO8zAeG8srd292jcYk
9MgBhkpMCHvF/QhWjA4IdPLdWHCbYfjF/LHmo/z022/FqTnjQtFws992/ClhZdo6
kpDlU/H2lmbnCwrsqHlqcQ7bzBgC5U5SW0t3A03PSqxQTIFPOHi1Yx1Il5jH/H11
6UXDKogAWsseRpdwVdsCy6Wj3rkybr1pr7CDkHSS49MAvJ4e6xhs+je12lrtyChR
ZTIYLICzEG7a1n0BPGAI1bQcivHXNipUkAYFn221gKRuB+9SQvC3VKbNXy8Oc7N9
HEahD8S3AgMBAAECggEBAKzEU68og7zlcvzxjsskNtd4kb5Xk0rkhlzPprWKO131
TssLm57IxLoMcMh6P3rff5dqkn9HoVRk9LhiiF1cA/xLf7CSGzJ2+ueHsBVgOaks
IeodnVsFG2tEru3YphqAwwdvuBNFblS8q084WzA3waj6cVgAi6MuArEtn3XfruEp
Yryc4Y1I1SB92x4y85tZ/PcomumPH0djKQeuhzy7f7GloJRfdshNENRbkdLc65N5
j8hy7WxMSa0dpJ3ZJMmgNfek9nALntSZfOsHGMZ/Wog8eV6+HzCwqqrMkR15pZI1
HqvVszU1iwoUJvlGoxInJOqJ2c6lBSBOBBR8DuuQixECgYEA+8RKXcw0U3VU8zJO
NTFzSDEtFYKZ5Bg4IPaYSTSo/ojiL3VrLeocRq3/2zdeCw8wx9eNZbcBW93lWVxK
q2G0X4XgonorEEONBvL9aE/D7wBCMYPWDXd/KQVZW8CPwcy10g2oIi3SqbcTQ/gT
fcmcHAQD2wVgo9XBlg24ESAP01MCgYEA3lYGasOvDweca5GCiP4m1oOH605haIUU
f5CDWXbZ6QjcoUQQB0CoDtTl3QpBd3KGbd+PbqU8xb44+LhrVIsjUyZs6k+eLACe
Dufzq00mIRSl/TZ0R3q17lAMmxId9QramDScpmqqqXonpOpdEoonThynhLyANgX3
eYGLXeqaII0CgYBPVi/JFwx2MEcwy+1xPcACQ9zdJmawRiGJ4atjhkCq1R/RrMK1
mUyHyVUTE4ODIKpSj05zexPmiyo22qp9DzDz2RBMowrm+SJ7yh6ovFoV+pLhX5YY
cEuV9aWPEEM84vF42+zbuGzmJlbf2FDsFpgnC+zbG/q0Jiv2ySPz4ZKbGQKBgQDM
ek9ih1+LshNAts1Xkm5DoSoy1Z4uUx48B7tVX0If2N+YjRE0qlklctWIiXMWGMTb
bdzrBJq0vjKFRI6pbWFqio9mmxy8GUFEMjzekZB8ohHao+cjCg8iAorlXy8f+wB5
NQHQ547XWRn2yPgaIebuJtpF8Fr11Fz6aZK0KBvhzQKBgGRwuxq6IhIROupoDRpU
RHuqICeQQYcf7Cfk7+ZyYJnA1fbOowj4Q5zvbWa6N2Ygyq2KIl0P5YL4Atb7aRKS
e6ol8lIKZM9ysbS+wR0OhhTJs/9CqpgvDbYNQFiaVZtGRpSNCxHkhn0cAR7lzK4P
ROQC7p9zXJhAmzE8/hTD9eaH
-----END PRIVATE KEY-----
Exemplo 2
Para obter a chave do arquivo .pem -
<?php
//creating private key
$privkey = openssl_pkey_new();
openssl_pkey_export_to_file($privkey, 'C:/xampp/htdocs/modules/openssl/keytest.pem');
//using .pem file with private key.
$testprivatekey = openssl_get_privatekey(file_get_contents('C:/xampp/htdocs/modules/openssl/keytest.pem'));
if ($testprivatekey === false) {
var_dump(openssl_error_string());
} else {
//var_dump($testprivatekey);
$key_details = openssl_pkey_get_details($testprivatekey);
print_r($key_details["key"]);
}
?>
Os detalhes armazenados no arquivo test-csr1.pem são os seguintes -
-----BEGIN PUBLIC KEY-----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAnbGAblUCP6sZvbi2JM4G
PcLmKK9flGQq6EE+yvMWrEUnIPGOLJUEB06dE8inIMQTYDmdmjn7HgUAlIDaViw+
aSv3XBZJqBTm7xtW4488oKuCzdBuJbnomtGttFWOk4cjb8kG+Kza6v0AB+P0eUru
cPkwnJF4F1pGY1pszSMsL3/s7OcIzjiKUKu5vHJxUWO7baVovq+gv9+O24Pd0GhB
t6RC/pgK/42YqZ2YW5V+JiuCFFkTVPusviunAOLLpDwoyPIROvXdML2TKopiowOd
nmOkNRrW81duRF8Z4dcn7jnf2sKExpLBgAtcV05OufZIv3VeeTD0ISbCJhn0zmx/
SQIDAQAB
-----END PUBLIC KEY-----