htmlspecialchars 関連の関数で、flags パラメータのデフォルト値の説明に不整合がある

[mumumu]

https://www.php.net/manual/ja/function.htmlspecialchars.php

PHP 8.1 で、htmlspecialchars 関連の関数のデフォルト値は、ENT_COMPAT から ENT_QUOTES | ENT_SUBSTITUTE に変更され、マニュアルにもそれが反映されている。

だが、flags パラメータのデフォルト値の説明は、以下のように ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401 となっている。

[mumumu]

現状、本件は下記の状況であり、修正が進行中であるが、時間がかかりそうな模様。

• 日本語版だけでなく、英語版がそもそも間違っている
  • https://www.php.net/manual/en/function.htmlspecialchars.php
    • 原因は doc-en チームが先走って間違ったPRをマージしたためである。
• ENT_HTML401 は 0 として定義されており 、それがデフォルト値に含まれても問題はない
• そのため、関数のスタブでもそれを含めるように修正が行われ、マニュアルにもそれを何らかの方法で注記する方向で修正が進んでいる
• 詳細は、間違った修正がマージされたこの PR を参照のこと。

[mumumu]

relates to: php/doc-en#1042

[mumumu]

Fixed by d143b83 and php/doc-en@e4b5274 . Thank you for great fix, @saundefined !