PhpStorm 2018.3 Help

Create New Project Dialog

File | New Project

Welcome Screen | Create New Project

Use this dialog box to create empty projects, create a PhpStorm Workshop project, or generate framework-specific project stubs for developing applications.

The left-hand pane of the dialog box shows a list of project types for which stubs can be generated. The set of available project types depends on the installed and activated plugins. The contents of the right-hand pane depend on the selected project type. The Location field is common for all project types.

The project types are grouped under the PHP-Specific and Web categories. If you have any project templates saved, they are listed under the User Defined category.

PHP empty project

Choose this option to get just a project folder without any contents.

In the Location field, specify the path to the project folder where the project-related files will be stored, and click Create.

PhpStorm Workshop project

Choose this option to create a PhpStorm Workshop project, which will guide you through many of the PhpStorm features and productivity tools.

In the Location field, specify the path to the project folder where the project-related files will be stored, and click Create.

PHP-specific project types

Project type

Description

Composer Project

The feature is supported only when the Command Line Tools Support plugin is installed and enabled.

The plugin is activated by default. If the plugin is disabled, enable it on the Plugins settings page as described in Managing Plugins.

Choose this option to have a project stub created using the Composer template.

In the right-hand pane:

  1. In the Composer.phar area, appoint the composer.phar command definition file to use in project creation.

    • Use existing composer.phar: choose this option to use commands from a previously downloaded composer.phar and specify its location in the text box.

    • Download composer.phar from getcomposer.org choose this option to have a new instance of Composer downloaded. The downloaded composer.phar file will be saved under the project root folder specified in the Location field.

  2. In the Package area, specify the package to install during the project creation.

    • Available packages: from this list, select the package to install. Use the search field, if necessary: start typing the search string, as you type, the list dynamically reduces to show the packages that match the entered pattern.

    • Description: this read-only text box briefly explains the functionality of the selected package.

    • Version to install: from this list, select the package version. The contents of the list depend on the specific package.

  3. In the Settings area, specify advanced settings for generating a project stub and installing packages (dependencies):

    • Path to PHP executable: in this field, specify the location of the PHP engine installation folder.

    • Command line parameters: in this field, type the additional command line parameters. It is recommended to provide the --dev, option: the a package in this case is added to the require-dev section of the composer.json file instead of the default require section.

Drupal Module

The feature is supported only when the Drupal Support plugin is installed and enabled.

The plugins are activated by default. If the plugins are disabled, enable them on the Plugins settings page as described in Managing Plugins.

Choose this option to have a Drupal module created and set up.

In the right-hand pane:

  1. In the Drupal installation path text box, specify the root folder of the Drupal installation. Type the path manually or click Browse Browse button and select the relevant folder in the dialog box that opens.

Joomla! Integration

The feature is supported only when the Joomla! Support plugin is installed and enabled.

The plugins are activated by default. If the plugins are disabled, enable them on the Plugins settings page as described in Managing Plugins.

Choose this option to get a project stub for developing an application using the Joomla! content management system.

In the right-hand pane:

  1. In the Joomla! installation path specify the folder where Joomla! is installed.

  2. From the Project Type list, choose the Joomla! unit type for the application you will develop in the project. According to this choice, PhpStorm will structure the stub and download the necessaey sources. The available options are:

WordPress Plugin

The feature is supported only when the WordPress Support plugin is installed and enabled.

The plugins are activated by default. If the plugins are disabled, enable them on the Plugins settings page as described in Managing Plugins.

Choose this option to get a project stub for developing applications using WordPress, see WordPress for details.

In the right-hand pane: Type the project location and specify the folder where WordPress is installed. This folder should contain the wp-admin and wp-includes subdirectories.

Web

Project type

Description

HTML5 Boilerplate

Choose this option to have the project structure set up and some sources generated based on the HTML5 Boilerplate template.

In the right-hand pane:

  1. Specify the path to the folder where the project-related files will be stored.

  2. From the Version list, choose the template version to use and click Create.

Web Starter Kit

Choose this option to create a project, set up its structure, and generate some sources in accordance with the Web Starter Kit requirements.

In the right-hand pane:

  1. Specify the path to the folder where the project-related files will be stored.

  2. From the Version list, choose the template version to use and click Create.

React App

Choose this option to generate a project using a globally installed create-react-app package, see Generating a React application with create-react-app for details.

In the right-hand pane:

  1. Specify the path to the folder where the project-related files will be stored.

  2. In the Node Interpreter field, specify the Node.js interpreter to use. Choose a configured interpreter from the list or choose Add to configure a new one

  3. In the create-react-app field, specify the path to the create-react-app package.

  4. Optionally, in the Scripts version field, specify a custom package to use instead of react-scripts during the project generation. This can be one of the packages forked from react-scripts, for example, react-awesome-scripts, custom-react-scripts, react-scripts-ts, etc.

Bootstrap

Choose this option to create a project, set up its structure, and generate some sources based on the Bootstrap template.

In the right-hand pane:

  1. Specify the path to the folder where the project-related files will be stored.

  2. From the Version list, choose the template version to use and click Create.

Foundation

Choose this option to have the project structure set up and some sources generated based on the Foundation framework template.

In the right-hand pane:

  1. Specify the path to the folder where the project-related files will be stored.

  2. From the Version list, choose the template version to use and click Create.

AngularJS

Choose this option to have the project structure set up and some sources generated based on the AngularJS framework template.

In the right-hand pane, specify the path to the folder where the project-related files will be stored.

Angular CLI

Choose this option to get a stub where later you can automatically generate specific structures, such as Classes, Components, Routes, Pipes, Services, etc. using the Angular CLI command line interface.

In the right-hand pane:

  1. Specify the path to the folder where the project-related files will be stored.

  2. In the Node Interpreter field, specify the Node.js interpreter to use. Choose a configured interpreter from the list or choose Add to configure a new one

  3. In the Angular CLI field, specify the path to the @angular/cli package.

React Native

Choose this option to get a stub for developing a React Native application.

In the right-hand pane:

  1. Specify the path to the folder where the project-related files will be stored.

  2. In the Node Interpreter field, specify the Node.js interpreter to use. Choose a configured interpreter from the list or choose Add to configure a new one

  3. In the React Native field, specify the path to the react-native-cli package.

Node.js Express App

Choose this option to have the project structure set up and some project sources generated based on the Express framework.

In the right-hand pane:

  1. Specify the path to the folder where the project-related files will be stored.

  2. The Node interpreter, see Configuring a local Node.js interpreter.

  3. The package manager to use - npm or Yarn, see npm and Yarn.

  4. The Express template engine to use. From the Template engine drop-down list, choose one of the following:
  5. The CSS engine to use. From the CSS engine drop-down list, choose one of the following:

Cordova App

Choose this option to have the project structure set up and some sources generated based on the PhoneGap, Apache Cordova, and Ionic frameworks.

In the right-hand pane:

  1. Specify the path to the folder where the project-related files will be stored.

  2. Specify the location of the executable file phonegap.cmd, or cordova.cmd, or ionic.cmd (see Installing PhoneGap/Cordova/Ionic).

Yeoman

Choose this option to get interface for generating framework-specific project stubs using the Yeoman tool.

The right-hand pane shows all the previously installed Yeoman generators. Select the required generator from the list, click Next, and proceed as described in Yeoman.

Meteor App

Choose this option to have the project structure set up and some sources generated based on the Meteor frameworks.

In the right-hand pane:

  1. Specify the path to the folder where the project-related files will be stored.

  2. Specify the location of the Meteor executable file (see Installing Meteor).

  3. From the Template list, choose the sample to generate. To have a basic project structure generated, choose the Default option.

  4. In the Filename text box, type the name for the mutually related .js, .html, and .css files that will be generated. The text box is available only if the Default sample type is selected from the Template drop-dow list.

Vue.js

Choose this option to create a Vue.js application using Vue CLI.

In the right-hand pane:

  1. Specify the path to the folder where the project-related files will be stored.

  2. In the Node Interpreter field, specify the Node.js interpreter to use. Choose a configured interpreter from the list or choose Add to configure a new one

  3. In the vue-cli or @vue/cli field, specify the folder where the vue-cli or the @vue/cli package is stored.

  4. From the Project template list, choose the Vue.js template to use.

Dart

Choose this option to have the project structure set up and some sources generated for a Dart application.

User Defined

This list is displayed only if you have previously saved any project templates. Choose the relevant item based on its description, see Saving Projects as Templates for details.
Last modified: 7 December 2018

See Also