如何使用Twig遍历目录文件实现文件夹内模板自动引入？

核心结论 #

原生纯Twig（仅使用官方内置功能，不额外编写PHP自定义逻辑的前提下）不支持直接遍历目录批量引入文件。

原因说明 #

Twig的定位是表现层模板渲染引擎，默认做了功能边界限制，没有开放文件系统扫描相关的内置能力，避免引发任意文件读取、路径遍历等安全风险。

可行实现方案 #

依赖PHP的动态实现方案（支持运行时自动识别新增文件） #

如果你可以编写PHP侧逻辑，有两种常见实现方式：

• 方式1：业务逻辑层预先扫描目录，将文件路径列表作为变量传入模板
  PHP侧示例代码：

  $xDirTwigFiles = glob('你的X目录绝对路径/*.twig');
  echo $twig->render('Y.twig', ['x_dir_files' => $xDirTwigFiles]);
  

  Y.twig侧逻辑：

  {% for filePath in x_dir_files %}
    {% include filePath %}
  {% endfor %}
  

• 方式2：自定义Twig函数，封装目录扫描逻辑后注册到Twig环境，之后就可以直接在Twig模板内调用该函数获取文件列表循环引入。

无PHP的静态实现方案（仅支持发布前新增文件场景） #

如果你完全无法修改PHP代码，可以借助前端构建工具（如Gulp、Vite、Webpack等），在代码发布阶段自动扫描X目录下的所有twig文件，生成批量引入语句写入Y模板即可，新增文件后需要重新执行构建流程才能生效。

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