升级PHP 8.2与Symfony/Twig后出现render()空对象调用错误求助

问题概述 #

近期将PHP从7.4版本升级至8.2，同步升级Symfony及Twig至当前版本（Twig 3.5）后，网站遗留模板渲染故障，核心错误为调用null对象的render()方法。

错误详情 #

Fatal error: Uncaught Error: Call to a member function render() on null in /var/www/html/website/lib/Template.php:79

Stack trace:
#0 /var/www/html/website/lib/Handler.php(44): MyProject\Template::render()
#1 /var/www/html/website/lib/Handler.php(61): MyProject\Handler::error()
#2 [internal function]: MyProject\Handler::exception()
#3 {main}
  thrown in /var/www/html/website/lib/Template.php on line 79

问题代码定位 #

错误触发行在Template类的render方法中：

$output = self::$twig->render($template . '.twig', $args);

完整render方法代码：

public static function render($template, $args = [], $returnOutput = false)
{
    $arg['user'] = Auth::user();
    $output = self::$twig->render($template . '.twig', $args);

    if (getenv('STAGE') == 'dev') {
        $output = self::$purifierExtension->getLog() . $output;
    }

    if ($returnOutput) {
        return $output;
    } else {
        echo $output;
    }
}

调用该方法的页面代码：

MyProject\Template::header('MyProject', true);

$user = MyProject\Auth::user();
$args = [
    'error' => false,
    'redirect' => isset($_GET['redirect']) && $_GET['redirect'] ? $_GET['redirect'] : 'main.php',
    'username' => ''
];


if (!$user && isset($_POST['username'])) {
    MyProject\Form::validateCsrf('login');

    $username = $_POST['username'];
    $passwrd = $_POST['password'];


    // query for matching user/password
    try {
        $MyProjectuserid = MyProject\Auth::login($username, $passwrd);
    } catch (UnauthorizedHttpException $ex) {
        $args['error'] = 'Could not login. Please try again.';
        $args['username'] = $username;
    }
}

if (MyProject\Auth::user()) {
    MyProject\Alert::redirect($args['redirect']);
}

MyProject\Template::render('index', $args);

MyProject\Template::footer();

已排查操作 #

• 检查文件权限，无异常
• 通过Composer移除并重装相关依赖包，问题未解决
• 注释其他代码后确认：错误由self::$twig为null导致

初始化相关代码 #

Template.php中与$twig相关的代码片段：

private static $twig;
    self::$twig = new Twig_Environment($loader);
    self::$twig->addFunction($fn);
    self::$twig->addExtension(self::$purifierExtension);
    self::$twig->addExtension(self::$answerTypeExt);
$output = self::$twig->render($template . '.twig', $args);
    return self::$twig;

Handler.php的init方法：

public static function init()
{
    $loader = new Twig_Loader_Filesystem('templates');
    self::$twig = new Twig_Environment($loader);

Bootstrap.php加载逻辑：

require('vendor/autoload.php'); 
use Symfony\Component\Dotenv\Dotenv; 
$dotenv = new Dotenv(); 
$dotenv->load(__DIR__.'/../.env');
MyProject\Handler::init(); 
MyProject\DB::init();
MyProject\Auth::init();
MyProject\Template::init();
MyProject\Form::init();

解决建议 #

1. 适配Twig 3.x命名空间变化 #

Twig 3.x已全面使用命名空间，旧的下划线式类名（Twig_Environment、Twig_Loader_Filesystem）已被弃用，需替换为命名空间形式：

// Handler.php的init方法中
use Twig\Loader\FilesystemLoader;
use Twig\Environment;

public static function init()
{
    $loader = new FilesystemLoader('templates');
    self::$twig = new Environment($loader);
}

Template.php中的初始化代码需同步替换类名。

2. 完善Template类的init方法 #

从提供的代码片段看，Template::init()方法不完整，需确保其完整执行Twig初始化逻辑：

• 加载模板目录
• 创建Environment实例
• 添加所需扩展
• 可添加错误捕获，排查初始化失败原因：

public static function init()
{
    try {
        $loader = new FilesystemLoader('templates');
        self::$twig = new Environment($loader);
        // 添加上下文的扩展、函数等逻辑
        error_log('Template Twig实例初始化成功');
    } catch (\Exception $e) {
        error_log('Template Twig初始化失败：' . $e->getMessage());
        throw $e; // 抛出异常确保错误被暴露
    }
}

3. 检查初始化顺序与变量冲突 #

Bootstrap中先执行Handler::init()再执行Template::init()，若两个类的$twig静态变量是独立的，需确保Template自身的$twig被正确初始化；若存在共享逻辑，需统一由一个类负责Twig实例的创建与管理，避免覆盖或未初始化。

4. 修复render方法的笔误 #

render方法中存在未定义变量的笔误，PHP 8.2对未定义变量检测更严格，需修正：

// 错误代码
$arg['user'] = Auth::user();
// 修正后
$args['user'] = Auth::user();

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