Working with Docker Tooling

To connect Zend Studio to Docker:

1. Open the Docker Tooling perspective.

2. In the Docker Explorer view, click the Add Connection icon .
   The Connect to a Docker Daemon dialog is displayed.

3. Configure the binding mode to connect to the Docker daemon:
   • Linux - the default settings will suffice to establish the connection. Skip to the step 4.
   • Windows and Mac OS X - select the Use custom connection settings check-box, and enter the Docker host and Docker SSH certification path (both are displayed in Boot2Docker).
4. Click Test Connection.
   If Docker is configured correctly on your machine, a success message is displayed. If the ping fails, please refer to the Docker documentation: https://docs.docker.com/installation/
5. Click Finish.
   The new connection is displayed in the Docker Explorer view.

To pull a Docker image:

1. In the Docker Images view, click the Pull Image icon .
   The Pull image dialog is displayed.

2. Enter the name of the image you wish to pull, and click Finish.
   Zend Studio pulls the Docker image, and once this process is completed, the image is displayed on the Docker Explorer and Docker Images views.

Note:

Depending on the size of the image, the pulling process may take a while.

To run a Docker image:

1. In the Docker Explorer view, right-click your image and select Run Image.
   The Run a Docker Image wizard is displayed.

2. Enter a name for the image.
3. Define the port and host for the image container (if you wish to use random ports, skip to step 4):
   1. Deselect the 'Publish all exposed ports to random ports on the host interfaces' check-box.
   2. Select the container port in the table and click Edit.
      The Exposing a Container Port dialog is displayed.

   

   3. Set the host port to a free port on your machine, e.g. 8080, and click OK.

4. Click Next.
   The Volumes, Environment Variables and Resource Limitations dialog is displayed.

5. In the Data Volumes section, click Add.
   The Data Volume dialog is displayed.

6. Configure the container's data volume:
   1. Set the container path as '/var/www/html'
      

   2. Select the 'Mount a host directory or host file' option, and click Directory to browse to an empty directory on your machine.

   3. Click OK.
      The new data volume is added to the list.
   4. Select it from the list.
7. In the Environment variables section, click Add to specify the name and value for an environment variable you wish to define.
8. To define resource limitations for the Docker image, select the 'Enable resource limitations' check-box and configure CPU priority and the memory limit.
9. Select the added data volume, and click Finish to run the image.
   The new image container is started and is displayed in the Docker Explorer and Docker Containers views.

To link a Docker Image with a PHP server:

1. From the menu-bar,  select Window | Show View | PHP Servers to add the PHP Servers view to your perspective.

2. In the PHP Servers view, click on the Add icon .
   The PHP Server Creation dialog is displayed.

3. Select Generic PHP Server, and click Next.
   The Server details dialog is displayed.

   Note:

   If the Docker image you are using contains Zend Server, you will need to link it to a Remote Zend Server.

4. Enter the following information:

   • Name: Server name (e.g. Docker Image).

   • Base URL: http://<host>:<port>, where <host> is the host where the Docker Engine is running, and <port> is the port used to map the container’s HTTP port to the local system (see step 3 in Running Docker Images above).
   • Document Root: The folder used to map the container's document root to the local file system (see step 6 in Running Docker Images above).
5. Complete the remaining steps in the wizard. For more information, see Adding a Generic PHP Server.

Once created, the new PHP server is created and added to the PHP Servers view.