[doc-en] master: openssl: document algorithm = 0 and digest_alg => "null" (#5878)

Author: Alexander Danilov (adapik) Committer: GitHub (web-flow) Pusher: lacatoire Date: 2026-09-25T10:07:05+02:00 Commit: https://github.com/php/doc-en/commit/839637661508bf6e52d49061b060579e6a12fe52 Raw diff: https://github.com/php/doc-en/commit/839637661508bf6e52d49061b060579e6a12fe52.diff openssl: document algorithm = 0 and digest_alg => "null" (#5878) Changed paths: M reference/openssl/constants.xml M reference/openssl/functions/openssl-csr-new.xml M reference/openssl/functions/openssl-sign.xml M reference/openssl/functions/openssl-verify.xml Diff: diff --git a/reference/openssl/constants.xml b/reference/openssl/constants.xml index fca9d78c90c0..7e2998e1d4df 100644 --- a/reference/openssl/constants.xml +++ b/reference/openssl/constants.xml @@ -567,7 +567,7 @@ </section> <section xml:id="openssl.signature-algos"> - <title>Signature Algorithms</title> + <title>Digest Algorithms</title> <variablelist> <varlistentry xml:id="constant.openssl-algo-dss1"> <term> diff --git a/reference/openssl/functions/openssl-csr-new.xml b/reference/openssl/functions/openssl-csr-new.xml index 8523f7121b88..dccaac79374f 100644 --- a/reference/openssl/functions/openssl-csr-new.xml +++ b/reference/openssl/functions/openssl-csr-new.xml @@ -81,7 +81,12 @@ <entry>digest_alg</entry> <entry><type>string</type></entry> <entry>default_md</entry> - <entry>Digest method or signature hash, usually one of <function>openssl_get_md_methods</function></entry> + <entry> + Digest method or signature hash, usually one of + <function>openssl_get_md_methods</function>. The special value + <literal>"null"</literal> is used for signature algorithms that do + not accept a digest algorithm as a parameter. + </entry> </row> <row> <entry>x509_extensions</entry> diff --git a/reference/openssl/functions/openssl-sign.xml b/reference/openssl/functions/openssl-sign.xml index 9514d5069282..3e5f7dbdea6c 100644 --- a/reference/openssl/functions/openssl-sign.xml +++ b/reference/openssl/functions/openssl-sign.xml @@ -60,9 +60,11 @@ <varlistentry> <term><parameter>algorithm</parameter></term> <listitem> - <para> - <type>int</type> - one of these <link linkend="openssl.signature-algos">Signature Algorithms</link>. - </para> + <simpara> + <type>int</type> - one of these <link linkend="openssl.signature-algos">Digest Algorithms</link>, + or <literal>0</literal> for signature algorithms that do not accept a digest algorithm as a parameter. + This value of <literal>0</literal> is only available when PHP is compiled with OpenSSL 3.0+. + </simpara> <para> <type>string</type> - a valid string returned by <function>openssl_get_md_methods</function> example, "sha256WithRSAEncryption" or "sha384". </para> diff --git a/reference/openssl/functions/openssl-verify.xml b/reference/openssl/functions/openssl-verify.xml index 787c4f8922ab..b85f3a24150e 100644 --- a/reference/openssl/functions/openssl-verify.xml +++ b/reference/openssl/functions/openssl-verify.xml @@ -60,9 +60,11 @@ MIIBCgK...</literal>) <varlistentry> <term><parameter>algorithm</parameter></term> <listitem> - <para> - <type>int</type> - one of these <link linkend="openssl.signature-algos">Signature Algorithms</link>. - </para> + <simpara> + <type>int</type> - one of these <link linkend="openssl.signature-algos">Digest Algorithms</link>, + or <literal>0</literal> for signature algorithms that do not accept a digest algorithm as a parameter. + This value of <literal>0</literal> is only available when PHP is compiled with OpenSSL 3.0+. + </simpara> <para> <type>string</type> - a valid string returned by <function>openssl_get_md_methods</function> example, "sha1WithRSAEncryption" or "sha512". </para>