Rename dialog for a file
Use this dialog to rename a file.
In addition to renaming the file itself, PhpStorm can also look for the usages of the file name. If found, the changes you are making to the file name can also be applied to these usages.
The usages are assigned to different categories which correspond to the options which you can turn on and off.
Note that regardless of the options selected, the search scope (places where you search for the name occurrences) is always limited to the current entity (for example, a file, or a class) and the entities that the current one depends on.
Item | Description |
|---|---|
Rename <file> and its usages to | Specify a new name for the file. |
Search for references | If this option is on, PhpStorm will look for occurrences of the file name in file references in source code files. Whether or not a string literal is a reference is defined by the (programming) language used in a source file. |
Search in comments and strings | If this checkbox is selected, PhpStorm will look for occurrences of the file name within comments and string literals in your source code files. |
Search in loaded sources | If this checkbox is selected, PhpStorm will look for occurrences of the file name within downloaded object sources. |
SQL Script | The statement to be run to rename the table or column. If necessary, you can edit the statement right in this pane. |
Refactor | Execute the statement and make associated changes right away. |
Preview | Preview potential associated changes prior to executing the statement. |
Search for text occurrences | If this option is on, PhpStorm will look for occurrences of the file name in the files that don't contain source code. These may be the text files, properties files, HTML files, documentation files, and so on. |
Scope | Use this option to set a scope for the Rename refactoring. For example, you can limit the refactoring to only recently changed files, or to only open files, and so on. You can also create a custom scope that you can either share or keep local. |