Signe un message S/MIME

# openssl_pkcs7_sign

(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

openssl_pkcs7_sign — Signe un message S/MIME

### Description

function openssl_pkcs7_sign(
string `$input_filename`,
string `$output_filename`,
OpenSSLCertificate|string `$certificate`,
#[\SensitiveParameter]OpenSSLAsymmetricKey|OpenSSLCertificate|array|string `$private_key`,
?array `$headers`,
int `$flags` = `PKCS7_DETACHED`,
?string `$untrusted_certificates_filename` = `null`
): bool

openssl_pkcs7_sign() prend le contenu du fichier `input_filename` et le signe en utilisant le certificat et la clé privée contenus dans les arguments `certificate` et `private_key`.

### Liste de paramètres

`input_filename`

  Le fichier d'entrée qu'on a l'intention de signer numériquement.

`output_filename`

  Le fichier où la signature numérique sera écrite.

`certificate`

  Le certificat X.509 utilisé pour signer numériquement `input_filename`. Voir paramètres Clé/Certificat pour une liste de valeurs valides.

`private_key`

  `private_key` est la clé privée correspondant à `certificate`. Voir paramètres Clé Publique/Privée pour une liste de valeurs valides.

`headers`

  `headers` est un tableau d'en-têtes qui seront ajoutés aux données signées (voir la fonction openssl_pkcs7_encrypt() pour plus de détails sur le format du paramètre).

`flags`

  `flags` peut être utilisé pour modifier la sortie. Voir les constantes PKCS7.

`untrusted_certificates_filename`

  `untrusted_certificates_filename` spécifie le nom du fichier contenant un ensemble de certificats supplémentaires à inclure dans la signature, qui pourront aider le destinataire à vérifier le certificat utilisé.

### Valeurs de retour

Cette fonction retourne `true` en cas de succès ou `false` si une erreur survient.

### Historique

Version | Description
--- | ---
8.0.0 | `certificate` accepte désormais une instance de OpenSSLCertificate ; auparavant, une resource de type `OpenSSL X.509 CSR` était acceptée.
8.0.0 | `private_key` accepte désormais une instance de OpenSSLAsymmetricKey ou OpenSSLCertificate ; auparavant, une resource de type `OpenSSL key` ou `OpenSSL X.509` était acceptée.

### Exemples

Exemple #1 Exemple avec openssl_pkcs7_sign()

    <?php
    // le message que vous voulez signer, afin que le destinataire soit sûr qu'il
    // vient bien de vous
    $data = <<<EOD

    Vous êtes autorisé à dépenser 10 000€ en note de frais.

    Le PDG
    EOD;
    // sauvez le message dans un fichier
    $fp = fopen("msg.txt", "w");
    fwrite($fp, $data);
    fclose($fp);
    // encrypt it
    if (openssl_pkcs7_sign("msg.txt", "signed.txt", "file://mycert.pem",
        array("file://mycert.pem", "mypassphrase"),
        array("To" => "joes@example.com", // syntaxe à clé
              "From: HQ <ceo@example.com>", // syntaxe indexée
              "Subject" => "Eyes only")
        )) {
        // message signé - envoyez-le !
        exec(ini_get("sendmail_path") . " < signed.txt");
    }
    ?>

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open