{"id":19798,"date":"2015-10-31T13:04:13","date_gmt":"2015-10-31T13:04:13","guid":{"rendered":"https:\/\/blog.jetbrains.com\/phpstorm\/?p=9326"},"modified":"2024-01-09T14:59:05","modified_gmt":"2024-01-09T13:59:05","slug":"docker-support-in-phpstorm","status":"publish","type":"phpstorm","link":"https:\/\/blog.jetbrains.com\/pt-br\/phpstorm\/2015\/10\/docker-support-in-phpstorm","title":{"rendered":"Docker Support in PhpStorm"},"content":{"rendered":"

\"large_v-trans\"<\/a>Docker<\/a>\u00a0is an open platform for building, shipping and running distributed applications. It gives programmers, development teams and operations engineers the common toolbox they need to take advantage of the distributed and networked nature of modern applications.<\/p>\n

With the new\u00a0Docker integration plugin<\/a>\u00a0for PhpStorm, you can add Docker support to existing projects, view logs, manage Docker containers, and debug PHP web applications from right inside PhpStorm.<\/p>\n

In this blog post we overview some of the most important features and configurations; for more details please refer to the\u00a0full tutorial on Docker Support in PhpStorm<\/a>.<\/p>\n

<\/p>\n

Prerequisites<\/strong><\/h2>\n

First of all, you’ll need to install Docker and related tools so that you can take advantage of the Docker integration in PhpStorm. Please refer to the\u00a0Docker documentation<\/a>\u00a0to get more information about the installation process for various platforms or the cloud.<\/p>\n

You will also need to install the\u00a0Docker integration<\/em>\u00a0plugin in PhpStorm (in\u00a0Settings \/Preferences | Plugins<\/em>, click the\u00a0Install JetBrains plugin…<\/em>).<\/p>\n

PhpStorm & Docker Integration Configuration<\/strong><\/h2>\n

To start using Docker, the default<\/em> Docker machine should be launched using the Docker Quickstart Terminal (<\/em>Windows \/ Mac OS X,\u00a0for Linux you need to use a standard terminal executing a\u00a0sudo docker run hello-world\u00a0<\/em><\/em>command). At the next steps we’ll need some of the parameters of this machine environment, so we’ll need to run\u00a0docker-machine env default<\/em> console command to get all the necessary parameters (Windows \/ Mac OS X, for Linux you’ll need to use a standard IP address\u00a0172.17.42.1)<\/em>, such as DOCKER_HOST<\/em> and DOCKER_CERT_PATH<\/em>:<\/p>\n

\"\"<\/p>\n

As soon as we have Docker running (and all the parameters fetched for future use), we can start configuring PhpStorm to work with Docker.<\/p>\n

Create a Docker configuration<\/em> with the + button in Settings \/ Preferences | Build, Execution, Deployment | Clouds<\/em>:<\/p>\n

\"\"<\/p>\n

We’ll need to provide the configuration name (Docker<\/em>), API URL<\/em> (https:\/\/192.168.99.100:2376<\/em>, taken from the previous step), and Certificates folder<\/em> (\/Users\/mikhailvink\/.docker\/machine\/machines\/default<\/em>).<\/p>\n

Please note that you will need to provide a socket path in the API URL field on Linux machines (unix:\/\/\/var\/run\/docker.sock<\/em> by default).<\/p>\n

Next we need to create a new Docker Deployment Run\/Debug Configuration<\/em> in the\u00a0Run | Edit configurations…<\/em> menu.<\/p>\n

Provide all the necessary parameters on the Deployment<\/em>\u00a0and Container\u00a0<\/em>tabs:<\/p>\n

\"\"<\/p>\n

At this point we are interested in exposing port 80 of the container to be available from our local machine, so we should configure a port binding for that:<\/p>\n

\"\"<\/p>\n

There are many ways to create\/configure Docker containers and VM images; please refer to the\u00a0Docker documentation on their official website<\/a>.<\/p>\n

For the purposes of this tutorial we’re making some configuration in the\u00a0Dockerfile\u00a0<\/em>and\u00a0Apache configuration file<\/em>, so do have a look at them. You can\u00a0download the entire project used in this demo<\/a>\u00a0or separate config files (apache-config.conf<\/a><\/em>,\u00a0Dockerfile<\/a><\/em>) which then need to be placed in the project root folder.<\/p>\n

Running the Docker from PhpStorm<\/strong><\/h2>\n

As all the tools are installed and the integration is configured, the recently created Start Docker<\/em> Run\/Debug Configuration can be launched.\u00a0The\u00a0Application Servers<\/em>\u00a0tool window will be opened updating you on the provisioning status and current state of all your Docker containers:<\/p>\n

\"\"<\/p>\n

As soon as our\u00a0Docker_Xdebug<\/em>\u00a0container’s status turns\u00a0green,<\/em>\u00a0we can check how it works in the browser. You should be able to open it with a URL similar to\u00a0http:\/\/192.168.99.100:8080\/<\/em>\u00a0(http:\/\/host:port<\/em>,\u00a0192.168.99.100<\/em>\u00a0is the IP address of the default Docker machine).<\/p>\n

Managing Docker containers and other Docker-related actions in PhpStorm<\/strong><\/h2>\n

From the\u00a0Application Servers<\/em>\u00a0tool window, it\u2019s easy to inspect containers and view the running processes. You can also search through logs, start and stop containers, and perform basic container management like creating and deleting containers.<\/p>\n

\"\"<\/p>\n

Debugging PHP web application running in the Docker container<\/strong><\/h2>\n

The main challenge in getting Xdebug (or Zend Debugger) working with PhpStorm and Docker integration is the correct configuration of the Docker container.<\/p>\n

In our case we’re using a\u00a0Dockerfile<\/em>\u00a0(we’ve already shown this config earlier and provided links to download it) to configure the container, including Xdebug-specific parameters, such as:<\/p>\n

\n
\n
\n
\n\n\n\n
\n
\n
#Set up debugger<\/code><\/div>\n
RUN echo\u00a0<\/code>\"zend_extension=\/usr\/lib\/php5\/20131226\/xdebug.so\"<\/code>\u00a0>> \/etc\/php5\/apache2\/php.ini<\/code><\/div>\n
RUN echo\u00a0<\/code>\"xdebug.remote_enable=1\"<\/code>\u00a0>> \/etc\/php5\/apache2\/php.ini<\/code><\/div>\n
#Please provide your host (local machine IP) instead of\u00a0<\/code>192.168<\/code>.<\/code>2.117<\/code><\/div>\n
RUN echo\u00a0<\/code>\"xdebug.remote_host=192.168.2.117\"<\/code>\u00a0>> \/etc\/php5\/apache2\/php.ini<\/code><\/div>\n<\/div>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n

Please note that\u00a0xdebug.remote_host\u00a0<\/em>value should be replaced with your local machine IP address which is visible from the Docker container\u00a0(where PhpStorm is running,\u00a0in our case 192.168.2.117<\/em>).<\/p>\n

Don’t forget to re-run\u00a0Start\u00a0Docker<\/em>\u00a0Run\/Debug Configuration so that all the changes are applied.<\/p>\n

As soon as all the configs are in place, the debugging process can be triggered by following\u00a0this tutorial<\/a> starting with step 2<\/strong>\u00a0(start\u00a0Listening for PHP Debug Connections,\u00a0<\/em>set a breakpoint in the source code, and start a debugging session in the browser, reload the current page, debug)\u00a0to get the debugger up and running in a few moments:<\/p>\n

\"\"<\/p>\n

Please have a look at the\u00a0full tutorial on Docker Support in PhpStorm<\/a>\u00a0for more information.<\/p>\n

Please share your feedback on Docker support in PhpStorm in the\u00a0forum<\/a>, comments to this blog post,\u00a0or our issue tracker<\/a>. Thanks!<\/p>\n

Develop with pleasure!<\/em>
\nJetBrains PhpStorm Team<\/em><\/p>\n","protected":false},"author":91,"featured_media":0,"comment_status":"open","ping_status":"open","template":"","categories":[826,808,907,2347],"tags":[2480,632,263,726,2477,792,1053],"cross-post-tag":[],"acf":[],"_links":{"self":[{"href":"https:\/\/blog.jetbrains.com\/pt-br\/wp-json\/wp\/v2\/phpstorm\/19798"}],"collection":[{"href":"https:\/\/blog.jetbrains.com\/pt-br\/wp-json\/wp\/v2\/phpstorm"}],"about":[{"href":"https:\/\/blog.jetbrains.com\/pt-br\/wp-json\/wp\/v2\/types\/phpstorm"}],"author":[{"embeddable":true,"href":"https:\/\/blog.jetbrains.com\/pt-br\/wp-json\/wp\/v2\/users\/91"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.jetbrains.com\/pt-br\/wp-json\/wp\/v2\/comments?post=19798"}],"version-history":[{"count":1,"href":"https:\/\/blog.jetbrains.com\/pt-br\/wp-json\/wp\/v2\/phpstorm\/19798\/revisions"}],"predecessor-version":[{"id":432097,"href":"https:\/\/blog.jetbrains.com\/pt-br\/wp-json\/wp\/v2\/phpstorm\/19798\/revisions\/432097"}],"wp:attachment":[{"href":"https:\/\/blog.jetbrains.com\/pt-br\/wp-json\/wp\/v2\/media?parent=19798"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/pt-br\/wp-json\/wp\/v2\/categories?post=19798"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/pt-br\/wp-json\/wp\/v2\/tags?post=19798"},{"taxonomy":"cross-post-tag","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/pt-br\/wp-json\/wp\/v2\/cross-post-tag?post=19798"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}