ローカル履歴

ローカル履歴は、バージョン管理とは関係なく、プロジェクトに加えられたすべての変更を常に追跡できます。

コミット間で行われた違いのみを追跡するバージョン管理システムとは異なり、ローカル履歴にはさらに多くの機能があります。コードの編集、テストの実行、アプリケーションのデプロイなどを行うと、プロジェクトの状態が自動的に記録され、IDE と外部の両方から行われたすべての意味のある変更のリビジョンが維持されます。

ローカル履歴は個人用バージョン管理システムとして機能し、削除されたファイルを復元したり、個別の変更を戻したり、バージョン管理がまだ有効化されていないプロジェクトや、最後のコミット後に不要な変更が加えられた場合でもファイルを任意の状態にロールバックできます。アクションを起こす前にコンピューターが予期せず再起動した場合の復元ソースとしても利用できます。

ファイルの変更を復元する

最後のコミット以降、意図せず意味のあるコードの一部を削除したことに気付くまでファイルに一連の変更を加えていたとしましょう。その変更は離れすぎており、元に戻すアクションでは対応できません。また、使うと他の変更を破棄することになります。

PhpStorm を使えば、数回クリックするだけでその変更を復元できます。

エディターの任意の場所を右クリックし、コンテキストメニューからローカル履歴 | 履歴の表示を選択します。
開いたダイアログの左側のペインには、現在のファイルの保存されているすべてのリビジョンのリストがタイムスタンプとともに表示されます。右側のペインには差分ビューアーが表示され、各リビジョンとファイルの現在の状態との違いが表示されます。
次のいずれかを実行します：
- ファイル全体をこのリビジョンの状態に戻すには、ファイルを右クリックしてコンテキストメニューから選択範囲とその後の変更を元に戻すを選択するか、ツールバーのをクリックします。
- 特定のコードフラグメントを復元するには、そのフラグメントを含むリビジョンを選択します。右側の差分ビューで、復元するコード部分を見つけて山形ボタンをクリックして、左側のペインからコードをコピーします。

複数のファイルの変更を復元する

1 つのファイルのローカル履歴の表示と同様に、フォルダー全体やプロジェクト、複数の個別ファイルについても表示できます。

プロジェクトツールウィンドウ（Alt+1 ）で、履歴を表示したいノードを右クリックするか、ファイルを選択して右クリックし、ローカル履歴 | 履歴の表示を選択します。
元に戻す変更を見つけて、ツールバーのをクリックします。
ツールバーのをクリックして、差分ビューアーで変更を表示します。そこで山形ボタンを使用して、必要な変更を元に戻します。

削除されたファイルを復元する

バージョン管理されていないファイルを誤って削除した場合は、ローカル履歴を使って復元できます。

プロジェクトツールウィンドウ（Alt+1 ）で削除したファイルが含まれていたノードを選択し、右クリックしてコンテキストメニューからローカル履歴 | 履歴の表示を選択します。
左側で、復元するファイルが含まれているリビジョンを選択し、そのファイルを右クリックして、選択範囲を元に戻すを選択します。

特定の状態にラベルを追加する

通常、ローカル履歴のリビジョンにはタイムスタンプが付けられているため、移動するのは簡単ではありません。一部のリビジョンは、事前定義されたイベント (テストの実行、アプリのデプロイ、変更のコミットなど) に基づいてラベルで自動的にマークされます。たとえば、大規模なリファクタリングを開始する直前に、いつでも新しいラベルを追加して、ローカル履歴の現在の状態をマークできます。

メインメニューからファイル | ローカル履歴 | ラベルを付けるを選択します。
開いたダイアログで、ラベルに意味のある名前を入力し、 OK をクリックします。

ローカル履歴は共有アクセスをサポートしていないため、ローカルに保存され、個人利用のみを目的としています。ただし、特定のリビジョンとの変更差分でパッチファイルを作成し、他のユーザーと共有できます。

「ローカル履歴」ダイアログでリビジョンを選択し、ツールバーの「パッチの作成」をクリックします。
開いたダイアログで、新しいパッチの作成方法を指定します。