PhpStorm 2026.3 Help

Twig テンプレートのサポート

Twig テンプレートへの言語インジェクション

Twig テンプレートを使用する場合、テンプレートブロック内に コードフラグメントを挿入できます。 PhpStorm は、そのコードフラグメントを編集するための包括的な言語支援を提供します。

  1. 言語を挿入したいテンプレートブロックの中にキャレットを置き、 Alt+Enter を押すか、 the Intention action button をクリックします。

  2. 言語または参照の挿入 を選択して、ポップアップメニューからインジェクションしたい言語を選択します。

    Twig テンプレートにコードを挿入する

JavaScript を Twig テンプレートブロックに自動的にインジェクションする

PhpStorm は、 定義された挿入ルールに基づいて、Twig テンプレートブロックにコードを自動的に挿入できます。 デフォルトでは、JavaScript コードを自動的に挿入するためのルールを利用できます。

  • Twig テンプレートで、以下のいずれかを実行します。

    • 次のように javascript という名前のブロックを追加します。

      {% block javascript %} //injected JavaScript code {% endblock %}
    • 次のようにカスタム script ブロックを追加します。

      {% script %} //injected JavaScript code {% endscript %}

    PhpStorm は自動的に JavaScript をテンプレートブロックに挿入します。

    Automatically inject JavaScript code in Twig a template

Twig 構文のカスタマイズ

場合によっては、Twig 構文をカスタマイズする必要があります。 これは、たとえば、 AngularJS などの他のテンプレート言語との衝突を回避できます。

  1. コードで、 Twig のドキュメント(英語)に従って Twig 構文をカスタマイズします。

  2. この構文を正しく認識できるように、PhpStorm で対応する調整を行います。

    設定 ダイアログ (Ctrl+Alt+S) で、 PHP | Twig に移動し、 Tag、 Comment、 Variable ブロックに使用する目的の値を入力します。

    カスタム Twig 構文

Twig テンプレートのデバッグ

通常の PHP ファイルと同じ方法で Twig テンプレートをデバッグできます。

開始する前に、 \Twig\Environment(英語) インスタンスで次のオプションが設定されていることを確認してください。

debug: true auto_reload: true

Twig デバッグを有効にする

  1. 設定 ダイアログ (Ctrl+Alt+S) で、 PHP | デバッグ | テンプレート に移動し、 Twig デバッグ 領域を展開します。

  2. キャッシュパス フィールドに、Twig の コンパイル済みテンプレートキャッシングフォルダーへの絶対パスを指定します。 パスを手動で入力するか、 参照ボタン をクリックして、開いたダイアログで関連するフォルダーを選択します。 デフォルトでは、コンパイル済み Twig テンプレートはプロジェクト内の var/cache/{environment}/twig フォルダーに保存されます。ここで {environment} は dev や prod などの 構成環境を示します。

デバッグセッションを開始する

Ultimate デバッグガイドの説明に従ってデバッグセッションを開始します。 最も簡単で推奨される方法は ゼロコンフィギュレーションデバッグ を使うことです。

  1. ブラウザーに適したブラウザー拡張機能を選択してインストールします。

  2. PhpStorm ツールバーで、 the Start Listening for PHP Debug Connections button を切り替えて受信 PHP デバッグ接続の待機を開始するか、メインメニューから 実行 | PHP デバッグ接続のリッスンを開始 を選択します。

  3. コードに ブレークポイントを設定します。

  4. ブラウザーの拡張機能を使用して、ブラウザーでデバッグセッションを開始します。

  5. デバッグセッション中に、 プログラムの状態を調べます: 変数の値の確認、式の評価、プログラムのステップ実行などを行います。

デバッグセッション中に、テンプレートブレークポイントに到達できない場合、PhpStorm が警告します。これは、テンプレート行がコンパイル済み PHP ファイル内のどの行にもマップされていない場合に発生します。

Twig テンプレートの到達不能なブレークポイント
2026 年 11 月 9 日