受信した GitHub プルリクエストを確認する
プルリクエストは、オープンソースプロジェクトや一部の企業のワークフローで、コントリビューターによる変更を管理したり、これらの変更がマージされる前にコードレビューを開始したりするために利用されます。
同僚やコントリビューターからコード変更のレビュー依頼を受けることがあります。 プルリクエストのレビュー担当者は、PhpStorm で直接フィードバックを提供できます：
プルリクエスト ツールウィンドウの 保留中のレビューリクエストを選択します。
受信プルリクエストを管理する
プロジェクトのメンテナーであり、プロジェクトに GitHub リモートが設定されている場合、PhpStorm から受信したプルリクエストを直接表示および管理できます。
プルリクエスト ツールウィンドウを開くには、メインメニューで を選択します。
プルリクエスト ツールウィンドウでは、次の操作を実行できます。
状態別、作成者別、ラベル別、担当者別、レビューステータス別の リクエストのフィルター。
プルリクエストをアクティビティ ステータス（最新、最古、コメントが最も多い、または最も少ない、最近更新された、または最も古い）で 並べ替えます。
GitHub でプルリクエストに移動する: プルリクエストを選択して、コンテキストメニューから ブラウザーでプルリクエストを表示する。 を選択します。
リストからプルリクエストをダブルクリックすると、概要とタイムラインのタブが表示されます。
このビューでは、次の操作を実行できます。
選択したプルリクエストの タイムラインを見るを実行して、その進行状況を追跡します。
特定のコミットを選択するを使用して変更のリストをフィルタリングします。
受信した変更に基づく ローカルブランチの作成: プルリクエストを開き、受信した変更を含むブランチをクリックして、コンテキストメニューで 「ブランチ名」をチェックアウト を選択します。
その他のオプションについては、 プルリクエストを確認する を参照してください。
プルリクエストを確認する
注意が必要な変更がある場合、 プルリクエスト ツールウィンドウに白い点が表示され、表示されていないプルリクエストには青い点が表示されます。
メインメニューで へ移動します。
プルリクエストのリストで、操作したいものを選択してダブルクリックします。
PhpStorm で、選択したプルリクエストの概要が表示されます。
タイトルの横にプルリクエスト番号があります。 GitHub でプルリクエストを開きたい場合は、それをクリックします。
タイムラインの表示。 をクリックすると、プルリクエストの進行状況とプルリクエスト全体に関する概要コメントを表示する新しいタブが開きます。
変更されたファイルのリストをフィルタリングするには、 からの変更点 で調査するコミットを選択します。
任意のファイルを右クリックして、そのファイルのコンテキストメニューを開きます。
コメントや提案がある場合は、ファイルリストにコメントの数を示すカウンターが表示されます。
レビューを開始するには、変更が加えられたブランチをクリックし、コンテキストメニューで 「ブランチ名」をチェックアウト を選択します。
ブランチをチェックアウトすると、受信した変更をテストし、その動作を確認するための完全なコンテキストが得られます。
チェックアウトが成功すると、PhpStorm は レビューモードを開始します。 つまり、ハイライト表示された変更とコメントは、Diff タブ (Ctrl+D) だけでなく、エディター (F4) でも確認できます。
調査するファイルを選択し、右クリックしてコンテキストメニューから ソースに移動 F4 を選択します。
開いたファイルのガター内のピンクのマーカーは、レビュー可能な変更とコメントを示します。
ガター内のコメントアイコンをクリックすると、コメントが非表示や表示状態に切り替わります。
ピンクのマーカーをクリックすると、元のコードを表示するポップアップが現れます。
ガターの上にマウスを移動し、
をクリックしてコメントを残します。
すぐにコメントを投稿し、他のレビュー担当者に通知するには、 単一コメントの追加 を選択してください。
複数のコメントを追加するには、 レビューの開始 を選択します。
レビューを送信する前に、コメントは 保留 としてマークされ、編集または削除できます。
複数の行にコメントするには、
をクリックして青い枠線をドラッグして目的の範囲を覆うか、最初にテキストを選択してから をクリックします。提案については、言語として
suggestionを指定して、Markdown コードブロックでラップされたコードのバージョンを追加してください。```suggestion Your suggestion for this code line ```上部ツールバーの
/
を使うか、 Ctrl+Alt+Up/Ctrl+Alt+Down を押して、コメント間を移動します。レビューを終了する準備ができたら、プルリクエストの概要で 送信 をクリックします。
または、VCS ウィジェットを開いて レビューの送信 をクリックします。
考えられる結果の 1 つを選択します：
承認する: マージする変更を承認します。
変更のリクエスト: フィードバックを送信するには、プルリクエストの作成者は、マージする前に提案された変更を適用する必要があります。
コメント: 承認なしにコメントを送信すること。
受信したプルリクエストをマージまたはクローズする
リポジトリへのプッシュアクセス権がある場合は、レビューを送信してすべての問題を解決した後、プルリクエストをマージまたはクローズできます。
メインメニューで へ移動します。
プルリクエストのリストで、操作したいものを選択してダブルクリックします。
概要の下部には、レビュープロセスの段階とプッシュアクセス権に応じて異なるマージオプションのボタンがあります。
レビュー後に更新を承認した場合は、 マージします をクリックしてプルリクエストをマージできます。
その他のマージオプションについては、
をクリックし、 スカッシュとマージ を選択して変更を含むコミットを 1 つにまとめ、その後マージするか、 リベース を選択してプルリクエストブランチからのコミットをリベースし、ベースブランチに追加します。
詳細 をクリックし、このプルリクエストについて別の意見が必要な場合は レビューのリクエスト を選択し、マージしない場合は プルリクエストを閉じる を選択します。レビューを送信せずにプルリクエストをマージする準備ができたら、プルリクエストの概要で
をクリックし、 マージします、 スカッシュとマージ 、または リベース を選択します。
プルリクエストがマージされたら、プルリクエストのタイムラインが表示されているタブで、マージされたブランチを削除できます。
必要に応じて、削除後に同じタイムラインビューに表示されるブラウザーリンクを使用して、削除したブランチを復元できます。