TYPO3添加file协议本地文件链接后前端href属性丢失如何修复

问题原因 #

TYPO3默认的富文本内容安全过滤规则会拦截http/https/mailto等标准web协议之外的URL，file://本地文件协议不在默认允许列表内，因此渲染前端时会直接剥离对应a标签的href属性。

修复步骤 #

方案1：调整站点配置（适用于TYPO3 v10及以上版本） #

• 登录TYPO3后台，进入站点管理模块，选择对应站点的配置
• 切换到设置页签，找到「内容渲染」分类下的allowedUrlSchemes配置项
• 在现有允许的协议列表末尾追加file，修改后示例：http,https,ftp,mailto,file
• 保存配置后清空TYPO3全量缓存，重新预览前端页面即可

方案2：修改TypoScript配置（适用于TYPO3 v9及更早版本） #

在根模板的TypoScript配置中添加如下规则：

# 允许file协议作为链接地址
lib.parseFunc_RTE.urlInfoAllowedSchemes := addToList(file)
# 保留a标签的href属性
lib.parseFunc_RTE.tags.a.allowedAttribs := addToList(href)

保存TypoScript后清空缓存即可生效。

注意事项 #

现代浏览器默认禁止HTTPS站点跳转至file://协议资源，这是浏览器原生安全策略限制，和TYPO3配置无关。如果你的站点使用HTTPS协议，建议将需要引用的文件上传至TYPO3后台「文件列表」模块，生成站点内资源链接使用，兼容性最优。

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