PHP7.1短数组[]完全替代array(),PHP5.6模板兼容坑-php教程-PHP中文网

php 5.6 模板中写 [] 报错的真正原因是运行环境实际低于 php 5.4 或模板被不支持该语法的预处理器解析，而非 php 版本标称问题。

php7.1短数组[]完全替代array(),php5.6模板兼容坑

PHP 7.1 环境下可以直接用 [] 替代 array()，但 PHP 5.6 模板（如 Smarty、Twig 或自定义模板引擎）里写 [] 会直接报错——这不是 PHP 解析器的问题，而是模板语法冲突或 PHP 版本未达 5.4 导致的解析失败。

PHP 5.6 模板里写 `[]` 报错的真正原因

很多所谓“PHP 5.6 模板”实际运行在 PHP 5.3 或更老环境（尤其老旧 CMS、定制后台），而 [] 数组语法是 PHP 5.4 才引入的。即使你本地 PHP 是 5.6，模板文件若被当作纯文本解析、或经由不支持该语法的预处理器（如某些 Smarty 插件、旧版 Twig 编译器）处理，[] 就会被当成非法 token 抛出 Parse error: syntax error, unexpected '['。

确认真实运行环境：用 phpinfo() 或 echo PHP_VERSION; 查服务器实际版本，别信“标称 5.6”
检查模板是否经过二次编译：比如 Smarty 的 compile_dir 下生成的 PHP 文件，如果缓存未刷新，可能仍含旧语法或残留 array() 被强制替换后出错
注意模板内嵌 PHP 代码块：有些模板允许 {php}...{/php} 或 <?php ... ?>，这部分由 PHP 解析器执行，必须严格匹配运行时版本

`php-cs-fixer` 启用 `@PHP7x1Migration` 会把 `array()` 全替成 `[]`，但别急着跑

这个规则集确实包含 array_syntax（来自 @PHP5x4Migration 子集），但它默认只作用于 PHP 5.4+ 代码。如果你项目里混着 PHP 5.3 兼容逻辑、或模板文件被误加入 fix 范围，php-cs-fixer 会无差别替换，导致上线即崩。

btpanel phpsite 宝塔面板PHP网站

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

下载

限定作用范围：在 .php-cs-fixer.php 中用 'finder' => PhpCsFixer\Finder::create()->in('src')->name('*.php')，排除 templates/、views/ 目录
禁用高风险规则：显式关闭 array_syntax，哪怕你目标是 7.1，“安全迁移”优先级高于“语法统一”
别依赖 @PHP71Migration：它已被标记为 DEPRECATED，v4.0 会删，硬切过去等于埋一个半年后必爆的雷

模板里需要数组字面量？用函数封装比硬写更稳

与其在模板里纠结 [] 还是 array()，不如把数组构造逻辑收进 PHP 层。模板只接收已准备好的变量，彻底规避语法层冲突。

Smarty 示例：在 PHP 控制器中 $smarty->assign('items', ['a', 'b', 'c']);，模板里只写 {foreach $items as $item}{/foreach}
Twig 示例：用 set items = ['a', 'b', 'c'] 是安全的（Twig 自己解析，不走 PHP 解析器），但前提是 Twig 版本 ≥ 1.12（对应 PHP ≥ 5.3.3）
自定义模板引擎：若支持 PHP 表达式，优先用 array('a','b','c')；若支持短语法，确认其 parser 是否基于 PHP 5.4+ 构建

最常被忽略的一点：[] 和 array() 在 PHP 5.4+ 功能完全等价，但“等价”不等于“可互换于所有上下文”。模板不是 PHP 文件，它的解析器有自己的规则和版本依赖。别让一个看似微小的语法糖，成为压垮兼容性链条的最后一根稻草。