PHP的数组定义规范有哪些要求

PHP数组的定义，没有哪条铁律说“必须这么写”，但行业里确实积累了一套被广泛认可的实践准则。这些准则不光是让代码好看，更直接关系到代码跑起来会不会出问题，以及后续维护是否省心。说白了，就是一些“经验之谈”。

先说几个核心判断。数组的键，也就是下标，只能用整数或字符串，这是底线。其他类型，比如浮点数、布尔值，甚至某些看起来像数字的字符串，PHP都会偷偷帮你做类型转换。这转换有时候是惊喜，但更多时候是惊吓。

下标类型：规矩就是规矩

浮点数 1.5 会被直接截断成整数 1，你本来想用小数点区分不同数据，结果发现它们撞车了。布尔值 true 和 false 分别对应 1 和 0，这算是老规矩了。特别要注意的是字符串数字，比如 "8"，它会被转为整数 8。但像 "08"、"1e2" 这种非标准写法的字符串，也会被隐式转换，很容易导致键冲突，是不少隐蔽bug的根源。真正的底线是：数组、对象、null 这些类型，绝对不能作为键，否则PHP会直接报错“Illegal offset type”。

空数组：必须明确说“不”

很多新手会犯一个错误：用 null 或者空字符串来代替一个空数组。这就像你准备了一个空盒子，但盒子其实不存在，当你想往里放东西时，麻烦就来了。比如 $list = null;，然后你执行 $list[] = 'x'，PHP就会给你一个Notice错误。同样，is_array($list) 也会返回 false，因为 $list 根本就不是一个数组。

正确的做法很明确：要么是 $list = [];，要么是 $list = array();（这主要是为了兼容旧项目）。现代PHP开发中，推荐的做法是使用空合并运算符：$items = $input['data'] ?? [];。这行代码的意思是：如果 $input['data'] 存在且不为null，就取它的值，否则就创建一个空数组。这能有效避免很多未定义索引的警告。

多维数组：小心“中间层”的陷阱

直接向一个未定义的深层嵌套结构追加元素，是另一个常见的陷阱。比如你写 $user['profile']['tags'][] = 'php';，如果 $user['profile'] 这个数组本身都没有定义，PHP就会报 Warning。它不会自动帮你创建中间的 profile 层级。

解决这个问题，从PHP 7.4开始，可以用空合并赋值运算符 ??=：($user['profile']['tags'] ??= [])[] = 'php';。这行代码的意思是：先判断 tags 是否存在，如果不存在，就把它初始化为一个空数组，然后再往里追加元素。如果你的项目环境不支持这个特性，更通用的写法是 if (!isset($user['profile']['tags'])) $user['profile']['tags'] = [];。

风格与语义：统一才是王道

在现代PHP项目中，使用方括号 [] 语法来定义数组，已经是毋庸置疑的主流共识。它比 array() 更简洁，解析速度也更快，而且像 PHPStan 这样的静态分析工具，对 [] 语法的类型推断支持更好。最忌讳的是在同一个项目里混用 array() 和 []，尤其是在嵌套结构里，很容易把自己绕晕。

对于关联数组，键名建议全部加上引号，避免任何隐式转换的可能性。比如，数字开头的字符串键 '01'，很容易被误解，最好改成 'id_01' 这样的形式，明确保留其字符串语义。此外，列表型数组，也就是顺序集合，应尽量保持元素类型一致。如果可能，最好用注释标注一下，比如 @var array，这能极大提升代码的可读性，让接手你代码的人，一眼就能看明白这个数组里到底装了什么。