PhpStorm 2026.1 Help

プロジェクトで PHP 名前空間を構成する

PhpStorm は、PHP の名前空間名をディレクトリ構造にマッピングすることを規定している PSR-0/PSR-4 オートローディング標準に対応しています。 PhpStorm で ソース ルートタイプ でマークされたディレクトリは名前空間のルートとみなされ、その下に作成された各ディレクトリは別個の名前空間とみなされます。

Source ルートタイプが設定されている場合、新しいクラスやインターフェースなどを作成すると、PhpStorm によって名前空間名が自動補完されます。 このディレクトリ内にあります。 ネームスペース名が PSR-0/PSR-4 プロジェクト構造と一致しない場合、IDE はエディターにインスペクション警告を表示します。

名前空間ルートを自動的に検出する

Composer を使用して PSR-0/PSR-4 のオートローディングを管理する場合、プロジェクトを開いたときに composer.json ファイルの内容に基づいて、PhpStorm がディレクトリを Source として自動的にマークします。

プロジェクトに "autoload" セクションを含む composer.json ファイルがない場合、PhpStorm は名前空間を持つファイルを検出し、通知メッセージで名前空間ルートの設定を促します。 名前空間ルートがまだ構成されていない場合、新しいクラスを作成するときに PhpStorm が名前空間ルートを構成するように促します。

メインメニューから コード | PSR-0 名前空間ルートの検出 を選択すると、名前空間ルートの自動検出も実行できます。 開かれる ディレクトリ ダイアログには、プロジェクトルートフォルダー直下のフォルダーが表示され、プロジェクトルートフォルダーは ソース としてマークされ、これがすべての名前空間のルートを意味します。 OK をクリックして設定を適用するか、 手動で名前空間ルートを構成します。

名前空間ルートを手動で構成する

  1. 設定 ダイアログ(Ctrl+Alt+S )で ディレクトリ に移動します。

  2. 開いた ディレクトリ ページの右側のペインには、プロジェクトで構成されたすべての コンテンツルートが表示されます。 原則として、現在のプロジェクトのルートフォルダーであるコンテンツルートが 1 つあります。

    中央ペインには、選択したコンテンツルートにあるすべてのフォルダーが表示されます。 名前空間のルートとして扱うフォルダーを選択し、 ソース をクリックします。

    複数のソースルートを構成しても問題ありません。PhpStorm はそれぞれを名前空間ルートとして扱い、その下のファイルに名前空間のヒントを提供します。 たとえば、ベンダーフォルダーの各サブフォルダーを名前空間ルートとしてマークできます。 以下の例では、実際のアプリケーション用とベンダーフォルダー用の 2 つの名前空間ルートがあります:

    名前空間のルートを構成する
  3. PSR-4(英語) に従ってネームスペース接頭辞を設定するには、関連するソースフォルダー(ネームスペースルート)の横にある the Edit properties button をクリックし、 ルートプロパティの編集 ダイアログで使用する接頭辞を指定します。 自動的に生成されたコードにも接頭辞を適用するには、 生成されたソース用 チェックボックスを選択します。

    名前空間ルートの名前を変更する
2026 年 5 月 22 日