Skip to content

v1.16.3: xdebug 3

Compare
Choose a tag to compare
@rfay rfay released this 14 Dec 03:50
· 1911 commits to master since this release
1e0808d

Bug alert: composer_version with xdebug

If you're using composer_version in your .ddev/config.yaml and trying to run ddev xdebug on, it will fail. For now, you can just remove the composer_version line and use the default composer v1 to solve this. It will be fixed in another point release. Thanks to patient bug reporters!

Installation/Upgrade

See the installation instructions for details, but it's easy:

  • Please stop all projects first, this does no harm: ddev poweroff
  • macOS Homebrew and Linux Linuxbrew: brew install drud/ddev/ddev or just brew upgrade drud/ddev/ddev ). (You may need a brew update for homebrew to find the new release.)
  • Windows: Use choco upgrade -y ddev to get this one, or download the ddev_windows_installer below.
  • Linux and macOS with the install_ddev.sh script: curl -LO https://raw.githubusercontent.com/drud/ddev/master/scripts/install_ddev.sh && bash install_ddev.sh
  • And anywhere, you can just download the tarball or zipball, untar or unzip it, and place the executable in your path where it belongs.
  • Consider ddev delete images after upgrading to free up disk space used by previous docker image versions. This does no harm.

Key changes in v1.16.3

  • For the big stuff in v1.16, please read v1.16.0 release notes
  • Xdebug 3.0.1 is included with PHP 7.2/7.3/7.4/8.0! It's much faster and has been getting rave reviews
  • PHPMyAdmin (ddev launch -p) now logs into the database as the root user instead of the db user

Why did we need a release for Xdebug 3? It was because the upstream deb.sury.org packages made their planned shift to xdebug 3 for PHP7.2/3/4. Before long, all ddev users who used webserver_extra_packages or did an apt-get install in a custom Dockerfile would have been seeing significant breakage, since the Xdebug config is completely different. And also, of course, people have been looking forward to a faster Xdebug 3.

Caveats

The configuration for Xdebug 3 is different from Xdebug 2. This doesn't affect the vast majority of people, but if you have custom PHP configuration in your project that changes xdebug.*, it will need to be updated. See the Xdebug 2->3 Upgrade Guide if this is you. Almost nobody needs to touch anything, as ddev already chooses the right config for the right Xdebug version.

Commits since v1.16.2

1e0808d Bump upstream php packages to get xdebug 3.0.1 (#2691), fixes #2689
efb5f48 Update database_types.md for mysql 5.7 (#2674) [ci skip][skip ci]
74d164d Use root user for PHPMyAdmin (#2667)
59a40a5 TYPO fixes in cli_usage.md [skip ci][ci skip] (#2678)