PhpStorm 2023.3 Help

Use distributed configuration files (.htaccess)

PhpStorm provides syntax highlighting, formatting, code completion and documentation lookup while editing distributed configuration files.

Distributed configuration files are used to make directory-based changes to the HTTP Apache Server configuration and usually have the name .htaccess.

If you are using a file with the name .htaccess, PhpStorm recognizes it as distributed configuration file and provides full coding assistance for it, so no additional steps are required from your side.

If you want to use a file with another name, you need to associate this full name or the corresponding pattern with the distributed configuration file type. After that, PhpStorm will treat any file with the name matching the specified pattern as a distributed configuration file and process it accordingly.

Enable the Apache config (.htaccess) plugin

This functionality relies on the Apache config (.htaccess) plugin, which is bundled and enabled in PhpStorm by default. If the relevant features aren't available, make sure that you didn't disable the plugin.

  1. Press Ctrl+Alt+S to open the IDE settings and then select Plugins.

  2. Open the Installed tab, find the Apache config (.htaccess) plugin, and select the checkbox next to the plugin name.

Associate a name pattern with the distributed configuration file type

  1. In the Settings dialog (Ctrl+Alt+S) , and select Editor | File Types.

  2. Select Apache Config from the Recognized File Types list.

  3. In the File name patterns area, click the Add button.

  4. In the Add Wildcard dialog that opens, specify the pattern that defines the extensions of your distributed configuration files.

  5. Click OK. PhpStorm returns you to the File Types page where the specified pattern is added to the File name patterns list.

    • To discard a pattern, select it in the list and click the Remove button.

    • To change a pattern, select it in the list, click the Edit button, and update the pattern as necessary in the Add Wildcard dialog that opens.

Last modified: 25 March 2024