PhpStorm 2025.2 Help

Rename dialog for a file

Use this dialog to rename a file.

In addition to renaming the file itself, PhpStorm can also search for usages of its name. If found, the changes that you make to the file name can also be applied to these usages.

The usages are grouped into categories that correspond to options you can enable or disable.

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 enabled, PhpStorm will search for occurrences of the file in references within source code files.

In some languages, string literals are treated as references, while in others they are not.

Search in comments and strings

If this option is enabled, PhpStorm will look for occurrences of the file in comments and string literals in your source code files.

Search in loaded sources

If this option is enabled, PhpStorm will look for occurrences of the file in downloaded object sources.

Preview pane

The statement to be run to rename the table or column. If necessary, you can edit the statement right in this pane.

Refactor

Executes the statement and applies the changes immediately.

Preview

Previews the changes before they are applied.

Search for text occurrences

If this option is enabled, PhpStorm will search for occurrences of the file in non-source files, such as text, properties, HTML, or documentation files.

Scope

Use this option to set the scope for the Rename refactoring. For example, limit it to recently changed files, open files, or a custom scope that can be shared or local.

04 November 2024