Phpstorm docker xdebug how to#
Phpstorm docker xdebug code#
Phpstorm docker xdebug series#
Phpstorm docker xdebug download#
Phpstorm docker xdebug windows#

Inside it, create two directories: nginx and php. In your project's root directory, create a new directory called docker. Usually, I start with an PHP and a nginx container. You can learn more on Laravel's documentation.

Just with this initial setup, you have a solid starting poing for developing an awesome web application. Now that we have a brand new project to work with, let's open it in PhpStorm.

Open up a terminal and run: composer create-project laravel/laravel xdebug-test Make sure you have the following things installed on your local: composer, Docker and PhpStorm.įor the purpose of this article, let's create a brand new Laravel application.

Phpstorm docker xdebug how to#

In this article, I'm going to talk about how to debug your PHP application running in a Docker container while using PhpStorm. Okay, enough talk, let's get to work, shall we? It has all the featues you may wish for an IDE and it is built for smoother developer experience. PhpStorm is another great tool that makes our lives easier. If you are curious to know more about it, you can find lots of useful information on their website.

Phpstorm docker xdebug series#

If you’d like to learn more about Docker and how to use it in PhpStorm, make sure to check out the excellent tutorial series by Pascal Landau, and PhpStorm documentation, of course.If you are a PHP developer, you've probably heard or even worked with Xdebug.įor those of you that haven't heard of this amazing tool: Xdebug is an extension for PHP, and provides a range of features to improve the PHP development experience.Īs you may have guessed it, it's a tool used for debugging. Using these Docker images will save you a lot of effort and let you start coding in a matter of a minute, or even less! We encourage you to further explore the PhpStorm Docker registry: while we’ve looked at a very simple case, you can use the described technique to provide your environment with, for example, a database, or an sftp server. Now, simply open the page in the browser, and the debugging session will be started automatically:

Enable listening to incoming debug connections in PhpStorm:.

Have a debugging extension installed and enabled for your browser:.

Since we already have Xdebug installed and configured, this will only require that you: To do this, we’ll create the most simple Hello world PHP file and try to debug it following the PhpStorm Zero-Configuration Debugging approach. Let’s ensure that everything works as expected.

Phpstorm docker xdebug code#

That’s it: we’ve got everything ready for running and debugging our code! Running and debugging code

Phpstorm docker xdebug download#

PhpStorm will automatically download the required image and start the web server: You can now start the configuration from the toolbar: In the dialog that opens, provide the name of the configuration and apply your changes: Right-click docker-compose.yml and select Create… from the context menu: We can now start using it by creating a dedicated run/debug configuration. See here for more details and possible workarounds.

The corresponding environment configuration section for Linux will read as follows. You’ll have to use your local machine’s hostname instead (to find out what your machine’s hostname is, simply execute hostname in Terminal).

Phpstorm docker xdebug windows#

In Docker for Windows and Docker for Mac, it automatically resolves to the internal address of the host, letting you easily connect to it from the container.Īn important note for Linux users: on Linux is currently not supported. Note that we use the value to refer to the remote host. XDEBUG_CONFIG: remote_host=Īs you can see, we use the preconfigured Docker image comprising the Apache web server and PHP 7.4 with Xdebug.

In our case, it will be a single webserver service: version: '2' Next, we create a new file named docker-compose.yml , which will describe the configuration of the services comprising our app. To get started, we create a new project in PhpStorm. It provides a selection of preconfigured Docker images curated by the PhpStorm team, which cover the most common PHP development needs.īefore you proceed, make sure that you have Docker installed on your machine: see how to do it on Windows and on macOS. Probably the easiest way to integrate Docker with PhpStorm is to use the PhpStorm Docker registry. With Docker, you can start developing, running, and debugging your code in a matter of minutes! Your first step will be to set up a development environment: at the bare minimum, you’d want to run a web server and a PHP interpreter (preferably – with the debugging engine installed). So, you’ve decided to try something new today and started a project from scratch.