PhpStorm 2026.1 ヘルプ

コマンドラインからファイルをフォーマットする

PhpStorm は、構成されたコードスタイル設定に従ってコードをフォーマットできます。コマンドラインから指定したファイルにコードスタイルの書式を適用することもできます。

コマンドラインフォーマッタは、バックグラウンドで PhpStorm のインスタンスを起動し、フォーマットを適用します。PhpStorm の別のインスタンスがすでに実行されている場合は機能しません。この場合、実行中のインスタンスからコードスタイルのフォーマットを実行できます。コマンドラインフォーマッタを使用して、多くのコントリビューターがいる大規模なコードベースの自動定期保守を行い、一貫したコーディングスタイルを確保します。

ファイルをフォーマットできるようにするには、PhpStorm の対応するファイルタイプをサポートするプラグインをインストールして有効にします(たとえば、シェルスクリプトファイルをフォーマットするシェルスクリプトプラグイン)。

PhpStorm を実行するための実行ファイルは、インストールディレクトリbin にあります。この実行ファイルをコマンドラインランチャーとして使用するには、コマンドラインインターフェースの説明に従って、システム PATH に追加してください。

構文
phpstorm64.exe format [<options>] <path ...>
サンプル

デフォルトのコードスタイル設定を使用して、C:\Data\src ディレクトリから 2 つの特定のファイルをフォーマットします。

phpstorm64.exe format -allowDefaults C:\Data\src\hello.html C:\Data\src\world.html

デフォルトのコードスタイル設定を使用して、すべてのサブディレクトリを含む C:\Data\src ディレクトリ内のすべてのファイルを再帰的にフォーマットします。

phpstorm64.exe format -allowDefaults -r C:\Data\src

C:\Data\settings.xml のコードスタイル設定を使用して、C:\Data\src ディレクトリ内のすべての .xml および .html ファイルを非再帰的にフォーマットします。

phpstorm64.exe format -s C:\Data\settings.xml -m *.xml,*.html C:\Data\src

PhpStorm には、コマンドラインコードフォーマッタを実行するためのスクリプトが含まれています。デフォルトでは、アプリケーションパッケージ PhpStorm.app/Contents/bin/format.sh にあります。

構文
./format.sh [<options>] <path ...>
サンプル

デフォルトのコードスタイル設定を使用して、~/Data/src ディレクトリから 2 つの特定のファイルをフォーマットします。

./format.sh -allowDefaults ~/Data/src/hello.html ~/Data/src/world.html

デフォルトのコードスタイル設定を使用して、すべてのサブディレクトリを含む ~/Data/src ディレクトリ内のすべてのファイルを再帰的にフォーマットします。

./format.sh -allowDefaults -r ~/Data/src

~/Data/settings.xml のコードスタイル設定を使用して、~/Data/src ディレクトリ内のすべての .xml および .html ファイルを非再帰的にフォーマットします。

./format.sh -s ~/Data/settings.xml -m *.xml,*.html ~/Data/src

PhpStorm を実行するためのスクリプトは、インストールディレクトリbin にあります。このスクリプトをコマンドラインランチャーとして使用するには、コマンドラインインターフェースの説明に従って、システムの PATH に追加してください。

構文
phpstorm.sh format [<options>] <path ...>
サンプル

デフォルトのコードスタイル設定を使用して、~/Data/src ディレクトリから 2 つの特定のファイルをフォーマットします。

phpstorm.sh format -allowDefaults ~/Data/src/hello.html ~/Data/src/world.html

デフォルトのコードスタイル設定を使用して、すべてのサブディレクトリを含む ~/Data/src ディレクトリ内のすべてのファイルを再帰的にフォーマットします。

phpstorm.sh format -allowDefaults -r ~/Data/src

~/Data/settings.xml のコードスタイル設定を使用して、~/Data/src ディレクトリ内のすべての .xml および .html ファイルを非再帰的にフォーマットします。

phpstorm.sh format -s ~/Data/settings.xml -m *.xml,*.html ~/Data/src

オプション

オプション

説明

-h

ヘルプメッセージを表示して終了します。

-m|-mask

処理するファイルを定義するファイルマスクのコンマ区切りリストを指定します。* (任意の文字列)および ? (任意の 1 文字)ワイルドカードを使用できます。

-r|-R

指定されたディレクトリを再帰的に処理します。

-s|-settings

フォーマットに使用するコードスタイル設定ファイルを指定します。これは次のいずれかです。

  • エクスポートされたコードスタイル設定を含むファイル: エディター | コードスタイル設定ページ Ctrl+Alt+S を開き、The Show Scheme Actions button をクリックして、エクスポートを選択します。

  • プロジェクトディレクトリに格納されている .idea/codeStyleSettings.xml ファイル(PhpStorm バージョン 2017.2 以前の場合)。

  • プロジェクトディレクトリに格納されている .idea/codeStyles/Project.xml ファイル(PhpStorm バージョン 2017.3 以降用)。

また、フォーマッタは親ディレクトリで .editorconfig ファイルを検索し、PhpStorm コードスタイル設定に基づいてフォーマットに適用します。この場合、EditorConfig のフォーマットがコードスタイルスキームの設定と重複する場合、PhpStorm は EditorConfig の設定を使用します。残りの設定は、コードスタイルスキームから取得されます。詳細については、EditorConfig を参照してください。

このオプションが指定されていない場合、ファイルはスキップされます。親フォルダーの 1 つにプロジェクトがある場合、その設定は EditorConfig と同様に暗黙的に使用されます。

-allowDefaults

ファイルまたはファイルのグループに対してコードスタイルが定義されていない場合、つまり -s が設定されておらず、ファイルがどのプロジェクトにも属していない場合は、デフォルトのコードスタイル設定を使用します。それ以外の場合、ファイルは無視されます。

-charset

エンコーディングを保持し、ソースファイルの読み取りと書き込みに文字セットを適用します(例: -charset ISO-8859-15)。

このオプションは、コマンドラインフォーマッタがソースファイル内の特殊文字を正しく処理できない場合に役立ちます。

-d|-dry

フォーマッタを検証モードで実行します。フォーマッタはメモリ内で同じフォーマット操作を実行し、フォーマットされたファイルのいずれかが元のファイルと異なる場合、ゼロ以外のステータスで終了します。

2025 年 11 月 24 日

関連ページ:

コードの整形

PhpStorm を使用すると、現在のコードスタイルスキームまたは .editorconfig ファイルで指定した要件に従ってコードを再フォーマットできます。で定義されていないものがあれば、プロジェクト設定から取得されます。コードの一部、ファイル全体、ファイルのグループ、ディレクトリを再フォーマットできます。コードの一部または一部のファイルを再フォーマットから除外することもできます。コードフラグメントを再フォーマットするエディターで、再フォーマットしたいコードフラグメントを選択します。再フォーマット...

IDE で使用されるディレクトリ

デフォルトでは、PhpStorm は、各 IDE インスタンスのユーザー固有のファイル(構成、キャッシュ、プラグイン、ログなど)をユーザーのホームディレクトリに保存します。ただし、必要に応じて、これらのファイルを保存する場所を変更できます。IDE で使用されるファイルとディレクトリを見つけるメインメニューからを選択します。開いたダイアログには、PhpStorm によって使用されるすべてのファイルとディレクトリが、現在のインストールの正確なパスとともに表示されます。リスト内の特定の項目を選択して...

コマンドラインインターフェース

コマンドラインから PhpStorm 機能を使用します: ファイルとプロジェクトを開き、差分を表示し、ファイルをマージし、コードスタイルを適用し、フォーマットし、ソースコードをインスペクションします。スタンドアロンインスタンスのランチャー:インストールディレクトリには、PhpStorm の起動、ソースコードのフォーマット、インスペクションの実行に必要なバッチスクリプトと実行ファイルが含まれています。コマンドプロンプト(cmd.exe)からこれらを使用するには、PhpStorm フォルダー(bi...

EditorConfig

PhpStorm を使用すると、EditorConfig をサポートする個々のファイルセットのすべてのコードスタイル設定を管理できます。必要なのは定義したいコードスタイルのファイルを含むルートディレクトリに .editorconfig ファイルを置くことです。プロジェクトに複数のコードスタイルがある場合(たとえば、テスト用や本番コード用)、プロジェクトの対応するフォルダーに複数の .editorconfig ファイルを含めることができます。これにより、同時に複数のコードスタイル標準に従うことができます。....