はじめに

弊社のとあるシステムでは(超)マイナーテンプレートエンジンを使って開発を行っていたのだが、

などの様々な問題を抱えていたため、数か月間かけてTwigへのリプレイスを行った。

特殊過ぎてどこにも需要は無さそうだけど、万一こんな謎作業に従事することになった人がいたら少しでも参考になればと思う。

元のテンプレートエンジンはDjangoのTemplateを参考に作られていたので、本記事では勝手にTELD（Template engine like Django's one）と呼称する。¹

実際にやったこと

一度のリリースで完全に移行するのは非常にデメリットが大きかった²ため、
以下のように手順を細かく分けて作業を行った。

TELDを修正する場合、万全を期すため以下のようにさらに細かく段階を踏んで作業を行った。

ゆえにリプレイス完了までに実際は10回以上リリースを行っている。

DjangoのTemplateとTwigが微妙に似ているおかげで、タグや変数の基本的な書き方については問題なかった。³

ただやはり完全に一緒ということは無く、以下のように細かい部分で違いが多数あった。

対象項目	TELD	Twig
フィルタ引数の書式	`{{ my_date\|date:"Y-m-d" }}`	`{{ my_date\|date("Y-m-d") }}`
不正なフィルタの扱い例) `{{ var\|\|escape }}`	なぜか動く（無視される）	エラーになる
変数名として使える文字	`-`や`~`などの記号も使える	`-`や`~`は演算子として解釈される
フィルタ名称例) URLエンコード	urlencode	url_encode
フィルタ挙動例) `{{ 20230102\|date("Y/m/d") }}`	人間的な解釈（`2023年1月2日`）	UNIXタイムスタンプとして解釈
if系タグの種類	if, ifequal, ifnotequal等	ifのみ
forタグ内のループ変数	forloop.counter等	loop.index等
コメントアウト方法	`{# ~ #}`と`{% comment %}~{% endcomment %}`	`{# ~ #}`のみ
タグ直後の改行文字の扱い	削除されない	削除される⁴
includeタグの参照パス	includeタグが記載されたテンプレートからの相対パス	ルートパスを基準とした絶対パス

フィルタ引数の書式や変数名として使える文字等の差異はTwigの拡張で対応できないため、
Twig同様の書式でも動くようにTELDを修正し、テンプレート内の該当箇所は正規表現で一括置換した。

ようするに力業で解決。

【TELDにあってTwigに無い機能】は、テンプレート内での使用頻度によって対応を分けた。

テンプレート内で全く使われていないタグ、フィルタ、関数
→TELDから削除し、新規利用を抑止
テンプレート内で少しだけ使われているタグ、フィルタ、関数
→もし本当に必要ならTwigと同じ書き方ができるようにTELDを修正。無くても何とかなるなら削除
例）ifforwardmatchとかいう謎タグをif ~ starts withに置き換えた、等
テンプレート内で多数使われているタグ、フィルタ、関数
→Twigの拡張で対応することにしたので後述
例）ifequalタグ、commentタグ等

TELDの裏側でTwigによるレンダリングも行えるように魔改造を施し、

とすることで、普通の調査では分からなかった細かい違いをあぶり出した。

TELDのforタグにarray以外を渡すと勝手にarrayでラップしてくれる（文字列とかもループできる）仕様になってたけど、こんなの実際に差分取らなきゃ気付けなるわけないよね。

TELDの実行関数をTwigの呼び出しにそっくり挿げ替えて終わり！
今のところ特にエラーもお問い合わせも来ていないのでセーフ！！

Twigになってコーディングが格段にやりやすくなったと思うので、今はがんばった自分をほめてあげたい。