【PHP8.x】mb_check_encoding関数の使い方

Copy
1<?php
2
3/**
4 * 文字列または配列のエンコーディングが有効かどうかを確認するサンプルコード。
5 *
6 * @param string|array|null $value チェックする文字列または配列。nullの場合は内部エンコーディングがチェックされる。
7 * @param string|null $encoding エンコーディング。nullの場合は内部エンコーディングが使用される。
8 * @return bool エンコーディングが有効な場合はtrue、そうでない場合はfalse。
9 */
10function checkEncodingExample(string|array|null $value = null, ?string $encoding = null): bool
11{
12    // mb_check_encoding() を使用してエンコーディングをチェック
13    $result = mb_check_encoding($value, $encoding);
14
15    return $result;
16}
17
18// 使用例
19$string = "こんにちは世界";
20$encoding = "UTF-8";
21
22if (checkEncodingExample($string, $encoding)) {
23    echo "文字列 '" . $string . "' は " . $encoding . " として有効です。\n";
24} else {
25    echo "文字列 '" . $string . "' は " . $encoding . " として有効ではありません。\n";
26}
27
28$invalidString = mb_convert_encoding("こんにちは世界", "SJIS", "UTF-8"); // 無効なUTF-8文字列を作成
29
30if (checkEncodingExample($invalidString, "UTF-8")) {
31    echo "文字列は有効なUTF-8です。\n";
32} else {
33    echo "文字列は有効なUTF-8ではありません。\n"; // こちらが出力される
34}
35
36// 配列のエンコーディングチェック
37$array = ["こんにちは", "世界"];
38if(checkEncodingExample($array, "UTF-8")){
39    echo "配列は有効なUTF-8です。\n";
40} else {
41    echo "配列は有効なUTF-8ではありません。\n";
42}
43
44// エンコーディングを指定しない場合のチェック
45if (checkEncodingExample()) {
46  echo "内部エンコーディングは有効です。\n";
47} else {
48  echo "内部エンコーディングは有効ではありません。\n";
49}
50?>

mb_check_encoding()関数は、文字列または配列のエンコーディングが指定されたエンコーディングとして有効かどうかをチェックします。システムエンジニアを目指す方にとって、文字化けを防ぐために重要な関数です。

引数 $value には、チェックしたい文字列または配列を指定します。null を指定すると、現在の内部エンコーディングが有効かどうかをチェックします。引数 $encoding には、エンコーディングの種類を文字列で指定します。null を指定すると、現在の内部エンコーディングが使用されます。

この関数は、指定された文字列または配列が、指定されたエンコーディングで有効であれば true を、そうでなければ false を返します。例えば、UTF-8で書かれた文字列が、本当にUTF-8として有効かどうかを確認できます。もし文字列が別のエンコーディング（例えばShift-JIS）で記述されている場合、UTF-8としてチェックすると false が返ります。

サンプルコードでは、checkEncodingExample()関数を作成し、mb_check_encoding()を使って文字列や配列のエンコーディングを検証しています。無効なUTF-8文字列を作成し、チェックする例も含まれています。エンコーディングを指定しない場合、現在の内部エンコーディングがチェックされることも示しています。