Skip to content

[Sync-En] openssl: document algorithm = 0 and digest_alg => "null" #3595

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
lacatoire merged 1 commit into from
Sep 26, 2026
Merged

[Sync-En] openssl: document algorithm = 0 and digest_alg => "null" #3595

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 10 additions & 10 deletions reference/openssl/constants.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 7179e95e592583beae2f99ca71e6b326f559812b Maintainer: lacatoire Status: ready -->
<!-- EN-Revision: 839637661508bf6e52d49061b060579e6a12fe52 Maintainer: lacatoire Status: ready -->

<appendix xml:id="openssl.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
Expand Down Expand Up @@ -294,11 +294,11 @@
(<type>int</type>)
</entry>
<entry>
Ajoute le texte plein en clair dans les en-têtes du message
signé/chiffré. Lors du déchiffrement ou de la vérification,
il supprime purement et simplement ces données. Si le
message chiffré ou signé n'est pas du type MIME, une erreur
surviendra.
Ajoute les en-têtes de type de contenu <literal>text/plain</literal>
au message chiffré/signé. Lors du déchiffrement ou de la vérification,
ces en-têtes sont supprimés de la sortie ; si le message déchiffré ou
vérifié n'est pas du type <acronym>MIME</acronym>
<literal>text/plain</literal>, une erreur surviendra.
</entry>
</row>
<row xml:id="constant.pkcs7-binary">
Expand Down Expand Up @@ -374,7 +374,7 @@
</entry>
<entry>
Normalement, lorsqu'un message est signé, un jeu d'attributs
contenant l'heure de signature et l'algorithme symétrique
contenant l'heure de signature et les algorithmes symétriques
supportés, est inclus dans le message. Avec cette option,
il n'est pas inclus.
</entry>
Expand Down Expand Up @@ -413,7 +413,7 @@
</entry>
<entry>
Disponible à partir de PHP 8.3.0.
Définit l'en-tête HTTP Content-Type sur <literal>application/pkcs7-mime</literal> au lieu de
Définit le type de contenu (content-type) sur <literal>application/pkcs7-mime</literal> au lieu de
<literal>application/x-pkcs7-mime</literal> pour chiffrer un message.
</entry>
</row>
Expand Down Expand Up @@ -583,7 +583,7 @@
</entry>
<entry>
Disponible à partir de PHP 8.3.0.
Définit l'en-tête HTTP Content-Type sur <literal>application/x-pkcs7-mime</literal> au lieu de
Définit le type de contenu (content-type) sur <literal>application/x-pkcs7-mime</literal> au lieu de
<literal>application/pkcs7-mime</literal> pour chiffrer un message.
</entry>
</row>
Expand All @@ -594,7 +594,7 @@
</section>

<section xml:id="openssl.signature-algos">
<title>Algorithmes de signature</title>
<title>Algorithmes de digest</title>
<variablelist>
<varlistentry xml:id="constant.openssl-algo-dss1">
<term>
Expand Down
22 changes: 13 additions & 9 deletions reference/openssl/functions/openssl-csr-new.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: f0d11929d41082d71dcf8338a18e04412c656fa0 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<!-- EN-Revision: 839637661508bf6e52d49061b060579e6a12fe52 Maintainer: yannick Status: ready -->
<refentry xml:id="function.openssl-csr-new" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>openssl_csr_new</refname>
Expand Down Expand Up @@ -75,7 +74,7 @@
<tgroup cols="3">
<thead>
<row>
<entry><parameter>options</parameter></entry>
<entry>Clé de <parameter>options</parameter></entry>
<entry>type</entry>
<entry>Équivalent de <literal>openssl.conf</literal></entry>
<entry>description</entry>
Expand All @@ -86,7 +85,12 @@
<entry>digest_alg</entry>
<entry><type>string</type></entry>
<entry>default_md</entry>
<entry>Méthode de digest ou signature de hachage, généralement un de <function>openssl_get_md_methods</function></entry>
<entry>
Méthode de digest ou signature de hachage, généralement un de
<function>openssl_get_md_methods</function>. La valeur spéciale
<literal>"null"</literal> est utilisée pour les algorithmes de signature
qui n'acceptent pas d'algorithme de digest en paramètre.
</entry>
</row>
<row>
<entry>x509_extensions</entry>
Expand Down Expand Up @@ -209,17 +213,17 @@
<row>
<entry>8.0.0</entry>
<entry>
<parameter>csr</parameter> accepte désormais une instance de
En cas de succès, cette fonction retourne désormais une instance de
<classname>OpenSSLCertificateSigningRequest</classname> ;
auparavant, une &resource; de type <literal>OpenSSL X.509 CSR</literal> était acceptée.
auparavant, une &resource; de type <literal>OpenSSL X.509 CSR</literal> était retournée.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
En cas de succès, cette fonction retourne désormais une instance de
<classname>OpenSSLAsymmetricKey</classname> ; auparavant une
&resource; de type <literal>OpenSSL key</literal> était retournée.
<parameter>private_key</parameter> accepte désormais une instance de
<classname>OpenSSLAsymmetricKey</classname> ; auparavant, une
&resource; de type <literal>OpenSSL key</literal> était acceptée.
</entry>
</row>
<row>
Expand Down
14 changes: 8 additions & 6 deletions reference/openssl/functions/openssl-sign.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: ddcd63907372580151daf69458d6a8268232b703 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<!-- EN-Revision: 839637661508bf6e52d49061b060579e6a12fe52 Maintainer: yannick Status: ready -->
<refentry xml:id="function.openssl-sign" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>openssl_sign</refname>
Expand Down Expand Up @@ -64,9 +63,12 @@
<varlistentry>
<term><parameter>algorithm</parameter></term>
<listitem>
<para>
<type>int</type> - une des <link linkend="openssl.signature-algos">signatures d'algorithmes</link>.
</para>
<simpara>
<type>int</type> - l'un des <link linkend="openssl.signature-algos">algorithmes de digest</link>,
ou <literal>0</literal> pour les algorithmes de signature qui n'acceptent pas
d'algorithme de digest en paramètre.
Cette valeur <literal>0</literal> n'est disponible que lorsque PHP est compilé avec OpenSSL 3.0+.
</simpara>
<para>
<type>string</type> - une chaîne valide retournée par la fonction
<function>openssl_get_md_methods</function>, par exemple : "sha256WithRSAEncryption" ou "sha384".
Expand Down Expand Up @@ -135,7 +137,7 @@
<?php
// On suppose que $data contient les données à signer

// lecture de la clé privée pour chaque destinataire
// lecture de la clé privée depuis un fichier et préparation
$pkeyid = openssl_pkey_get_private("file://src/openssl-0.9.6/demos/sign/key.pem");

// calcul de la signature
Expand Down
11 changes: 7 additions & 4 deletions reference/openssl/functions/openssl-verify.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 9e5f75b8c1d87da6ee825ae7d1b2a3da218b5c69 Maintainer: yannick Status: ready -->
<!-- EN-Revision: 839637661508bf6e52d49061b060579e6a12fe52 Maintainer: yannick Status: ready -->
<refentry xml:id="function.openssl-verify" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>openssl_verify</refname>
Expand Down Expand Up @@ -62,9 +62,12 @@ MIIBCgK...</literal>.
<varlistentry>
<term><parameter>algorithm</parameter></term>
<listitem>
<para>
<type>int</type> - une des <link linkend="openssl.signature-algos">signatures d'algorithmes</link>.
</para>
<simpara>
<type>int</type> - l'un des <link linkend="openssl.signature-algos">algorithmes de digest</link>,
ou <literal>0</literal> pour les algorithmes de signature qui n'acceptent pas
d'algorithme de digest en paramètre.
Cette valeur <literal>0</literal> n'est disponible que lorsque PHP est compilé avec OpenSSL 3.0+.
</simpara>
<para>
<type>string</type> - une chaîne valide retournée par la fonction <function>openssl_get_md_methods</function>,
par exemple : "sha1WithRSAEncryption" ou "sha512". Algorithme par défaut: "OPENSSL_ALGO_SHA1".
Expand Down
Loading