PHP数组语法：短数组[]与array()的跨版本兼容最佳实践-php教程-PHP中文网

php 5.3及更老环境必须用array()，因[]会触发解析错误；php 5.4+优先用[]，但静态分析工具可能对[]推断不准确；新代码一律用[]，类型声明优先用php 8.1+形状语法。

php数组语法：短数组[]与array()的跨版本兼容最佳实践

PHP 5.3 及更老环境必须用 `array()`

如果你的项目还跑在 PHP 5.3（或更低），[] 会直接报 Parse error: syntax error, unexpected '['，根本无法启动。这不是警告，是解析失败，连脚本都进不了执行阶段。

这种环境下唯一安全写法就是 array()，包括空数组、索引数组、关联数组、嵌套数组——全部用它。别试图省略括号，array（没括号）会被解释成字符串，[] 则彻底非法。

$list = array(); —— 空数组唯一合法写法
$data = array('id' => 123, 'name' => 'Tom'); —— 关联数组必须带引号键名
$grid = array(array(1, 2), array(3, 4)); —— 多维结构靠嵌套 array()

PHP 5.4+ 项目优先用 `[]`，但要注意静态分析工具的提示

[] 和 array() 在运行时完全等价，生成的数组类型、键值行为、内存占用一模一样。性能差异可忽略，但 [] 更短、更符合现代 PHP 风格（尤其配合 PHP 8+ 的类型系统）。

不过，某些旧版 PHPStan 或 Psalm 配置下，[] 可能被推断为 array<mixed mixed></mixed>，而 array() 有时反而更容易被识别为“明确空数组”。如果你在严格类型检查中遇到误报，先确认工具版本，再考虑局部改用 array() 而非全局回退。

新代码一律用 $items = [];，而不是 $items = array();
函数返回类型声明里，优先写 array{name: string, id: int}（PHP 8.1+ 形状语法），而非笼统的 array
若 CI 流水线跑在 PHP 7.4 环境但用了 PHP 8.1 的类型注解，需确保 phpstan.neon 启用 phpVersion: 80100 显式指定目标版本

混合项目（如 Laravel 6.x 支持 PHP 7.2+）不能只看最低版本

很多团队以为“支持 PHP 7.2 就能放心用 []”，其实陷阱在扩展和依赖里。例如某些老旧的 Twig 模板引擎（array_map_recursive 工具函数，可能隐式依赖 array() 的函数式语义（比如用于反射判断是否为数组构造调用）。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

这时光看主版本不够，得实际跑一遍 composer install --ignore-platform-reqs + 单元测试，重点观察是否有 Warning: array_keys() expects parameter 1 to be array, null given 类错误——往往是因为某处 [] 被当成表达式提前求值，而预期是函数调用上下文。

升级前用 grep -r '\[\]' . --include="*.php" | head -20 扫描所有短数组用法
对关键数据组装逻辑（如 API 响应构造、DB 查询结果包装），补一句 assert(is_array($data)); 防止静默降级
若发现某个 Composer 包文档写着“requires array() syntax”，别硬改它的源码，而是 fork 后打 patch 并提交 PR

PHP 8.1+ 中 `[]` 和 `array()` 都不该单独用作类型声明

现在写 function foo(): array { ... } 或 function bar(array $input) 是过时做法。PHP 8.1 的数组形状（Array Shapes）和 8.2 的只读数组（readonly array）才是真正面向未来的写法。

用 [] 初始化一个变量没问题，但函数签名里继续写 array 就浪费了类型系统能力。IDE 补全、参数校验、错误提前暴露全打折扣。

替代 function getConfig(): array → 写成 function getConfig(): array{host: string, port: int, ssl: bool}
替代 function process(array $items) → 写成 function process(array{id: int, name: string} $items)
如果数组内容不可变，加 readonly：readonly array{code: string, message: string}

真正容易被忽略的不是语法选哪个，而是把 [] 和 array() 当成“类型”来用。它们只是初始化语法，不是类型声明。跨版本兼容的终点不是迁移到 []，而是让类型信息从注释和约定，变成运行时可验证、IDE 可感知的显式契约。