PhpStorm 2021.2 Help

File type associations

For language-specific features (such as syntax highlighting and code analysis) in files representing different languages and technologies, PhpStorm maintains a list of file types, each of which links a language or technology with one or more filename patterns.

The default list of file types covers all of the relevant filename patterns, but you can add new file types for your custom language files and change the associated filename patterns for existing file types.

When you open a file in the editor, PhpStorm chooses the file type and the corresponding language service according to the filename pattern. If the filename doesn't match any of the patterns registered for file types, PhpStorm helps to associate the filename pattern with a specific file type.

Apart from that, you can make PhpStorm the default application for opening specific file types from the file manager on your operating system.

Add a new file type

If you work on a language that is not supported by default and there are no plugins for it, you can configure a simple language service for file types associated with this language — you will enjoy syntax highlighting for keywords, comments, and braces and have some basic editor helpers such as comment with line/block comments Ctrl+// Ctrl+Shift+/ and extend/shrink selection according to the structure Ctrl+W/ Ctrl+Shift+W.

  1. Press Ctrl+Alt+S to open the IDE settings and select Editor | File Types.
  2. In the Recognized File Types section, click the Add button, specify the name of the new type, and provide a description.

  3. In the Syntax Highlighting section, configure case sensitivity, brace matching settings, and specify ways of defining comments:

    • Line comment: specify characters that indicate the beginning of a single-line comment.

    • Only at line start: characters that indicate the beginning of a line comment are recognized as a comment if they are located in the beginning of a line.

    • Block comment start, Block comment end: specify characters that indicate the beginning and the end of a block comment.

    • Hex prefix: specify characters that indicate that the subsequent value is a hexadecimal number (for example, 0x).

    • Number postfixes: specify characters that indicate which numeric system or unit is used. A postfix is a trailing string of characters (for example, e-3, kg).

    • Support paired braces, Support paired brackets, Support paired parens, Support string escapes: select these checkboxes to highlight paired braces, brackets, parentheses, and string escapes.

  4. In the Keywords section, you can specify up to four lists of keywords. Keywords of each list will be highlighted differently in the editor and will be auto-completed.

  5. The Ignore case checkbox indicates whether the language in files of the custom format is case-sensitive.

    Creating a new file type

Associate a filename pattern with specific file type

If PhpStorm cannot identify the type of the file that you are trying to open or create, it shows you the Register New File Type Association dialog where you can choose the way you want to process this file.

PhpStorm: Associating a filename pattern with specific file type

If the dialog doesn't appear automatically, right-click the necessary file in the Project tool window and select Associate with File Type from the context menu. Alternatively, select the file in the Project tool window and go to File | File Properties | Associate with File Type.

  1. In the Register New File Type Association dialog, select the necessary options:

  2. From the File pattern list, select whether you want to specify a type for the current file (file.extension) or for all files with this extension (*.extension).

  3. Select one of the following options:

    • Open matching files as text and auto-detect file type by content: open the file without an extension as a text file and identify its type by the content, for example, by the shebang line.

    • Open matching files in PhpStorm: associate the file with one of the existing file types. You can change this association later in the settings.

    • Open matching files in associated application: open the file in the default application. For example, PDF files are opened in the default PDF viewer. The default application is configured in your system systems.

  4. Click OK to apply the settings.

Change file type associations

Change association between file type and related filename patterns

  1. Press Ctrl+Alt+S to open the IDE settings and select Editor | File Types.
  2. From the Recognized File Types list, select the file type that you want to associate with other filename patterns.

  3. Use the File name patterns section to make the necessary changes. You can add a new pattern (the Add button), remove an existing one (the Remove button), or modify an existing pattern (the Edit button).

    PhpStorm: Change association between file type and related filename patterns

If a file is correctly associated with a specific file type by its filename pattern, but you want to process this file differently, you can override the file type association for this file only — other files matching that pattern will not be affected.

Override file type for specific file

  1. In the Project tool window (Alt+1), select one or more files that should have another file type association , right-click the selection and choose Override File Type.

  2. From the list that opens, select a new file type.

Make PhpStorm the default app for specific file types

You can make PhpStorm the default application for opening specific file types from the default file manager on your operating system.

  1. Press Ctrl+Alt+S to open the IDE settings and select Editor | File Types.
  2. Click Associate File Types with PhpStorm and select the file extensions you want to open with the IDE.

    PhpStorm: Associating file types with the IDE
  3. Click OK and close the dialog.

    If you're using macOS, restart your computer to apply the changes.

Ignore files and folders

PhpStorm also maintains a list of files and folders that are completely excluded from any kind of processing. Out of the box, this list includes temporary files, service files related to version control systems, and so on:

*.pyc;*.pyo;*.rbc;*.yarb;*~;.DS_Store;.git;.hg;.svn;CVS;__pycache__;_svn;vssver.scc;vssver2.scc;

Modify the list of ignored files and folders

  1. Press Ctrl+Alt+S to open the IDE settings and select Editor | File Types.
  2. Switch to the Ignored Files and Folders tab.

    You can add a new extension (the Add button), remove an existing one (the Remove button), or modify an existing extension (the Edit button).

  3. Apply the changes and close the dialog.

Configure shebang commands for file types

PhpStorm can recognize file types by the path specified on the shebang line. A shebang is a combination of characters in a script file followed by a path to the interpreter program that should execute this script. It starts with #! and it's always located on the first line of a script file.

  1. Press Ctrl+Alt+S to open the IDE settings and select Editor | File Types.
  2. From the Recognized File Types list, select the file type for which you want to configure a command.

  3. In the HashBang patterns area, click the Add button (Add HashBang Pattern).

  4. In the dialog that opens, specify the path to the interpreter program and click OK.

  5. Apply the changes and close the dialog.

    Configuring a shebang command for Perl
Last modified: 12 October 2021