Twig から Latte への移行

Twig で書かれたプロジェクトを、より現代的な Latte に移行しようとしていますか？移行を楽にするツールがあります。オンラインで試してみてください。

ツールは GitHub からダウンロードするか、Composer でインストールできます。

composer create-project latte/tools

このコンバータは単純な正規表現の置換を使わず、実際の Twig パーサーを利用しているので、どれだけ複雑な構文でも扱えます。

Twig から Latte への変換には twig-to-latte.php スクリプトを使います。

php twig-to-latte.php input.twig.html [output.latte]

変換

変換は一意に決められないため、結果は手作業で直す必要があります。Twig はドット記法を使い、{{ a.b }} は $a->b、$a['b']、$a->getB() のいずれにもなり得ますが、コンパイル時には区別できません。そのためコンバータはすべてを $a->b に変換します。

Twig の一部の関数、フィルタ、タグには Latte に直接の対応物がないか、少し異なる振る舞いをすることがあります。

例

入力ファイルはたとえばこのようなものです。

{% use "blocks.twig" %}
<!DOCTYPE html>
<html>
	<head>
		<title>{{ block("title") }}</title>
	</head>
	<body>
		<h1>{% block title %}My Web{% endblock %}</h1>
		<ul id="navigation">
		{% for item in navigation %}
			{% if not item.active %}
				<li>{{ item.caption }}</li>
			{% else %}
				<li><a href="{{ item.href }}">{{ item.caption }}</a></li>
			{% endif %}
		{% endfor %}
		</ul>
	</body>
</html>

Latte に変換すると、次のテンプレートが得られます。

{import 'blocks.latte'}
<!DOCTYPE html>
<html>
	<head>
		<title>{include title}</title>
	</head>
	<body>
		<h1>{block title}My Web{/block}</h1>
		<ul id="navigation">
		{foreach $navigation as $item}
			{if !$item->active}
				<li>{$item->caption}</li>
			{else}
				<li><a href="{$item->href}">{$item->caption}</a></li>
			{/if}
		{/foreach}
		</ul>
	</body>
</html>