Composing Docker Local Development: Xdebug (OSX)

Share:

Twitter

Facebook

In this post, we will show the pain points of running Xdebug in a Docker local development environment and how we overcame them.

by
nick.schuch
/ 15 September 2020

Xdebug is essential when it comes to local development.
Normally the hardest part about configuring Xdebug is setting the IP address which it should send its debugging data to (eg. PHPStorm).
Configuring this with Vagrant was very simple since we were able to use the following setting for it to “Just Work”:

xdebug.remote_connect_back = 1
Remote Connect Back is awesome, it allows for Xdebug to send its debugger information back to the IP address making the web request, where PHPStorm is running.
However, running Xdebug with “Docker for Mac” (D4M) is hard. D4M runs over multiple networks:
OSX host
Linux VM
This means that the IP address Xdebug ends up sending data to is the IP address of the Linux VM.
Existing solutions in the Docker community usually end up with the developer running additional configuration that they have to manage:
eg. https://forums.docker.com/t/ip-address-for-xdebug/10460/21
To solve this we wrote a tool called “D4M TCP Forwarder”, which receives requests being sent to a port on the D4M host and forwards them to the OSX users host IP.
https://github.com/nickschuch/d4m-tcp-forwarder
To add this to your project you simply add this service to your Docker Compose file:

xdebug:
image: nickschuch/d4m-tcp-forwarder
network_mode: host
The solution results in:
No configuration for a developer
Reusable solution for the community

Tagged

Docker

Posted by
nick.schuch
Sys Ops Lead

Dated 15 September 2020

Add new comment

Source: New feed

This article was republished from its original source.
Call Us: 1(800)730-2416

Pixeldust is a 20-year-old web development agency specializing in Drupal and WordPress and working with clients all over the country. With our best in class capabilities, we work with small businesses and fortune 500 companies alike. Give us a call at 1(800)730-2416 and let’s talk about your project.

FREE Drupal SEO Audit

Test your site below to see which issues need to be fixed. We will fix them and optimize your Drupal site 100% for Google and Bing. (Allow 30-60 seconds to gather data.)

Powered by

Composing Docker Local Development: Xdebug (OSX)

On-Site Drupal SEO Master Setup

We make sure your site is 100% optimized (and stays that way) for the best SEO results.

With Pixeldust On-site (or On-page) SEO we make changes to your site’s structure and performance to make it easier for search engines to see and understand your site’s content. Search engines use algorithms to rank sites by degrees of relevance. Our on-site optimization ensures your site is configured to provide information in a way that meets Google and Bing standards for optimal indexing.

This service includes:

  • Pathauto install and configuration for SEO-friendly URLs.
  • Meta Tags install and configuration with dynamic tokens for meta titles and descriptions for all content types.
  • Install and fix all issues on the SEO checklist module.
  • Install and configure XML sitemap module and submit sitemaps.
  • Install and configure Google Analytics Module.
  • Install and configure Yoast.
  • Install and configure the Advanced Aggregation module to improve performance by minifying and merging CSS and JS.
  • Install and configure Schema.org Metatag.
  • Configure robots.txt.
  • Google Search Console setup snd configuration.
  • Find & Fix H1 tags.
  • Find and fix duplicate/missing meta descriptions.
  • Find and fix duplicate title tags.
  • Improve title, meta tags, and site descriptions.
  • Optimize images for better search engine optimization. Automate where possible.
  • Find and fix the missing alt and title tag for all images. Automate where possible.
  • The project takes 1 week to complete.