PhpStorm 2016.2 Help

PHP Built-In Web Server

On this page:

Introduction

Starting with version 5.4.0, PHP interpreters incorporate a Web server functionality. As soon as your project root folder or any other folder is declared the built-in Web server document root, all the files under this folder are submitted to the PHP interpreter for processing. All you need, is enable the built-in Web server in your project, create a run configuration of the type PHP Built-in Web server, and launch the application with this configuration.

Integration with the built-in Web server is supported PhpStorm 4.0 and higher.

Enabling a built-in Web server

  1. Download PHP 5.4.0 or higher.
  2. Register the downloaded PHP interpreter in PhpStorm.
  3. Open your project.
  4. Appoint the PHP 5.4.0 interpreter configuration for use in the project.

Creating a run configuration of the type PHP Built-in Server

  1. Open the Run/Debug Configuration dialog box by doing one of the following:
    • On the main menu, choose Run | Edit Configurations.
    • Press Shift+Alt+F10, then press 0 to display the Edit Configuration dialog box or select the configuration from the pop-up window and press F4.
  2. Click add.png on the toolbar or press Insert. From the drop-down list, select the PHP Built-in Web Server configuration type. The PHP Built-in Web Server dialog box opens.
  3. Specify the configuration name.
  4. Specify the server connection settings:
    1. In the Host text box, type localhost.
    2. Use the Port spin box to specify the number of the port where the built-in web server runs. The port number should be set to 1024 or higher. By default this port is set to the default PhpStorm port through which PhpStorm accepts connections from services (63342).
  5. Specify the folder that will be considered server document root. The folders that are under this document root in the project tree will be submitted to the PHP interpreter. The server document root folder will be accessed through HTTP at the above specified host:port.

    In the Document root text box, specify the path to the relevant folder. This can be the project root or any other folder under it.

    Optionally, customize the run configuration:

    • To have a specific script always executed upon the server start-up, select the Use router script check box and specify the path to the script in the text box.
    • To customize the behavior of the current PHP interpreter, in the Command Line area specify the options and arguments to be passed to the PHP executable file.

Running a PHP application on a built-in Web server

  1. Run the application. To do that, select the built-in Web server run configuration from the Run/Debug Configuration drop-down list on the main tool bar, and then click the Run button eun.png.
  2. Launch the browser of your choice and open the starting page of your application by typing its URL address in the following format:
    http://localhost:<port>/<path to the required file relative to the server document root>

See Also

Last modified: 24 November 2016