Defining the Default Run Configuration

See Also

Run configurations accommodate the most commonly used PHP development use cases. A run configuration is a stored setting for running a PHP project. You can define several configurations for one project and switch between them back and forth. Run configurations apply to both running and debugging.

Note: During the project creation, the default run configuration is defined. To define additional run configuration, customize your project setup.

To set the default run configuration for your project, choose the relevant option from the Run As dropdown list. The following options are available:

Local Web Site

From the Run As dropdown list, choose Local Web Site. The further procedure depends on the type of your project.

Project without Previously Developed Sources

  1. In the Project URL field, check the automatically generated URL address. Make sure that the Apache HTTP server listens to the default port 80. If not, specify the port number explicitly:
    localhost:<port number>
                    
  2. To have a separate storage for the project's source files, select the Copy files from Sources Folder to another location checkbox.
  3. In the Copy to Folder field, specify the storage location.

Project with Previously Developed Sources

  1. Select the Copy files from Sources Folder to another location checkbox.
  2. In the Copy to Folder field, specify the folder on your web server where you want to store your source files. Use the Browse button, if necessary.
    The field by default specifies the following path: <Document Root>\<New PHP Project>.
    The document root is the folder where the web server looks for files to open in the browser. The document root is specified in the web server configuration file.
    The wizard detects the and provides the path to the default location of the htdocs folder. If you accepted the default settings during the installation of the Apache server or the AMP package, choose the relevant path from the dropdown list.
  3. In the Project URL field, check the automatically generated URL address. Make sure that the Apache HTTP server listens to the default port 80. If not, specify the port number explicitly:
    localhost:<port number>
                    

If you are using Remote Debugging or Symbolic Links, click Advanced and set up path mapping. See Path Mapping.

Remote Web Site

  1. From Run As dropdown list, choose Remote Web Site (FTP/SFTP).
  2. From the Remote Connection dropdown list, choose the relevant connection profile.
  3. To create, update, or remove an (S)FTP Connection profile, click Manage. The Manage Remote Connections dialog box opens with the fields showing the current (S)FTP connection profile settings. (If there are no existing connection profiles, the Create New Connection dialog opens automatically when you click Manage.)
  4. To create a new (S)FTP connection profile, click Add. The Create New Connection dialog box opens.
  5. In the Connection Name field, enter the name of the new connection and click OK. The Manage Remote Connections dialog box displays with the name of the new connection in the Connection Name display field.
  6. From the Type dropdown list, choose FTP or SFTP.
  7. In the Host Name field, enter the (S)FTP Server name as it is written in the (S)FTP account creation confirmation message.
  8. In the Port field, specify 21 for an FTP and 22 for an SFTP connection.
  9. In the User Name field, enter your FTP Username as it is written in the (S)FTP account creation confirmation message.
  10. Fill in the Password field.
  11. In the Initial Directory field, enter the name of your account directory on the (S)FTP server and click OK. You return to the Run Configuration panel.
  12. In the Upload Directory field, enter the name of the subfolder in the initial directory where the source files will be uploaded. The prompt below the field shows the FTP host URL.
  13. To specify when the files will be uploaded, choose the relevant option from the Upload Files dropdown list. The available options are: Manually, On Save, and On Run.
  14. You also have the options to Preserve Remote File Permissions or Upload Files Directly.

If you are using Remote Debugging or Symbolic Links, click Advanced and set up path mapping. See Path Mapping.

Script

  1. From the Run As dropdown list, choose Script.
  2. To specify the location of the PHP engine, click the Configure button next to the PHP Interpreter field. The Options dialog box, tab PHP opens.
  3. In the PHP 5 Interpreter field, specify the path to the php.exe file. Use the Browse button, if necessary.
  4. To specify how the script execution results will be shown, select the relevant checkbox in the Open Result In area. The following options are available:

  5. Click OK. The Options dialog box closes and the system returns to the Run Configuration panel.

Path Mapping

If you are using Remote Debugging or Symbolic Links, you need to manually define path mapping for individual run configurations. To define path mapping:

  1. In the Run Configuration panel, click Advanced (not available for Script configurations). The Advanced Web Configuration dialog opens.
  2. Select the debug URL:
    • The default URL, as shown in the panel
    • Ask Every Time, which prompts you for the URL every time you start a debugging session
    • Do Not Open Browser, which starts the debug session without opening a browser window. You need to open your web browser and browse for the URL. Note that the GET (or POST) variable XDEBUG_SESSION_START is needed.
  3. Click New to add a mapping. Enter the server path and the project path.
  4. If you are using the Debugger Proxy, enter the host name and port.
See Also
New PHP Project without Previously Developed Sources
Importing Previously Developed Source Files into a New Project

Legal Notices