Updated PHP Windows builds for Brotli security fix

mb_check_encoding

(PHP 4 >= 4.4.3, PHP 5 >= 5.1.3, PHP 7, PHP 8)

mb_check_encoding — 文字列が、指定したエンコーディングで有効なものかどうかを調べる

説明

function mb_check_encoding(array|string|null $value = null, ?string $encoding = null): bool

そのバイトストリームが指定したエンコーディングで有効なものかどうかを調べます。 value が配列の場合、全てのキーと値が再帰的に調べられます。 これは、いわゆる「不正なエンコーディングによる攻撃」を防ぐのに役立ちます。

パラメータ

value

調べるバイトストリーム または array。省略した場合は、 リクエスト開始時からのすべての入力が対象となります。

警告

PHP 8.1.0 以降では、このパラメータを省略したり null を渡したりすることは推奨されなくなっています。

encoding

期待するエンコーディング。

戻り値

成功した場合に true を、失敗した場合に false を返します。

エラー / 例外

PHP 8.0.0 以降では、encoding に不正なエンコーディングが渡された場合、 ValueError がスローされます。 これより前のバージョンでは、代わりに E_WARNING が発生していました。

変更履歴

バージョン 説明
8.1.0 引数を渡さずにこの関数を呼び出したり、 value に null を渡して呼び出すことは推奨されなくなりました。
8.0.0 value と encoding は、nullable になりました。
8.0.0 encoding に不正なエンコーディングが渡された場合、 ValueError をスローするようになりました。 これより前のバージョンでは、E_WARNING が発生し、 false を返していました。
7.2.0 この関数は、value に配列を受け入れるようになりました。 このバージョンより前では、文字列のみがサポートされていました。
+add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top