TwigPolicy
in package
テンプレートパスに対する Twig 統合の利用可否を判定する。
a-blog cms のテンプレート探索（function findTemplate / main.php のレンダリング
分岐）から本クラスを唯一の窓口として呼び、tplConfig('tpl_twig') の値と
除外パスリスト（self::EXCLUDED_PATHS）の両方を AND した最終結果を
返す。Twig 利用判定のロジックを 1 箇所に集約することで、呼び出し側の
重複と判定漏れを防ぐ。
v3.2.0 ~ v3.2.19 で、不要な twig ファイルが system テーマに残っており、 かつテーマ側で edit.twig を直接 include する等の外部依存があるため、 特定のベース名については意図的に Twig 化を行わないようにする。
将来的に外部依存が完全に解消され、対応する .twig stub を物理削除できるようになった時点で、除外パスを外す。
本クラスは a-blog cms 側のテンプレート探索のみで参照され、Twig 内部 include 経路（CustomLoader）には作用しない。両者を分離することで、 テーマ作者が独自に .twig 化した別パスへの影響を避けつつ、JS のダイレクト 編集 fetch 等で .html を確実に解決させる。
Table of Contents
Constants
- EXCLUDED_PATHS = ['admin/entry/edit']
- Twig 化を行わないベース名（拡張子なし・先頭スラッシュ抜き）。
Methods
- shouldUseFor() : bool
- 与えられたパスについて、最終的に Twig 統合を使うべきかを判定する。
- excludes() : bool
- 与えられたテンプレートパスが除外リストに該当するかを判定する。
Constants
EXCLUDED_PATHS
Twig 化を行わないベース名（拡張子なし・先頭スラッシュ抜き）。
public
array<int, string>
EXCLUDED_PATHS
= ['admin/entry/edit']
Methods
shouldUseFor()
与えられたパスについて、最終的に Twig 統合を使うべきかを判定する。
public
shouldUseFor(string $tpl) : bool
tplConfig('tpl_twig') === 'enabled' と self::excludes() の
否定の AND を取った結果を返す。findTemplate / レンダリング分岐の
両方から本メソッドを呼ぶ。
Parameters
- $tpl : string
Return values
boolexcludes()
与えられたテンプレートパスが除外リストに該当するかを判定する。
private
excludes(string $tpl) : bool
パスは正規化（連続スラッシュ・バックスラッシュ・先頭スラッシュ）された うえでベース名（拡張子を除いた相対パス）として比較される。
Parameters
- $tpl : string