PhpStorm 2016.2 Help

Creating Files from Templates

On this page:

Introduction

PhpStorm provides file templates for most of the languages that it supports. This lets you create the files with the initial content appropriate for the file purpose. For example, there are file templates for HTML/HTML5/XHTML, XML, and JavaScript files, PHP classes and files, XSLT style sheets, and other supported file types.

Generally, the file name extension for a template-based file is set automatically so you don't need to specify it. For example, if you create a JavaScript file, it gets the .js extension. New HTML and XML files get the .html and .xml extensions respectively. New XSLT style sheets get the .xsl extension.

Sometimes, you are given an opportunity to select the desired extension from the list. This, for example, is the case when creating PHP classes.

Creating a new file from a template

To create a new file from a template

  1. Do one of the following:
    • In the Project tool window, select the directory in which you want to create a new file, and then choose File | New on the main menu.
    • Right-click the corresponding directory and select New from the context menu.
    • Press Alt+Insert
  2. Select the desired file type. Generally, all the options except File and Directory correspond to using a file template.
    ps_menu_new

    An existing file template may be missing from the list if this is a custom template whose file name extension (template extension) does not match registered patterns of any of the recognized file types. In such a case, you may want to register the corresponding pattern for an existing recognized file type or add a new file type and register the corresponding pattern for this new type. For more information, see Creating and Registering File Types.

  3. In the dialog that opens, type the name of the file in the corresponding field. Note that you should not type the file name extension.

    You can specify the whole directory structure prepending the new file name. If the nested directories do not yet exist, they will be created:

    new_template_based_file

    If required, specify the kind of the new template-based file. For example, if you select to create a class, you'll be able to create a class, interface, etc. or, in other words, use one of the corresponding related file templates.

    Specify other information as required. For example, you may be asked to define the values of custom variables if the corresponding file template contains such variables and their values are not currently set.

  4. Click OK. The new file that corresponds to the selected file template will be created under the target location.

    If the names of non-existent sub-directories were specified before the new file name, the whole structure will be created under the target directory:

    new_file_with_subdir

Sometimes, you may want to change the auto-generated file name extension. To do that, use the Rename refactoring (Refactor | Rename).

See Also

Last modified: 24 November 2016