PhpStorm 2018.3ヘルプ

Gitリポジトリを設定する

リモートホストからプロジェクトをチェックアウトする (クローン)

PhpStormでは、既存のリポジトリを(Gitという用語ではクローンで)チェックアウトし、ダウンロードしたデータに基づいて新しいプロジェクトを作成することができます。

  1. メインメニューからVCS | バージョン管理からチェックアウト | Gitを選択するか、現在プロジェクトが開いていない場合は、ようこそ画面でバージョン管理からチェックアウト | Gitを選択します。

  2. リポジトリーのクローンダイアログで、複製するリモートリポジトリのURLを指定します(テストをクリックして、リモートとの接続が確立されていることを確認できます)。

  3. ディレクトリーフィールドに、ローカルのGitリポジトリ用のフォルダーを作成してリモートリポジトリを複製するパスを指定します。

  4. クローンをクリックしてください。複製したソースに基づいてPhpStormプロジェクトを作成したい場合は、確認ダイアログで[ はい ]をクリックします。Gitのルートマッピングは自動的にプロジェクトのルートディレクトリーに設定されます。

既存のプロジェクトをGitのバージョン管理下に置く

リモートリポジトリのクローンとは別に、既存のプロジェクトのソースに基づいてローカルリポジトリを作成することができます。

プロジェクト全体を1つのGitリポジトリにインポートする

  1. Gitの中に入れたいプロジェクトを開きます。

  2. メインメニューからVCS | バージョン管理統合を使用可能にするを選択します。

  3. 表示されるダイアログで、ドロップダウンリストからGitを選択し、OKをクリックします。

異なるプロジェクトモジュールを異なるGitリポジトリにインポートする

  1. Gitの中に入れたいプロジェクトを開きます。

  2. メインメニューからVCS | バージョン管理へインポート | Git リポジトリーの作成を選択します。

  3. 表示されたダイアログで、新しいGitリポジトリを作成するディレクトリーを指定します。

ローカルリポジトリにファイルを追加する

プロジェクト用のGitリポジトリ初期化した後、プロジェクトデータを追加する必要があります。

バージョン管理ツールウィンドウ(Alt+9)を開き、ローカルの変更タブに切り替えます。
  • Ctrl+Alt+A を押すか、コンテキストメニューからVCS へ追加を選択して、バージョン管理下のバージョン管理外のファイルチェンジリストにファイルを置きます。チェンジリスト全体を追加するか、別のファイルを選択することができます。

プロジェクトのGit統合を有効にしている場合、PhpStormは、新しく作成された各ファイルをGitのバージョン管理下に追加することを提案します(この動作はバージョン管理 | 確認設定ダイアログ(Ctrl+Alt+S)で変更できます)。特定のファイルを常にバージョン管理されないままにしたい場合は、それらを無視するようにGitを設定することができます。

バージョンコントロールからファイルを除外する (無視)

場合によっては、特定の種類のファイルをバージョン管理外にしておく必要があるかもしれません。これらは、VCS管理ファイル、ユーティリティの成果物、バックアップコピーなどです。

PhpStormを通してファイルを無視することができ、IDEはそれらをGitに追加することを示唆せず、それらを無視して強調表示します。しかし、これはIDE側で行われるため、Gitはそのようなファイルをバージョン管理外として扱います。したがって、PhpStorm以外の操作を実行する必要がある場合やプロジェクトを共有する場合は、無視するファイルのリストを gitignore ファイル(手順については、https://git-scm.com/docs/gitignore(英語)を参照)。

Gitで無視されるファイルのリストを設定する

  1. どちらか:
    • 設定/環境設定ダイアログ(Ctrl+Alt+S)で、左ペインでバージョン管理 | 無視されるファイルを選択します。

    • バージョン管理ツールウィンドウ(Alt+9)を開き、ローカルの変更タブに切り替えます。ツールバーの eye icon をクリックし、無視するファイルの構成を選択します。

  2. ツールバーの追加 add ボタンをクリックします。

  3. バージョン管理されていないファイルの無視ダイアログで、無視するファイル/ディレクトリーを指定するか、ファイル名パターンを定義します。
    • 指定したファイルを無視する : プロジェクトルートに関連するファイル名を指定します。

    • 配下のすべてのファイルを無視する : プロジェクトのルートを基準にして内容を無視するディレクトリーを指定します。ルールはすべてのサブディレクトリーに再帰的に適用されます。

    • 一致するすべてのファイルを無視する : 無視するファイルの名前を定義するパターンを入力します。このルールは、プロジェクトルートにあるすべてのディレクトリーに適用されます。

      2文字をワイルドカードとして使用できます。

      • * : 任意の文字列を置き換えます。

      • ? : 単一の文字を置き換える。

      例: *.iml は、 iml 拡張子を持つすべてのファイルを無視します。 *.?ml は、拡張子が mlで終わるすべてのファイルを無視します。

プロジェクトの確認

PhpStormを使用すると、プロジェクトのリポジトリバージョンと比較してローカル作業コピーのステータスを確認できます。どのファイルが変更されたか、VCSに追加された新しいファイル、Gitで追跡されていないファイルを確認することができます。

バージョン管理ツールウィンドウ(Alt+9)を開き、ローカルの変更タブに切り替えます:

file status

  • デフォルトチェンジリストには、リモートリポジトリ(青色で強調表示されている)と最後に同期された後に変更されたすべてのファイルと、VCSに追加されていますがまだコミットされていない(緑色で強調表示されている)

  • バージョン管理外のファイルチェンジリストには、プロジェクトに追加されたが、Gitによって追跡されていないすべてのファイルが表示されます。

マージ中に解決されなかったコンフリクトがあった場合、競合をマージするノードは対応するチェンジリストにリンクを表示して解決されます。

unmerged conflicts

チェンジリストの詳細については、異なるチェンジリストにグループを変更するを参照してください。

エディターでファイルへの変更を追跡する

また、エディターでファイルを変更したときのファイルの変更を追跡することもできます。すべての変更は、変更された行の隣の左のガターに表示されるマーカーを変更するで強調表示され、最後にリポジトリと同期した後に導入された変更のタイプを示します。リポジトリの変更をコミットすると、変更マーカーが消えます。

テキストに加えた変更は色分けされています:

  • lineAddedMarker ラインが追加されました。

  • lineChangededMarker 行が変更されました。

行を削除すると、左の樋に次のマーカーが表示されます: deleted line marker

変更マーカー上にマウスカーソルを置いてクリックすると表示されるツールバーを使用して変更を管理できます。ツールバーは、変更された行の前の内容を示すフレームとともに表示されます。

changeMarkerToolbar

icons actions rollback svg をクリックして変更をロールバックすることができます(現在の行だけでなく、最後のリビジョン以降のファイルに対する変更はすべて元に戻ります)。 icons actions diff svgをクリックすると、現在の行と現在の行のリポジトリバージョンの違いを調べることができます。

リモートリポジトリを追加する

Gitプロジェクトでコラボレーションできるようにするには、データをフェッチして作業を共有する必要があるときに押す リモートリポジトリを設定する必要があります。

例えばGitHubなどのリモート Gitリポジトリをクローンした場合、リモートは自動的に設定され、同期するとき(つまりプルまたはプッシュ操作を実行するとき)にリモートを指定する必要はありません。

ただし、ローカルソースに基づいてGitリポジトリ作成した場合は、他のコントリビュータが変更をプッシュできるように、また作業結果を共有できるようにリモートリポジトリを追加する必要があります。

  1. メインメニューからVCS | Git | プッシュを選択してコミットをプッシュする準備ができたら、プッシュダイアログを起動するか、 Ctrl+Shift+Kを押します。

  2. 表示されるダイアログで、リモートの名前とホストするURLを指定し、OKをクリックします。

場合によっては、2番目のリモートリポジトリも追加する必要があります。これは、たとえば、書き込みアクセス権のないリポジトリをクローンし、元のプロジェクトの独自のフォークに変更をプッシュする場合などに便利です。別の一般的なシナリオは、他の誰かのプロジェクトフォークである独自のリポジトリをクローンし、元のプロジェクトと同期して、そこから変更をフェッチする必要があるということです。この場合:

  1. メインメニューからVCS | Git | リモートを選択します。Git リモートダイアログが開きます。

  2. ツールバーの追加 add ボタンをクリックするか、 Alt+Insertを押してください。

  3. 表示されたダイアログで、リモートの名前とURLを指定し、OKをクリックします。

このビデオからさらに詳しく学ぶ:


リモートを編集するには(たとえば、複製した元のプロジェクトの名前を変更する)、Git リモートダイアログでリモートを選択し、ツールバーの編集 edit ボタンをクリックするか、 Enterを押します。

無効になったリポジトリを削除するには、Git リモートダイアログでそのリポジトリを選択し、ツールバーの除去 remove ボタンをクリックするか、 Alt+Deleteを押します。

最終更新日: 2019年2月15日