エラー

PHPの配列における非文字列キーの挙動について解説

2025-02-19更新日: 2025-02-19

PHPでは配列のキーに文字列以外の値を利用することができますが、内部で自動的に型変換が行われるため、思わぬ挙動を引き起こす場合があります。

例えば、非文字列のキーが整数にキャストされるケースなどがあり、意図した動作を得るためには注意が必要です。

目次から探す

PHP配列の基本構造
- 配列の定義と利用例
- キーに使用可能なデータ型
非文字列キーの型変換の仕組み
- 自動型変換の処理フロー
実例で確認する挙動
- コード例による動作比較
安全な配列操作のためのポイント
- 型チェックと明示的なキャストの活用方法
まとめ

PHP配列の基本構造

配列の定義と利用例

PHPにおいて、配列は複数の値を一つの変数にまとめるために使用されます。

配列はarray()もしくは短縮構文の[]を用いて定義することが可能です。

以下は簡単な配列の定義例です。

<?php
// 数値のリストを作成するサンプルコード
$numbers = [1, 2, 3, 4]; // インデックスは自動的に0から始まる整数が割り当てられます
// 連想配列の例
$person = [
    "name" => "太郎",
    "age" => 30
];
print_r($numbers);
print_r($person);
?>

Array
(
    [0] => 1
    [1] => 2
    [2] => 3
    [3] => 4
)
Array
(
    [name] => 太郎
    [age] => 30
)

キーに使用可能なデータ型

PHPの配列では、キーとして使用できるデータ型は限られています。

基本的には整数と文字列がキーとして利用されます。

その他のデータ型、例えば浮動小数点数、真偽値、NULLなどは内部で適切な変換が実行されます。

整数型と文字列型はそのままキーとして使用できます。
浮動小数点数型、ブール値、NULLは整数もしくは空文字列に変換される仕組みがあります。

文字列キーと非文字列キーの違い

文字列キーはそのままの表現が保持され、コードの可読性を向上させる一方で、非文字列キー(例えば浮動小数点数や真偽値、NULL)は内部的に別の型に変換されます。

そのため、同じ概念のキーが意図せず上書きされてしまう場合があります。

例えば、1という整数と1.0という浮動小数点数は同一視されるため、片方の値が上書きされてしまう可能性があります。

非文字列キーの型変換の仕組み

自動型変換の処理フロー

PHPでは配列に非文字列キーを使用した場合、自動的に型変換が行われます。

これは内部処理の一貫として実行され、変換後は整数や文字列として扱われます。

具体的な変換ルールに従って、挙動が決定されるため、意図しないキーの衝突を避けるためには注意が必要です。

整数型への変換ルール

非整数値が配列のキーとして使用された場合、まず整数型への変換が試みられます。

例えば、浮動小数点数がキーに渡された場合、小数点以下は切り捨てられ整数に変換されます。

以下はその例です。

<?php
// 浮動小数点数をキーにした場合の変換例
$array = [
    1.7 => "値A",   // 1.7は1に変換される
    2.3 => "値B"    // 2.3は2に変換される
];
print_r($array);
?>

Array
(
    [1] => 値A
    [2] => 値B
)

浮動小数点数の変換例

浮動小数点数は、内部的に整数にキャストされる過程で小数部分が切り捨てられます。

したがって、1.0と1.5はペアとなる場合があるため、キーが衝突してしまう可能性があります。

コード上で意図しない動作を避けるためには、あらかじめキーとして使う値の型を確認することが重要です。

真偽値とNULLの扱い

真偽値およびNULLをキーとして使用した場合も、型変換が行われます。

例えば、trueは整数の1に、falseは整数の0に、NULLは空文字列に変換されます。

以下は具体例です。

<?php
$array = [
    true => "真の値",   // trueは1に変換される
    false => "偽の値",  // falseは0に変換される
    NULL => "無の値"    // NULLは空文字列に変換される
];
print_r($array);
?>

Array
(
    [1] => 真の値
    [0] => 偽の値
    [] => 無の値
)

実例で確認する挙動

コード例による動作比較

ここでは、文字列キーと非文字列キーを組み合わせた場合の挙動について、具体的なコード例を交えて説明します。

文字列キーのままと、型変換が行われた場合の相違点を実際に確認いただけます。

<?php
// 文字列キーと非文字列キーの混在例
$array = [
    "10" => "文字列としての10",   // 文字列キー
    10   => "整数としての10",       // 数値キー
    10.0 => "浮動小数点としての10"    // 浮動小数点数キーは整数に変換される
];
print_r($array);
?>

Array
(
    [10] => 浮動小数点としての10
)

上記の例では、キー"10"、10、および10.0は全て同じキーとして扱われ、最後に定義された値で上書きされるため、結果的に一つの要素のみが残ることが確認できます。

想定外の挙動とエラー事例

非文字列キーを利用する際、意図せずキーが変換され、同一視される結果、意図通りの配列操作ができなくなる場合があります。

例えば、別々に定義した1と1.0が同一視されるため、後から定義した値が上書きされるといった状況です。

また、キャストの結果が期待と異なる場合に不具合が発生する可能性があります。

<?php
// 想定外のキーの上書き例
$array = [
    1 => "整数キーの値",
    1.9 => "浮動小数点キーの値"  // 1.9は1に変換され、前の値を上書き
];
print_r($array);
?>

Array
(
    [1] => 浮動小数点キーの値
)

具体的なトラブルシュートのポイント

このような挙動によるトラブルを避けるためには、下記の点を確認することが有効です。

配列のキーが何に変換されるかを予め理解する
複雑な型がキーとして使われる場合、明示的にキャストを行って意図通りのキーを設定する
配列作成時にキーの衝突が生じないよう、一意性を保つための工夫を行う

安全な配列操作のためのポイント

型チェックと明示的なキャストの活用方法

配列のキーに対して意図せぬ型変換が行われないようにするため、型チェックや明示的なキャストを行うことが有効です。

特に外部からデータを受け取る場面では、キーの型を検証してから利用することが推奨されます。

以下は、事前に型チェックを行い、明示的にキャストするサンプルコードです。

<?php
// 入力として受け取ったキーを安全に扱う例
function safeKey($key) {
    // もしキーが浮動小数点数なら整数にキャスト
    if (is_float($key)) {
        return (int)$key;
    }
    // もしキーがブール値なら整数にキャスト
    if (is_bool($key)) {
        return $key ? 1 : 0;
    }
    // NULLの場合は空文字列にキャスト
    if (is_null($key)) {
        return "";
    }
    // その他は文字列として返す
    return (string)$key;
}
$array = [];
$originalKey = 1.5;
$safe_key = safeKey($originalKey); // キーは1に変換される
$array[$safe_key] = "安全な値";
print_r($array);
?>