PHP 8环境下Smarty模板无法正常运行的问题排查求助

问题描述 #

项目使用Smarty模板，在PHP 7.4环境运行正常，但切换到PHP 8/8.1后出现大量配置值缺失的情况。尝试升级Smarty库后，原有问题未解决，还新增了其他错误。以下是不同PHP版本下TshSmarty对象的输出对比：

PHP 7.4 下的 TshSmarty 对象输出 #

TshSmarty Object
(
    [RootDir] => /home2/mjollnir/public_html/dev_mjollnirgroup/
    [TemplateDir] => /home2/mjollnir/public_html/dev_mjollnirgroup/template/
    [CompileDir] => /home2/mjollnir/public_html/dev_mjollnirgroup/compile/
    [CacheDir] => /home2/mjollnir/public_html/dev_mjollnirgroup/compile/cache/
    [IsCached] => 
    [IsCompileCheck] => 1
    [IsForceCompile] => 
    [template_dir] => /home2/mjollnir/public_html/dev_mjollnirgroup/template/
    [compile_dir] => /home2/mjollnir/public_html/dev_mjollnirgroup/compile/
    [config_dir] => configs
    [plugins_dir] => Array
        (
            [0] => plugins
        )

    [debugging] => 
    [error_reporting] => 
    [debug_tpl] => 
    [debugging_ctrl] => NONE
    [compile_check] => 1
    [force_compile] => 
    [caching] => 
    [cache_dir] => /home2/mjollnir/public_html/dev_mjollnirgroup/compile/cache/
    [cache_lifetime] => 3600
    [cache_modified_check] => 
    [php_handling] => 0
    [security] => 
  
)

PHP 8.x 下的 TshSmarty 对象输出 #

TshSmarty Object
(
    [template_dir] => templates
    [compile_dir] => templates_c
    [config_dir] => configs
    [plugins_dir] => Array
        (
            [0] => plugins
        )

    [_cache_include] => 
    [_cache_including] => 
    [RootDir] => 
    [TemplateDir] => 
    [CompileDir] => 
    [CacheDir] => 
    [IsCached] => 
    [IsCompileCheck] => 1
    [IsForceCompile] => 
)

解决方案建议 #

• 检查TshSmarty类的构造逻辑
  从输出对比看，PHP 8.x下自定义的RootDir/TemplateDir等属性未被正确赋值，需排查类初始化代码：

  • 确认构造函数中是否使用了PHP 7.4兼容但PHP 8.x已废弃/行为变更的语法，比如func_get_args()的不当使用、动态属性赋值限制
  • PHP 8.0+默认禁止未声明的动态属性，若TshSmarty未显式声明RootDir等属性，需添加属性定义，或在类上添加#[AllowDynamicProperties]注解

• 调整Smarty配置方式
  避免依赖自定义属性传递配置，改用Smarty原生setter方法：

  // 替换直接赋值自定义属性的写法
  $smarty->setTemplateDir('/home2/mjollnir/public_html/dev_mjollnirgroup/template/');
  $smarty->setCompileDir('/home2/mjollnir/public_html/dev_mjollnirgroup/compile/');
  $smarty->setCacheDir('/home2/mjollnir/public_html/dev_mjollnirgroup/compile/cache/');
  

• 排查Smarty版本兼容性
  升级后出现新错误，说明TshSmarty的扩展逻辑与新版本Smarty不兼容：

  • 确保使用的Smarty版本完全支持PHP 8.x（推荐Smarty 4.x）
  • 检查TshSmarty是否重写了Smarty核心方法，这些方法在新版本中可能已被修改或移除，需对应调整重写逻辑

• 开启错误日志定位问题
  在PHP 8.x环境下开启详细错误日志，查看初始化TshSmarty时的隐性错误：

  error_reporting(E_ALL);
  ini_set('display_errors', 1);
  ini_set('log_errors', 1);
  

内容的提问来源于stack exchange，提问作者zohaib irshad