在输出缓冲加载的模板文件中调用对象方法时丢失作用域

这个问题我之前做自定义模板引擎的时候也踩过坑！核心原因是模板文件在render方法的局部作用域内执行，默认情况下，模板里的代码访问不到你的类实例（$this）以及方法里的局部变量，所以才会出现变量未定义、调用非对象方法的错误。

先拆解下错误原因： #

• Notice: Undefined variable: template：模板里引用了$template变量，但这个变量只在render方法里以$this->template的形式存在，模板作用域里找不到它
• Fatal error: Call to a member function showTitle() on a non-object：模板里调用showTitle()的对象（比如你可能写了$obj->showTitle()）在当前模板的作用域中不存在，或者被当成了非对象

快速解决方案（不用改大量模板） #

根据你模板里的调用习惯，选下面其中一种方法修改render函数即可：

方案1：把当前类实例传递给模板的变量（匹配你模板里的对象调用）

如果你的模板里是用类似$template->showTitle()这种方式调用方法，那直接在require前把当前实例赋值给$template变量：

public function render($file){ 
    $template = $this; // 关键：把当前类实例赋值给模板里要用的变量名
    ob_start(); 
    require_once($file); 
    $this->template = ob_get_contents(); 
    ob_end_clean(); 
    return $this->template; 
}

这样模板里的$template就指向你的类实例，$template->showTitle()就能正常执行，也能访问$template的属性了。

方案2：让模板直接访问$this

如果你的模板里愿意改成$this->showTitle()调用，那其实不需要额外赋值——PHP中require加载的文件会继承当前函数的作用域，模板里直接写$this就能访问类实例：

// render方法不用改，保持你原来的代码就行
public function render($file){ 
    ob_start(); 
    require_once($file); 
    $this->template = ob_get_contents(); 
    ob_end_clean(); 
    return $this->template; 
}

然后模板里直接用$this->showTitle()和$this->template即可，这种方式最简洁，不需要额外变量。

方案3：批量暴露类属性到模板（可选）

如果你的模板里习惯直接用属性名（比如$title而不是$template->title），可以用extract把类的公共属性提取到模板作用域：

public function render($file){ 
    extract(get_object_vars($this)); // 把类的公共属性转为模板里的普通变量
    $template = $this; // 还是要传递实例，方便调用方法
    ob_start(); 
    require_once($file); 
    $this->template = ob_get_contents(); 
    ob_end_clean(); 
    return $this->template; 
}

这样模板里既可以直接写$title（对应$this->title），也能写$template->showTitle()调用方法。

注意事项 #

• 如果你用的是require_once，要确保模板文件没有被重复加载导致的问题，必要时可以换成require（根据你的业务场景）
• 确保类的方法和属性是public的，否则模板里访问不到私有/受保护的成员

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