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

Copy
1<?php
2
3/**
4 * array_change_key_case 関数の使用例を示すスクリプト。
5 * 配列のキーを小文字または大文字に変換する方法を示します。
6 */
7
8// 元となる連想配列を定義します。
9$originalArray = [
10    'FirstName' => 'John',
11    'lastName'  => 'Doe',
12    'Email_Address' => 'john.doe@example.com',
13    'AGE'       => 30,
14];
15
16echo "--- 元の配列 ---" . PHP_EOL;
17print_r($originalArray);
18
19// キーをすべて小文字に変換します (デフォルトの動作)。
20// array_change_key_case() の第2引数を省略すると、CASE_LOWER が適用されます。
21$lowerCaseKeysArray = array_change_key_case($originalArray);
22
23echo PHP_EOL . "--- キーを小文字に変換した配列 (CASE_LOWER) ---" . PHP_EOL;
24print_r($lowerCaseKeysArray);
25
26// キーをすべて大文字に変換します。
27// 第2引数に CASE_UPPER 定数を指定します。
28$upperCaseKeysArray = array_change_key_case($originalArray, CASE_UPPER);
29
30echo PHP_EOL . "--- キーを大文字に変換した配列 (CASE_UPPER) ---" . PHP_EOL;
31print_r($upperCaseKeysArray);
32
33?>

PHPのarray_change_key_case関数は、連想配列のキー（要素を識別するための名前）のアルファベット部分を、すべて小文字またはすべて大文字に変換するための関数です。主に、データの一貫性を保つためや、キーの表記揺れを吸収したい場合に利用されます。

この関数は二つの引数を取ります。一つ目の引数$arrayには、キーを変更したい元の連想配列を指定します。二つ目の引数$caseはオプションで、キーをどのように変換するかを指定する定数です。デフォルトではCASE_LOWERが適用され、キーはすべて小文字に変換されます。もしキーをすべて大文字にしたい場合は、CASE_UPPER定数を指定します。この関数は、キーが変更された新しい配列を戻り値として返します。元の配列自体は変更されません。

サンプルコードでは、まず$originalArrayという連想配列が定義されています。 array_change_key_case($originalArray)のように第2引数を省略して呼び出すと、キーがすべて小文字になった$lowerCaseKeysArrayが生成されます。例えば、元の配列の「FirstName」は「firstname」に、「Email_Address」は「email_address」に変換されます。 次に、array_change_key_case($originalArray, CASE_UPPER)と呼び出すと、キーがすべて大文字になった$upperCaseKeysArrayが生成されます。この場合、「FirstName」は「FIRSTNAME」に、「lastName」は「LASTNAME」に変換されます。 このように、array_change_key_case関数を使うことで、配列のキーの文字種を簡単に統一できます。

Copy
1<?php
2
3declare(strict_types=1);
4
5/**
6 * 配列のキーを再帰的に小文字または大文字に変換します。
7 *
8 * PHPの標準関数 `array_change_key_case()` は配列の第一階層のキーしか変換しません。
9 * この関数は、多次元配列のすべての階層にあるキーを対象に変換処理を行います。
10 *
11 * @param array $array 変換対象の多次元配列
12 * @param int $case 変換後のキーの形式。CASE_LOWER (デフォルト) または CASE_UPPER
13 * @return array キーが変換された新しい配列
14 */
15function array_change_key_case_recursive(array $array, int $case = CASE_LOWER): array
16{
17    // まず、現在の階層のキーを変換する
18    $result = array_change_key_case($array, $case);
19
20    // 配列の各要素をループで処理する
21    foreach ($result as $key => $value) {
22        // もし値が配列であれば、その配列に対してこの関数自身を再度呼び出す (再帰処理)
23        if (is_array($value)) {
24            $result[$key] = array_change_key_case_recursive($value, $case);
25        }
26    }
27
28    return $result;
29}
30
31// サンプルとなる多次元配列（キーが大文字・小文字混合）
32$user_data = [
33    'USER_ID' => 101,
34    'Profile' => [
35        'NAME' => 'Taro Yamada',
36        'Contact' => [
37            'EMAIL' => 'taro.yamada@example.com',
38            'Phone' => '090-1234-5678'
39        ]
40    ],
41    'Status' => 'Active'
42];
43
44// --- 実行例 ---
45
46// 1. 再帰的にすべてのキーを小文字に変換する (デフォルト)
47$lower_case_data = array_change_key_case_recursive($user_data);
48
49// 2. 再帰的にすべてのキーを大文字に変換する
50$upper_case_data = array_change_key_case_recursive($user_data, CASE_UPPER);
51
52
53// --- 結果の出力 ---
54
55echo "■ 元の配列:\n";
56print_r($user_data);
57
58echo "\n■ すべてのキーを小文字に変換した配列 (再帰的):\n";
59print_r($lower_case_data);
60
61echo "\n■ すべてのキーを大文字に変換した配列 (再帰的):\n";
62print_r($upper_case_data);
63
64?>

PHPの標準関数array_change_key_caseは、配列のキーをすべて小文字または大文字に変換できますが、これは配列の第一階層のキーのみに適用されます。多次元配列の全てのキーを変換したい場合には、この関数だけでは不十分です。

サンプルコードのarray_change_key_case_recursive関数は、この課題を解決するカスタム関数です。この関数は、まず現在の階層のキーをarray_change_key_caseで変換します。次に、変換後の配列の要素が配列であれば、その要素に対し関数自身を再帰的に呼び出します。この再帰的な処理により、多次元配列の全ての階層のキーを確実に指定した形式に変換できます。

引数$arrayには変換対象の多次元配列を指定し、$caseにはキーを小文字にするCASE_LOWER（デフォルト）か、大文字にするCASE_UPPERを指定します。戻り値としては、キーが変換された新しい配列が返され、元の配列は変更されません。この関数は、データの一貫性を保つためや、異なるシステム間でデータ形式を統一する際など、データ処理を効率化する上で非常に役立ちます。