PHP Conference Fukuoka 2025

gnupg_init

(PECL gnupg >= 0.4)

gnupg_initInicializa uma conexão

Descrição

gnupg_init(?array $options = null): resource

Parâmetros

options

Deve ser um array associativo. É usado para alterar a configuração padrão do mecanismo de criptografia.

Substituições de configuração
chave tipo descrição
file_name string É o nome do arquivo do programa executável que implementa este protocolo que geralmente é o caminho do executável gpg.
home_dir string É o nome do diretório de configuração. Ele também substitui a variável de ambiente GNUPGHOME que é usada para o mesmo propósito.

Valor Retornado

Uma conexão do GnuPG do tipo resource usada por outras funções do GnuPG.

Registro de Alterações

Versão Descrição
PECL gnupg 1.5.0 O parâmetro options foi adicionado.

Exemplos

Exemplo #1 Exemplo procedural de gnupg_init() com configuração padrão

<?php
$res
= gnupg_init();
?>

Exemplo #2 Exemplo procedural de gnupg_init() com nome de arquivo e diretório inicial alterados

<?php
$res
= gnupg_init(["file_name" => "/usr/bin/gpg2", "home_dir" => "/var/www/.gnupg"]);
?>

Exemplo #3 Exemplo orientado a objeto de inicializador gnupg initializer com configuração padrão

<?php
$gpg
= new gnupg();
?>

Exemplo #4 Exemplo orientado a objeto de inicializador gnupg com nome de arquivo e diretório inicial alterados

<?php
$gpg
= new gnupg(["file_name" => "/usr/bin/gpg2", "home_dir" => "/var/www/.gnupg"]);
?>

adicionar nota

Notas de Usuários 2 notes

up
6
der_axel at gmx dot de
7 years ago
Set the correct GNUPG environment, before you call gnupg_init()!The current FPM/FastCGI/Module User must have read - if you import write - permissions on that directory. You won't get an error message, if something is not correct.Without a correct environment, all other gnupg functions will not work as you expected.<?php// Enter your .gnupg environmentputenv('GNUPGHOME=/var/www/vhosts/yourdomain/.gnupg');error_reporting(E_ALL);$res = gnupg_init();gnupg_seterrormode($res,GNUPG_ERROR_WARNING);$info = gnupg_keyinfo($res, 'your-key-id');echo "Key - Info<pre>";var_dump($info);echo "</pre>";?>
up
1
djmaze
3 years ago
Make sure home_dir option is not too many characters or else private keys fail.You will notice that functions take a long time (seconds).Commandline test yield error:> gpg: can't connect to the agent: IPC connect call failedExecuting `gpg-agent --daemon --homedir /very/long/path/to/.gnupg` gave the error.> socket name for '/very/long/path/to/.gnupg/S.gpg-agent.extra' is too longSo you must check that home_dir + '/S.gpg-agent.extra' is:* < 107 characters on Linux* < 104 on BSD 4.4
To Top