PhpStorm 2026.1 Help

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

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

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

  1. 言語を挿入したいテンプレートブロックの中にキャレットを置き、 Alt+Enter を押すか、 インテンションアクションボタン をクリックします。

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

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

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

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

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

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

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

      {% 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 に移動し、 タグコメント変数 ブロックに使用する目的の値を入力します。

    カスタム 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}構成環境 (例: 開発 または prod )を指定します。

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

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

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

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

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

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

  5. デバッグセッション中、 プログラムの状態を調べることができます。変数の値の確認、式の評価、ステップ実行なども可能です。

デバッグセッション中に、テンプレートのブレークポイントが到達できない場合(テンプレートの行がコンパイル済み PHP ファイルのどの行にも対応していない場合)、PhpStorm が警告を表示します。

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