Local History

Restore changes in a file

Let's imagine you made a series of changes to a file since your last commit before you realized you've deleted a meaningful chunk of code. The Undo action can't help you here because that change is too far away, and you'll be forced to discard other changes if you use it.

With PhpStorm you can restore that change in a couple of clicks.

1. Right-click anywhere in the editor and choose Local History | Show History from the context menu.

   In the dialog that opens, the left-hand pane shows a list of all saved revisions of the current file with timestamps. The right-hand pane shows a diff viewer, which displays the differences between each revision and the current state of the file.

2. Do one of the following:

   • To revert the whole file to the state of this revision, right-click it and choose Revert from the context menu or click on the toolbar.

   • To restore a specific code fragment, select the revision that contains that fragment. In the diff view on the right locate the piece of code you want to restore and click the chevron button to copy it from the left pane.

     

Restore changes in multiple files

Similarly to viewing Local History for one file, you can view it for an entire folder, project, or multiple individual files.

1. In the Project tool window Alt+1, right-click the node or select and right-click the files for which you want to see the history and select Local History | Show History.

2. Find the change that you want to revert and click on the toolbar.

   Click on the toolbar to view the changes in the diff viewer. There, use the chevron button to revert the required changes.

Restore deleted files

If you've accidentally deleted a file that was not under version control, you can restore it with Local History.

1. Select the node that contained the file you deleted in the Project tool window Alt+1, right-click it and choose Local History | Show History from the context menu.

2. On the left, select the revision that contains the file you want to restore, right-click that file, and choose Revert Selection.

   

Add labels to specific states

Local History revisions are normally marked with timestamps, which are not easy to navigate. Some revisions are automatically marked with labels based on predefined events: running tests, deploying apps, committing changes, and so on. You can always add a new label to mark the current state of the Local History, for example, right before you start a massive refactoring.

1. Select File | Local History | Put Label from the main menu.

2. In the dialog that opens, type any meaningful name for the label and click OK.

Share Local History

Local History does not support shared access, it is stored locally and intended only for personal use. However, you can create a patch file with changes relative to a specific revision, which you can share with others.

1. Select a revision in the Local History dialog and click Create Patch on the toolbar.

2. In the dialog that opens, specify how you want to create the new patch.

Change Local History retention period

By default, Local History is configured to store revisions for the last 5 working days (that is, days when the file was modified).

1. In the Settings dialog (Ctrl+Alt+S) , go to Advanced Settings.

2. In the IDE section, provide the desired retention period value in the Duration of storing changes in Local History field.

Alternatively, you can pass the localHistory.daysToKeep parameter as a Java property by configuring JVM options. For example, to set retention to 30 days, add the following line to the JVM options file: