PhpStorm 2026.3 Help

Laravel Pint

組み込みのコーディング支援に加えて、PhpStorm は Laravel Pint と連携します。これは、 PHP CS Fixer を基盤として構築され、 Laravel プロジェクトのコードスタイルの問題を検出するコード品質ツールです。

コマンドラインの代わりに PhpStorm から Laravel Pint を使用するには、それを PhpStorm に登録し、PhpStorm コードインスペクションとして構成する必要があります。 PhpStorm にインストールして有効にすると、ツールは開いているすべての PHP ファイルで使用でき、起動するために追加の手順は必要ありません。 オンザフライコードチェックはファイルが更新されるたびにアクティブになるため、発見された問題を簡単に取り除くことができます。

Laravel Pint によってオンザフライで報告された問題は、 PhpStorm の内部コードインスペクションによって報告されたエラーや警告と同じ方法でエディターでハイライトされます。 ツールをバッチモードで実行すると、エラーと警告が 問題ツールウィンドウ に表示されます。 各メッセージには、PhpStorm 内部インスペクションと区別するために、 Laravel Pint 接頭辞が付いています。

Laravel Pint ルール(英語)の定義済みグループを使用したり、 pint.json ファイル内の特定のルールを有効または無効にしたりできます。

Laravel Pint をインストールして構成する

Laravel Pint を Composer と一緒にインストールする

Laravel Pint は Laravel フレームワークの 最近のリリースに含まれている(英語)ため、通常、プロジェクト内の composer.json ファイルには laravel/pint 依存関係レコードが追加されます。 そうでない場合は、レコードを手動で追加します。

  1. composer.json 内で、 laravel/pint 依存関係レコードを require キーまたは require-dev キーに追加します。 パッケージ名とバージョンのコード補完を取得するには、 Ctrl+Space を押します。

  2. 以下のいずれか 1 つを実行します:

    • エディターパネルの上部にある インストール ショートカットリンクをクリックします。

    • インストールされていない Composer パッケージ インスペクションが有効になっている場合、PhpStorm は、現在インストールされていない宣言済みの依存関係をハイライトします。 Alt+Enter を押して、特定の依存関係をインストールするか、すべての依存関係を一度にインストールするかを選択します。

composer.json エディターのガター内のパッケージレコードの横にある 設定ボタン をクリックすると、対応する 設定 ページが表示され、そこで Laravel Pint を手動で構成できます。

Composer.json の laravel_pint 設定のガターアイコン

PhpStorm で Laravel Pint を構成する

Laravel Pint を Composer とともにインストールすると、PhpStorm は vendor/bin フォルダー内の Laravel Pint の実行可能ファイルを自動的に検出し、それを実行するようにシステムパスに構成された PHP インタープリターを設定します。

設定 (Ctrl+Alt+S) で | PHP | 品質ツール | Laravel Pint では、デフォルトの PHP インタープリターを変更したり、パスを Laravel Pint 実行可能ファイルへのカスタムパスに設定したり、PhpStorm で実行するときに Laravel Pint に渡されるオプションを追加したりできます。

Laravel Pint 設定
  • 構成: このフィールドでは、デフォルトの PHP インタープリターを変更し、Laravel Pint 実行可能ファイルへのパスを設定できます。

    1. インタープリターを変更するには、プロジェクトで構成されているローカルおよびリモート PHP インタープリターのリストから必要な項目を選択します。

    2. Laravel Pint 実行可能ファイルへのパスを設定するには、 構成 リストの横にある 参照ボタン をクリックして Laravel Pint ダイアログを開き、 Laravel Pint ダイアログ リファレンスページの説明に従ってフィールドを編集します。

  • 無視対象ファイルを表示します: Laravel Pint 検証インスペクションからファイルを除外するには、この設定を使用します。 詳細については、 品質ツールリファレンスページを参照してください。

  • Options: この領域に、 Laravel Pint を PhpStorm インスペクションとして実行するためのオプションを追加します。

    • 未コミットのファイルのみを整形: コミットされていない変更が含まれるファイルのみを変更するには、チェックボックスをオンにします。

    • pint.json へのパス: pint.json 構成ファイルへのパスを指定します。 pint.json ファイルは任意です。事前定義された Laravel Pint プリセットから特定のルールを有効化/無効化したり、PHP CS Fixer のカスタムルールセットを再利用したりするために使用されます。

    • ルールセット: コード内のコードスタイルの問題を修正するために使用する、Laravel Pint の 事前定義されたルールグループ(英語)の 1 つを選択します。

Laravel Pint を PhpStorm インスペクションとして有効にする

インスペクション設定で Laravel Pint 検証を有効にする

  1. 設定 ダイアログ(Ctrl+Alt+S )で、 エディター の インスペクション をクリックします。

  2. 開いている インスペクション ページで、 PHP | 品質ツール ノードを展開し、 Laravel Pint の検証 の横にあるチェックボックスを選択します。

    Laravel Pint 検証チェックボックスを選択する
  3. ページの右側のペインで、PhpStorm が Laravel Pint インスペクション出力を処理する方法を構成します。

    1. スコープ: インスペクションアプリケーションを制限する スコープを選択します。

    2. 重大度: インスペクションの 重大度を選択します。 選択した値によって、検出された不一致が PhpStorm によってどの程度深刻に扱われ、 インスペクションの結果に表示されるかが決まります。

    3. エディター内のハイライト: インスペクションによって検出された問題をエディターでハイライトする方法を選択します。

Laravel Pint をバッチモードで実行する

  1. メインメニューで コード | コードのインスペクション へ移動します。

  2. 開いた インスペクションスコープの指定 ダイアログで、リストからインスペクションプロファイルを選択するか、 構成… をクリックして インスペクション ダイアログを開き、新しいプロファイルを構成します。

    構成… をクリックして、選択したインスペクションプロファイルの範囲内で適用される修正を確認し、 Laravel Pint 検証インスペクションが有効になっていることを確認することもできます。

  3. インスペクションの結果を 問題ツールウィンドウ で見る。 Laravel Pint によって報告されたエラーと警告には、PhpStorm の内部インスペクションと区別するために Laravel Pint: の接頭辞が付けられています。

    Laravel Pint インスペクション一覧

Laravel Pint によって検出された問題を修正する

クイックフィックスを使用して問題を修正する

問題を検出すると、PhpStorm は Laravel Pint インスペクション設定に従って問題をハイライトします。

  1. 検出された問題にキャレットを置いて the Intention action button をクリックするか、 Alt+Enter を押します。

  2. ポップアップメニューから Laravel Pint: ファイル全体の修正 を選択してください。 これにより、現在のファイルで検出されたすべての問題が修正されます。

バッチモードで問題を検出したり、 コードの再フォーマットで自動的に修正したりすることもできます。

コードの再フォーマットに関する問題を修正する

再フォーマットコードアクションを実行すると、Laravel Pint によって検出された問題を修正できます。

  1. 品質ツールの設定で Laravel Pint を外部フォーマッタとして設定します。

    これを行うには、 設定 ダイアログ (Ctrl+Alt+S) で PHP | 品質ツール に移動し、 外部フォーマッター セクションで Laravel Pint を選択します。

    外部フォーマッタを選択
  2. 必要なファイルまたはプロジェクトスコープに コードの整形を適用します。

    • エディターで開かれたコードフラグメントまたはファイルの場合、メインメニューから コード | コードの整形 を選択するか、 Ctrl+Alt+L を押します。

    • Project ツールウィンドウで選択したファイル、ディレクトリ、ファイルのグループについて、コンテキストメニューから コードの整形 を選択するか、 Ctrl+Alt+L を押します。

チームでカスタムコーディングスタイルを共有する

  1. コーディング標準のルートディレクトリを プロジェクトルートの下に置きます。

  2. Laravel Pint を PhpStorm インスペクションとして構成します。

  3. コーディング標準を指定します。

  4. インスペクション ページの上部で プロジェクトプロファイルが選択されていることを確認します。 このようなプロファイルは、特定のプロジェクトの .idea ディレクトリ (たとえば、 $PROJECT_DIR$/.idea/inspectionProfiles ) に保存されます。 詳細については、 プッシュされたコミットを元に戻すを参照してください。

  5. 設定 ダイアログの バージョン管理の設定 ページで、 .idea ディレクトリが バージョン管理下にあることを確認します。

Laravel Pint インスペクションからファイルを除外する

Laravel Pint の応答が Laravel Pint ダイアログの ツールプロセスのタイムアウト フィールドで指定された制限を超えるのを待つとき、PhpStorm はファイルを 無視リストに追加することを提案します。

  1. 設定 ダイアログ (Ctrl+Alt+S) で、 PHP | 品質ツール | Laravel Pint に移動します。

  2. 無視対象ファイルを表示します のリンクをクリックしてください。

    • ファイルを追加するには、 追加ボタン をクリックし、表示されるダイアログで目的のファイルを探します。

    • リストからファイルを削除して Laravel Pint に再度処理させるには、ファイルを選択して the Remove button をクリックします。

    • 一覧からすべてのファイルを削除するには、 the Close button をクリックします。

2026 年 11 月 9 日