PHP 陣列鍵名進階技巧：型別轉換、隱性規則與最佳實踐

PHP 陣列鍵名支援 int 與 string 兩種型別，但其隱性型別轉換規則（布林、浮點數、null）常導致難以除錯的邏輯錯誤。本文系統整理鍵名轉換機制、特殊值行為、[] 追加語法，並提供防錯最佳實踐。

核心型別轉換規則

PHP 在陣列鍵名存取時，會依下表自動轉換：

實例驗證

<?php
$arr = [];
$arr[true]   = 'a';  // $arr[1] = 'a'
$arr[false]  = 'b';  // $arr[0] = 'b'
$arr[null]   = 'c';  // $arr[''] = 'c'
$arr[123.9]  = 'd';  // $arr[123] = 'd'
$arr['123']  = 'e';  // 覆蓋 $arr[123] = 'e'
$arr['0123'] = 'f';  // $arr['0123'] = 'f' (獨立鍵)

var_dump($arr);
/*
array(4) {
  [0]=> 'b'
  [1]=> 'a'
  [123]=> 'e'
  ['0123']=> 'f'
  ['']=> 'c'
}
*/
?>

特殊陷阱場景

1. 布林鍵名覆蓋數字索引

<?php
$arr = [0 => 'first', 1 => 'second'];
$arr[false] = 'override';  // 實際操作 $arr[0]
// $arr[0] 變為 'override'
?>

2. 浮點數精度導致非預期鍵名

<?php
$key = 0.1 + 0.2;  // 0.30000000000000004
$arr[$key] = 'value';  // 實際鍵名為 0
?>

3. null 鍵名與空字串鍵名共用

<?php
$arr[null] = 'a';
$arr[''] = 'b';  // 覆蓋同一個位置
// 只有 $arr[''] 存在
?>

短語法追加元素：$arr[] = $value

• 自動分配下一個可用整數索引（最大現有整數索引 + 1）
• 若無整數索引，從 0 開始
• 不影響字串鍵名元素

<?php
$arr = ['a' => 1, 5 => 2];
$arr[] = 3;  // 索引 6
$arr[] = 4;  // 索引 7
// 結果: ['a'=>1, 5=>2, 6=>3, 7=>4]
?>

foreach 遍歷時的鍵名呈現

<?php
$arr[123.45] = 'test';
foreach ($arr as $k => $v) {
    var_dump($k);  // int(123) 而非 float
}
?>

關鍵點：遍歷時鍵名為轉換後的型別（整數/字串）。

最佳實踐防錯指南

1. 明確指定型別：避免隱性轉換，字串鍵名加引號 $arr['123']
2. 避免布林/浮點/ null 作鍵名：改用字串常數 'true', 'false', 'empty'
3. 檢查鍵名存在用 array_key_exists()：isset() 對 null 值回傳 false
4. JSON 編碼前正規化：array_keys() 檢查是否有非預期鍵名型別
5. 單元測試覆蓋邊界值：true/false/null/0/0.0/-0.0/'0'/'00'

PHP 8.1+ 新特性：陣列解包保留鍵名

<?php
$arr1 = ['a' => 1];
$arr2 = [1 => 2, 'b' => 3];
$merged = [...$arr1, ...$arr2];
// ['a'=>1, 1=>2, 'b'=>3]  整數鍵名重新編排，字串鍵名保留
?>

深入理解 PHP 陣列鍵名的隱性轉換規則，能從根源上消除一類難以重現的 Bug。建立「鍵名即型別」的防衛性程式習慣，讓陣列操作更可預測、更易維護。