PhpStorm Workshop Materials

1. On the PhpStorm Welcome screen, click New Project.

   

2. Select PhpStorm Workshop Project from the list on the left, provide the project location in the Location field, and click Create.

   

tip

Alternatively, you can manually clone the PhpStorm Workshop repository from GitHub.

1. Install Docker for your operating system.

2. In PhpStorm, in the Settings/Preferences dialog (Ctrl+Alt+S), go to Build, Execution, Deployment | Docker and select how to connect to the Docker daemon.

   Depending on your operating system, do the following:

   Windows

   macOS

   Linux

   1. Select TCP socket.

   2. Set Engine API URL to tcp://localhost:2375.

      note

      In the General section of Docker for Windows settings, enable Expose daemon on tcp://localhost:2375 without TLS.

   3. Leave the Certificates folder field empty.

   If you are using Docker Toolbox, use the following configuration options instead:

   • Set Engine API URL to https://192.168.99.100:2376

   • Set Certificates folder to <your_home_directory>\.docker\machine\machines\default.

   • Select Docker for Mac.

   • Select Unix socket.

3. Open docker-compose.yml in the editor and update the XDEBUG_CONFIG variable with the value depending on your operating system. This is necessary for Web Debugging.

   Windows

   macOS

   Linux

   Use the host.docker.internal value, which refers to the remote host, that is, the machine Docker is running on. It will automatically resolve to the internal address of the host, letting you connect to it from the container.

   The corresponding part of the docker-compose.yml file should look as follows:

   XDEBUG_CONFIG: remote_host=host.docker.internal

   Use the host.docker.internal value, which refers to the remote host, that is, the machine Docker is running on. It will automatically resolve to the internal address of the host, letting you connect to it from the container.

   The corresponding part of the docker-compose.yml file should look as follows:

   XDEBUG_CONFIG: remote_host=host.docker.internal

   Use your local machine’s hostname. To obtain it, execute the hostname command in Terminal.

   The corresponding part of the docker-compose.yml file should look as follows:

   XDEBUG_CONFIG: remote_host=<local_hostname>

4. In the same docker-compose.yml file, uncomment the appropriate line for the sftp service depending on your operating system. This is necessary for deployment to work correctly.

5. Click in the editor gutter to start all required Docker containers.

   

   Alternatively, open the built-in PhpStorm Terminal (Alt+F12) and execute the docker-compose up command.