Smarty 4.5.2模板生成引发PHP数组转字符串转换警告求助

环境信息 #

• PHP版本：8.2
• Smarty版本：4.5.2

代码情况 #

PHP端数组定义 #

$utility_links = array(
    0 => array(
        'name'     => 'Member Login',
        'hrefpage' => 'login_page.php'
    )
);

Smarty子模板代码（utility_links_nav.tpl） #

{section name="i" loop=$utility_links}
    <a href="{$utility_links[i].hrefpage}"> {$utility_links[i].name} </a> |
{/section}

报错详情 #

升级后触发PHP警告：Array to string conversion，报错位于编译后的模板文件 /var/www/members.austintgca.com/htdocs/smarty/templates_c/1ca2fef31b64289057db4688371cb3bf741c93cd_0.file.static_main_page.tpl.php 第35行，对应编译代码为：

$_smarty_tpl->_subTemplateRender("file:utility_links_nav.tpl", $_smarty_tpl->cache_id, $_smarty_tpl->compile_id, 0, $_smarty_tpl->cache_lifetime, array('utility_links'=>((string)$_smarty_tpl->tpl_vars['utility_links']->value)), 0, false);

原因分析 #

从编译代码可见，Smarty 4.5.2自动对传递给子模板的utility_links数组变量添加了(string)强制转换操作，而PHP 8.2对数组转字符串的操作会严格抛出类型警告。这是Smarty版本升级后的行为变化：旧版本不会对数组变量做自动字符串转换，新版本的编译逻辑在处理子模板变量传递时出现了错误的类型强制转换。

解决办法 #

方法1：移除强制字符串转换 #

如果是通过PHP代码调用_subTemplateRender传递变量，直接去掉(string)强制转换，改为传递原始数组：

$_smarty_tpl->_subTemplateRender("file:utility_links_nav.tpl", $_smarty_tpl->cache_id, $_smarty_tpl->compile_id, 0, $_smarty_tpl->cache_lifetime, array('utility_links'=>$_smarty_tpl->tpl_vars['utility_links']->value), 0, false);

如果是通过Smarty模板标签调用子模板，确保变量传递逻辑正确，比如使用{include}时直接传递数组：

{include file="utility_links_nav.tpl" utility_links=$utility_links}

方法2：替换旧循环语法 #

Smarty 4.x推荐使用{foreach}替代老旧的{section}循环语法，{foreach}对数组的兼容性更好，能避免旧语法触发的编译逻辑问题：

{foreach from=$utility_links item=link}
    <a href="{$link.hrefpage}"> {$link.name} </a> |
{/foreach}

方法3：清除编译缓存并强制重新编译 #

删除templates_c目录下的所有编译文件，然后在Smarty初始化代码中开启强制编译，确保模板使用最新逻辑编译：

$smarty->setForceCompile(true);

内容的提问来源于stack exchange，提问作者James Doherty