# rnp_ffi_set_pass_provider

(PECL rnp >= 0.1.1)

rnp_ffi_set_pass_provider — Définit la fonction de rappel du fournisseur de mot de passe

### Description

rnp_ffi_set_pass_provider(RnpFFI `$ffi`, callable `$password_callback`): bool

Définit la fonction de rappel du fournisseur de mot de passe. Cette fonction peut demander le mot de passe sur une entrée standard (si le script PHP est exécuté dans un environnement de ligne de commande), afficher une boîte de dialogue GUI ou fournir le mot de passe de toutes les manières possibles. Les mots de passe demandés sont utilisés pour chiffrer ou déchiffrer les clés secrètes ou effectuer des opérations de chiffrement/déchiffrement symétriques.

### Liste de paramètres

`ffi`

  L'objet FFI retourné par rnp_ffi_create().

`password_callback`

  La fonction qui doit être appelée pour chaque demande de mot de passe. Elle a la signature suivante:

  password_callback(string `$key_fp`, string `$pgp_context`, string `&$password`): bool
  - `$key_fp` - L'empreinte de la clé, le cas échéant. Peut être vide.
  - `$pgp_context` - Chaîne décrivant pourquoi la clé est demandée.
  - `$password` - Référence de chaîne où le mot de passe fourni doit être stocké.
  La fonction de rappel doit retourner `true` si le mot de passe a été défini avec succès ou `false` si une erreur survient.

### Valeurs de retour

Renvoie `true` en cas de succès ou `false` si une erreur survient.

### Exemples

Exemple #1 Exemple d'une fonction de rappel simple

`<?php
function password_callback(string $key_fp, string $pgp_context, string &$password)
{
$password = "password";
return true;
}
$ffi = rnp_ffi_create('GPG', 'GPG');
rnp_ffi_set_pass_provider($ffi, 'password_callback');`