Skip to content

openssl: document algorithm = 0 and digest_alg => "null" - #5878

Merged
lacatoire merged 1 commit into
php:masterfrom
adapik:openssl-functions-docs-adjustments
Sep 25, 2026
Merged

lacatoire merged 1 commit into
php:masterfrom
adapik:openssl-functions-docs-adjustments

Conversation

@adapik

@adapik adapik commented Sep 24, 2026

Copy link
Copy Markdown
Contributor

openssl_sign()/openssl_verify() accept 0 as algorithm for signature algorithms that don't take a separate digest, and openssl_csr_new()'s digest_alg option accepts "null" for the same case — both were added in
php-src#14052 but never documented.

Comment thread reference/openssl/functions/openssl-verify.xml Outdated
Comment thread reference/openssl/functions/openssl-sign.xml
@adapik
adapik force-pushed the openssl-functions-docs-adjustments branch from 2acf661 to 132abc9 Compare September 25, 2026 04:29
@adapik
adapik requested a review from lacatoire September 25, 2026 04:29
@lacatoire

Copy link
Copy Markdown
Member

@adapik some nits with CI

@adapik
adapik force-pushed the openssl-functions-docs-adjustments branch from 7c11b66 to 71561d4 Compare September 25, 2026 07:47
@adapik

adapik commented Sep 25, 2026

Copy link
Copy Markdown
Contributor Author

CI issue fixed

@lacatoire

Copy link
Copy Markdown
Member

Thanks @adapik

@lacatoire
lacatoire merged commit 8396376 into php:master Sep 25, 2026
3 checks passed
KentarouTakeda added a commit to KentarouTakeda/php-doc-ja that referenced this pull request Sep 27, 2026
openssl の 4 ファイルを原文の変更に追従しました。これで openssl モジュールの未訳・要更新はなくなります。

原文では php/doc-en@8396376(php/doc-en#5878)で次の変更がありました。

- `openssl_sign()` と `openssl_verify()` の `algorithm` に、ダイジェストアルゴリズムを受け付けない署名アルゴリズムでは `0` を指定すること(OpenSSL 3.0 以降)が追記されました
- `openssl_csr_new()` の `digest_alg` オプションに、同じ場合に特別な値 `"null"` を使うことが追記されました
- 定数ページの節見出しが "Signature Algorithms" から "Digest Algorithms" に変わりました(`openssl_sign()`・`openssl_verify()` からのリンクの文言も同じ)

## 対象ファイル

reference/openssl/ (4) — constants.xml, functions/openssl-csr-new.xml, functions/openssl-sign.xml, functions/openssl-verify.xml
KentarouTakeda added a commit to php/doc-ja that referenced this pull request Sep 27, 2026
openssl の 4 ファイルを原文の変更に追従しました。これで openssl モジュールの未訳・要更新はなくなります。

原文では php/doc-en@8396376(php/doc-en#5878)で次の変更がありました。

- `openssl_sign()` と `openssl_verify()` の `algorithm` に、ダイジェストアルゴリズムを受け付けない署名アルゴリズムでは `0` を指定すること(OpenSSL 3.0 以降)が追記されました
- `openssl_csr_new()` の `digest_alg` オプションに、同じ場合に特別な値 `"null"` を使うことが追記されました
- 定数ページの節見出しが "Signature Algorithms" から "Digest Algorithms" に変わりました(`openssl_sign()`・`openssl_verify()` からのリンクの文言も同じ)

## 対象ファイル

reference/openssl/ (4) — constants.xml, functions/openssl-csr-new.xml, functions/openssl-sign.xml, functions/openssl-verify.xml
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants