Phalcon 4.2迁移至5.4：表单标签HTML转义问题及解决

在PHP 7.4环境下将Phalcon从4.2版本迁移至5.4版本时，出现表单标签内HTML被转义的问题：标签中的<span>、<i>等HTML元素被渲染为纯文本，无法正常解析。

问题场景代码 #

表单定义（PHP） #

class CustomForm extends FormBase
{
    // ...
    $customfield = new Numeric('customfield');
    $customfield->setLabel(ucwords($translations['keyi18n']) . ' <span title="Lorem" class="gv-tip">&nbsp;<i class="fas fa-info-circle"></i></span>');
    $this->add($customfield);
    // ...
}

Volt模板渲染代码 #

{{ form.label('customfield', ['class':'customclass']) }}
{{ form.render('customfield', ['class':'customclass']) }}

错误渲染结果 #

渲染后的HTML中，HTML标签被转义，无法正常显示：

<label for="customfield" class="customclass">keyi18n &lt;span title="Lorem" class="gv-tip"&gt;&amp;nbsp;&lt;i class=" fas fa-info-circle"&gt;&lt;/i&gt;&lt;/span&gt;</label>

已尝试的无效方案 #

• 启用/禁用Volt的自动转义模式
• 在Volt视图中使用Tag::setAutoescape(false);

解决方案 #

通过在表单类中自定义方法，生成不转义HTML内容的标签，解决该问题：

表单类中添加自定义方法 #

public function labelHtml($name, array $attributes = [])
{
    $element  = $this->get($name);

    $tagFactory = $this->getTagFactory() ?? new \Phalcon\Html\TagFactory(new \Phalcon\Html\Escaper());
    $internalAttributes = $element->getAttributes();

    $name = $internalAttributes["id"] ?? $element->getName();

    if (!isset($attributes["for"])) {
        $attributes["for"] = $name;
    }

    // 使用定义的标签或回退到名称
    $labelName = $element->getLabel();

    if (!($labelName || is_numeric($labelName))) {
        $labelName = $name;
    }

    // 第三个参数"true"禁用转义
    $code = ($tagFactory->newInstance("label"))($labelName, $attributes, true);

    return $code;
}

修改Volt模板调用 #

将默认的form.label()替换为自定义方法：

{{ form.labelHtml('customfield', ['class':'customclass']) }}

修改后，标签内的HTML将被正常渲染，不会被转义。

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