PhpStorm 2016.2 Help

Configure PHP Remote Interpreter Dialog

File | Settings | Languages and Frameworks | PHP for Windows and Linux
PhpStorm | Preferences | Languages and Frameworks | PHP for OS X
Ctrl+Alt+S

settings

The dialog box is available only when the PHP Remote Interpreter plugin is enabled. The plugin is bundled with PhpStorm and activated by default. If the plugin is not activated, enable it on the Plugins page of the Settings / Preferences Dialog as described in Enabling and Disabling Plugins.

The dialog box opens when you click the Add toolbar button add in the left-hand pane of the Interpreters dialog box and choose Remote... from the drop-down menu.

Use this dialog box to configure access to PHP engines installed on remote hosts or in development environments set up in Vagrant instances.

ItemDescription
SSH Credentials Choose this option to configure access to a PHP interpreter on a remote host through SSH credentials. In the fields of the dialog box, specify the following:
  • Host: in this field, type the name of the host on which the interpreter is installed.
  • Port: in this field, type the port which the SSH server on the remote host listens to. The default port number is 22.
  • User name: in the field, type the user name under which you are registered on the SSH server.
  • Auth type: from this drop-down list, choose the authentication method.
    • To access the host through a password, choose Password from the Auth type drop-down list and type the password.
    • To access the host through a pair of SSH keys, choose Key pair, then specify the path to the file where your private key is stored or the passphrase if you have configured it during the generation of the key pair.

To use an interpreter configuration, you need path mappings that set correspondence between the project folders, the folders on the server to copy project files to, and the URL addresses to access the copied data on the server . PhpStorm first attempts to retrieve path mappings itself by processing all the available application-level configurations. If PhpStorm finds the configurations with the same host as the one specified above, in the Host field, the mappings from these configurations are merged automatically. If no configurations with this host are found, PhpStorm displays an error message informing you that path mappings are note configured.

To fix the problem, open the Deployment page under the Build, Execution, Deployment node, select the server access configuration in question, switch to the Mappings tab, and map local folders to folders on the server as described in Creating a Remote Server Configuration, section Mapping Local Folders to Folders on the Server and the URL Addresses to Access Them.

Vagrant This option is available only when the Vagrant repository plugin is installed and enabled. The plugin is not bundled with PhpStorm, but it can be installed from the JetBrains plugin repository as described in Installing, Updating and Uninstalling Repository Plugins and Enabling and Disabling Plugins.

Choose this option to configure access to a PHP interpreter installed in a Vagrant instance using your Vagrant credentials. Technically, it is the folder where the VagrantFile configuration file for the desired environment is located. Based on this setting, PhpStorm detects the Vagrant host and shows it as a link in the Vagrant Host URL read-only field.

To use an interpreter configuration, you need path mappings that set correspondence between the project folders, the folders on the server to copy project files to, and the URL addresses to access the copied data on the server . PhpStorm evaluates path mappings from the VagrantFile configuration file.

Deployment Configuration This option is available only when the Remote Hosts Access plugin is enabled. The plugin is bundled with PhpStorm and activated by default. If the plugin is not activated, enable it on the Plugins page of the Settings / Preferences Dialog as described in Enabling and Disabling Plugins.

Choose this option to configure access to a PHP interpreter on a remote host using a server access configuration. This option is available only if you have at least one server access configuration of the type SFTP, see Creating a Remote Server Configuration.

From the Deployment Configuration drop-down list, choose the server access configuration of the type SFTP according to which you want PhpStorm to connect to the target host. If the settings specified in the chosen configuration ensure successful connection, PhpStorm displays the URL address of the target host as a link in the Deployment Host URL field.

To use an interpreter configuration, you need path mappings that set correspondence between the project folders, the folders on the server to copy project files to, and the URL addresses to access the copied data on the server . By default, PhpStorm retrieves path mappings from the chosen server access (deployment) configuration. If the configuration does not contain path mappings, PhpStorm displays the corresponding error message.

To fix the problem, open the Deployment page under the Build, Execution, Deployment node, select the relevant server access configuration, switch to the Mappings tab, and map the local folders to the folders on the server as described in Creating a Remote Server Configuration, section Mapping Local Folders to Folders on the Server and the URL Addresses to Access Them.

PHP Interpreter Path In this field, specify the location of the PHP executable file in accordance with the development environment configured on the selected remote host. By default PhpStorm suggests the /usr/bin/php folder. To specify another folder, click the Browse button browseButton and choose the relevant folder in the dialog box that opens. Note that the PHP home directory must be open for edit.

When you click OK, PhpStorm checks whether the PHP executable is actually stored in the specified folder.

  • If no PHP executable is found, PhpStorm displays an error message asking you whether to continue searching or save the interpreter configuration anyway.
  • If the PHP executable is found, you return to the Interpreters where the installation folder and the detected version of the PHP interpreter are displayed.

See Also

Last modified: 2 September 2016