PhpStorm 2024.1 ヘルプ

ライブラリとライブラリルート

ライブラリは、プロジェクトでそのまま使用されるサードパーティのファイルまたはファイルのセットです。

PHP ライブラリは、プロジェクト内で Composer によって管理されるのが最も一般的です。これにより、PHP ライブラリは依存関係として宣言され、vendor ディレクトリ内のフォルダーにインストールされます。プロジェクトファイルからライブラリを区別しながら、そのクラスとメソッドを IDE の内部情報に含めるために、PhpStorm はライブラリフォルダーをライブラリルートとしてマークします。詳細については、「PHP ライブラリのルート」を参照してください。

JavaScript ライブラリは、グローバル (IDE) レベルまたはプロジェクトレベルで構成でき、IDE 内でのライブラリの再利用性を定義します。詳細については、Javascript ライブラリの構成を参照してください。

PHP ライブラリのルート

PhpStorm では、ライブラリルートはライブラリファイルを含むフォルダーであり、除外としてマークされ、同時に設定 | PHP | インクルードパスで PHP インクルードパスとして追加されます。PhpStorm は、このルートタイプを次のように扱います。

  • ライブラリはまだインデックスされていますは除外されていますが、これは、ライブラリのクラスとメソッドが自動補完、検索、参照解決などで利用できることを意味しますが、二級国民の原則に基づいています。ライブラリをインデックス作成から完全に除外できます。

  • ライブラリはエラーチェックから除外されます。

  • すべてのライブラリファイルはリーダーモードで開かれ、意図的な直接編集やリファクタリングによる結果の更新などの変更試行時に非プロジェクトファイルの保護ポップアップで保護されます。

    Non-Project Files Protection

プロジェクトツールウィンドウでは、ライブラリルートは色付きの背景のみでマークされます。

Library roots in Project tool window

プロジェクト内のライブラリルートを表示する

  • デフォルトでは、vendor ディレクトリのすべてのフォルダーは、PhpStorm によってライブラリのルートと見なされます。このようなフォルダーは、設定 | PHP | インクルードパスに自動的に追加されます。

    PHP Include Path list
  • プロジェクトツールウィンドウの外部ライブラリノードには、PHP インクルードパスとして手動で追加されたライブラリルートが含まれています。

    External Libraries in Project tool window

    プロジェクトに Composer 管理ライブラリのみが含まれている場合、外部ライブラリをダブルクリックすると、設定 | PHP | インクルードパスのライブラリルートのリストが開きます。

ライブラリをインデックスから除外する

vendor ディレクトリ内の特定のフォルダーをインデックス作成から除外できます。これを行うには、設定 | PHP | インクルードパスリストでフォルダーを選択し、ツールパネルで 除外をクリックします。

これにより、選択したフォルダーまたはファイルがインクルードパスから除外され、そのルートタイプライブラリ (the Content root icon) から Excluded () に変更されます。

PHP exclude files from indexing

    Composer 以外に、次の方法でサードパーティのツールまたはフレームワークをプロジェクトのライブラリとして使用できます。

    どちらの場合でも、展開されアーカイブされたツールソースを使用できます。PhpStorm は、最も一般的な zip および TAR.GZ フォーマット、および PHP ネイティブ PHAR(英語) フォーマットを認識します。

    関連ページ:

    プロジェクトの作成と管理

    PhpStorm で何かを行う場合、プロジェクトのコンテキスト内で行うことになります。プロジェクトは、完全なソフトウェアソリューションを表す組織単位です。これは、コーディング支援、一括リファクタリング、コーディングスタイルの一貫性などの基盤として機能します。PhpStorm のプロジェクトはディレクトリベースのフォーマットに表示されます。ルートプロジェクトディレクトリには、.idea ディレクトリと次のファイルが含まれています。プロジェクト構造を記述する .iml ファイル。ワークスペース設定を含む w...

    Composer 依存関係マネージャー

    PhpStorm は Composer 依存関係マネージャーと統合されています。これにより、Packagist またはカスタムリポジトリからのパッケージをプロジェクトの依存関係として宣言し、IDE から管理できます。PhpStorm は以下を提供します。一般的な Composer コマンド (init、install、update、および多数の追加 Composer コマンド) を実行するための専用ユーザーインターフェース。コマンド出力は Composer ログコンソールに表示されます。PhpStorm...

    JavaScript ライブラリを構成する

    言語と IDE のコンテキストでは、ライブラリはファイルまたはファイルのセットです。これらのファイルの関数とメソッドは、編集したプロジェクトコードから PhpStorm が取得する関数とメソッドに加えて、PhpStorm の内部知識に追加されます。プロジェクトのスコープでは、そのライブラリはデフォルトで書き込み保護されています。PhpStorm は、2 つの事前定義された自動生成ライブラリフォルダーを予約します。node_modules プロジェクト package.json のオブジェクトにリストさ...

    インデックス作成

    PhpStorm のインデックス作成は、IDE のコア機能であるコード補完、インスペクション、使用箇所の検索、ナビゲーション、構文のハイライト、リファクタリングを担当します。プロジェクトを開いたとき、ブランチを切り替えたとき、プラグインをロードまたはアンロードした後、大規模な外部ファイルの更新後に開始されます。例: これは、プロジェクトのビルド後にプロジェクト内の複数のファイルが作成または生成された場合に発生する可能性があります。インデックス作成では、プロジェクトのコードを調べて、アプリケーショ...

    リーダーモード

    このページを使用して、読み取り専用ファイルおよびライブラリにコードとコメントを表示し、読みやすく、理解しやすくする方法を構成します。例: インレイヒント、フォントの合字、行の高さの調整などを有効にできます。リーダーモードを有効化するこのチェックボックスを使用して、オプションを有効または無効にします。次のオプションを使用して、リーダーモードで表示する方法と内容を構成します。レンダリングされたドキュメントコメント: 読み取り専用ファイルの読み取り中にコメントを通常のテキストとして表示するには、このオ...

    コンテンツルート

    PhpStorm では、コンテンツは現在作業しているファイルのコレクションであり、場合によってはサブフォルダーの階層に編成されています。この階層の最上位にあるフォルダーは、コンテンツルートフォルダー (略してコンテンツルート) と呼ばれます。プロジェクトには少なくとも 1 つのコンテンツルートフォルダーがあり、デフォルトではプロジェクトフォルダーそのものです。コンテンツルートを追加いくつかのコンテンツルートを持つことで、共通の直系親を持たない複数のディレクトリからのファイルを扱うことができます。これ...