PhpStorm 2024.1 ヘルプ

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

PhpStorm には、Laravel Blade テンプレートエンジン(英語)のサポートが組み込まれています。IDE は、Blade 構造と挿入された言語 (HTML、JavaScript、CSS) の構文ハイライトとコーディング支援を提供します。

波括弧およびディレクティブ用のコード補完

PhpStorm のエディターは、標準およびカスタム Blade ディレクティブの両方にコード補完を提供します。カスタムディレクティブは、ディレクティブタブの設定 (Ctrl+Alt+S) | PHP | Blade定義できます

Laravel Blade directive completion

@for または @foreach ディレクティブを使用すると、コード補完による変数の導入が構成要素の本体内で使用可能になります。

Laravel Blade variable introduction completion

コード補完と拡張とインクルード用のナビゲーション

Blade テンプレートはしばしば小さな再利用可能なブロックのさまざまなインクルードで構成されていて、それらは順番に他のテンプレートです。また、テンプレートを拡張して追加のセクションにコンテンツを提供することもできます。PhpStorm および Laravel プラグインは、@extends ディレクティブと @include ディレクティブの両方でテンプレート名の補完を提供します。補完候補には、テンプレートのディレクトリ名と完全なテンプレート名が含まれます。

Laravel Blade @extends directive completion

テンプレートの宣言に移動するには、その使用箇所にキャレットを置き、Ctrl+B を押します。または、Ctrl+Click を使用します。

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

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

JavaScript または CSS を Blade テンプレートセクションに自動的に挿入する

PhpStorm は、定義された挿入ルールに基づいて、Blade テンプレートセクションにコードを自動的に挿入できます。デフォルトでは、JavaScript および CSS コードを自動的に挿入するためのルールを利用できます。

  • Blade テンプレートで、次のように javascript (JavaScript を挿入する)または css (CSS を挿入する)という名前のセクションを追加します。

    @section('javascript') // injected JavaScript code @stop @section('css') // injected CSS code @stop

    PhpStorm は、JavaScript または CSS をテンプレートセクションに自動的に挿入します。

    Automatically inject JavaScript and CSS in Blade a template

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

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

Blade デバッグを有効にする

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

  2. キャッシュパスフィールドに、Blade コンパイル済みテンプレートのキャッシュ(英語)フォルダーへの絶対パスを入力します。パスを手動で入力するか、the Browse button をクリックして、開いたダイアログで関連するフォルダーを選択します。デフォルトでは、コンパイルされた Blade テンプレートは、プロジェクト内の storage/framework/views/ フォルダーに保存されます。

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

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

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

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

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

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

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

Blade テンプレートを設定する

Blade ディレクティブを追加、修正、削除する

Blade ディレクティブは、Blade ページディレクティブタブで管理されます。このタブには、現在使用可能なすべての Blade ディレクティブが一覧表示されます。パラメーターがあるものについては、プレフィックスとサフィックスも表示されます。開始すると、リストには事前定義されたディレクティブのみが含まれます。これらのディレクティブを編集したり、カスタムディレクティブを作成したりできます。

  1. 設定ダイアログ(Ctrl+Alt+S)で、PHP | Blade に移動します。

  2. 開いた Blade ページで、ディレクティブタブに切り替えます。これには、現在利用可能なすべてのディレクティブのリストが表示されます。

    Blade directives settings
    • 新しいディレクティブを定義するには、the Add button をクリックして名前フィールドにディレクティブの名前を指定します。

      新しいディレクティブにプレフィックスとサフィックスが必要な場合は、パラメーターありチェックボックスをオンにして、使用するプレフィックスとサフィックスをそれぞれ接頭辞フィールドと接尾辞フィールドに入力します。PhpStorm は、自動的に括弧の開閉時に接頭辞と接尾辞を囲み、引用符を追加してコロン区切り文字 : を追加するため、パラメーターは次のようになります: ("<プレフィックス>:<サフィックス>")

    • 既存のディレクティブを編集するには、リストからそれを選択して、下のフィールドの値を変更します。

      元の定義を復元するには、the Reset to defaults button をクリックします。

    • リストからディレクティブを削除するには、それを選択して the Remove button をクリックします。

Blade 区切り文字を設定する

PhpStorm は Blade テンプレートを認識し、指定した区切り文字に基づいて、エラーのハイライトとコード補完を提供します。

  1. 設定ダイアログ(Ctrl+Alt+S)で、PHP | Blade に移動します。

  2. 開いた Blade ページで、テキストタグに切り替えます。タブのフィールドには、raw タグ(英語)content タグ(英語)、およびエスケープされたタグの開始(英語)文字と終了文字が表示されます。

  3. フィールドには、Blade テンプレート 5.8(英語) に準拠したデフォルト値が入力されます。以前のバージョンを使用している場合は、関連するカスタム区切り文字を指定することができ、PhpStorm は新しい規則に従ってコーディング支援を行います。

関連ページ:

Laravel コード補完とナビゲーション

Laravel Idea プラグインは、コード生成、簡潔な補完、ルートの自動補完などのコーディング支援機能により、PhpStorm の Laravel に対する組み込みサポートを強化する: このプラグインは PhpStorm にバンドルされていないため、プラグインのインストールの説明に従ってインストールする必要があります。Laravel PhpStorm の Idea 設定:プラグインをインストールすると、設定 ()| 言語 & フレームワーク | Laravel Idea でプラグインの設定にアク...

言語インジェクション

言語インジェクションを使用すると、コードに埋め込まれた他の言語のコード部分を操作できます。文字列リテラルに言語 (HTML、CSS、XML、RegExp など) を挿入すると、プロジェクトのメイン言語でなくても、挿入されたコードに対して包括的なコーディング支援を受けることができます。PHP のコンテキストでは、インジェクション可能な PHP と呼ばれる特別な PHP ダイアレクトを使用できます。このダイアレクトは、省略可能な開始タグを除いて、PHP に似ています。インジェクション可能な PHP は、...

PhpStorm を使用したデバッグ

クイックスタート:以下は、ローカルまたはリモート Web サーバー上で実行される PHP アプリケーションをデバッグするために PhpStorm と Xdebug 3 を使用するためのクイックスタートガイドです。PHP テストのデバッグや SSH 経由のリモートデバッグなどの他のデバッグシナリオについては、デバッグシナリオを参照してください。1. Xdebug をインストールする Xdebug デバッグエンジンは PHP の拡張機能であるため、アプリケーションが実行されるローカルまたはリモート...

ゼロコンフィギュレーションデバッグ

ゼロコンフィギュレーションデバッグの場合、デバッグ構成を作成する必要はありません。代わりに、PHP アプリケーションの開始ページをブラウザーで手動で開き、ブラウザーからデバッグエンジンをアクティブにし、PhpStorm は受信デバッガー接続を待機します。デバッグセッションを開始する:PhpStorm は、最も人気のある 2 つのツール、Xdebug と Zend デバッガーによるデバッグをサポートしています。これらのツールは、互いにブロックし合うため、同時に使用することはできません。この問題を回避...

ブラウザーのデバッグ拡張機能

デバッグを開始するには、まずサーバー上でデバッガーエンジンをアクティブにする必要があります。これを行うには、特別なまたはパラメーターを設定する必要があります (詳細については、Xdebug および Zend デバッガーの公式ドキュメントを参照してください)。手動で行うこともできますが、ワンクリックでデバッガーを有効にできるブラウザー拡張機能を使用する方が便利です。次の表に、使用可能なデバッグ拡張機能を示します。Xdebug ヘルパー Xdebug ヘルパーまたは Xdebug-extPhpStorm ブ...

ブレークポイント

ブレークポイントは、特定のポイントでプログラムの実行を一時停止する特別なマーカーです。これにより、プログラムの状態と動作を調べることができます。ブレークポイントは、たとえば、特定のコード行に到達したときにプログラムを一時停止するなどの単純なものから、追加の条件をチェックしたり、ログに書き込んだりするなどのより複雑なロジックを含むものまであります。ブレークポイントは、一度設定すると、一時的なブレークポイントを除き、明示的に削除するまでプロジェクト内に残ります。ブレークポイントの種類:PhpSto