Most of what you want to know is in the v1.17.0 release notes so please check there... Make sure you read the Caveats.
Installation/Upgrade
See the installation instructions for details, but it's easy:
- macOS Homebrew and Linux Linuxbrew:
brew install drud/ddev/ddev
orbrew upgrade drud/ddev/ddev
). (You may need abrew update
for homebrew to find the new release.). This works on Apple Silicon Homebrew as well. - Windows: Use
choco upgrade -y ddev --version 1.17.6
to get this one, or download the ddev_windows_installer below. - Linux and macOS with the install_ddev.sh script: Download the script, make it executable, and run it:
./install_ddev.sh
orcurl -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. - In the past, a
ddev poweroff
was required; now ddev itself detects that you have a new version and asks for permission to do a poweroff.
Key changes for v1.17.6
- You can now profile your code with the classic xhprof profiler too. Just use
ddev xhprof on
and visit a page. You can then click the provided link at the bottom of the page, or if you don't see it, hithttps://yoursite.ddev.site/xhprof
and use the top link. See docs - Thanks to Tag1 Consulting for sponsoring this feature and others to come! - Minor changes to the ddev-router and nginx/apache config to increase allowed header sizes.
- composer is updated to 2.1.3 by default
Caveats
- If you were using custom Apache or nginx configuration (.ddev/apache/apache-site.conf or .ddev/nginx_full/nginx-site.conf) you'll want to refresh/update your config to add the xhprof configuration link.
- Please see the Caveats in v1.17.0 release notes.
Commits since v1.17.5
d747fd1 Bump images to v1.17.6 for pending release (#3062)
5966cbc Fixing a typo (#3064) [skip ci][ci skip]
a1b9ee4 Add xhprof to ddev, fixes #2974 (#2983)
37db459 [docs] Add Desktop to list of protected directories that need full disk access on macOS [skip ci][ci skip]
6567a48 Fix markdown lint failure on bare url [skip ci][ci skip]
8455a8e Update Mac M1 directions to provide current links. [skip ci][ci skip]
c31433e [tests only] only listen on localhost (on macOS) for xdebug test (#3061)
e5bb7f3 Make sure windows path is set with git-bash first [skip ci][ci skip] (#3058)
e9c4700 Use stable nginx as upstream image for ddev-router (#3059)
001234b Remove trailing whitespace in config templates (#3056) [skip ci][ci skip]
2d4244e Use large_client_header_buffers instead of http2_max_header_size for nginx config (#3053)
235ff4b Improve composer_version docs (#3050) [skip ci][ci skip]
1b534d9 Adding PHIVE to the ddev-webserver image (#3009)
2ffec9d Fix bug in webserver Makefile where prod image can overwrite dev image (#3049)
b2f0368 docker-desktop-version.sh mistakenly insisted on installation of xq (#3045)
a96802b Use buildkite docker-login plugin instead of scripting docker login (#3041)
25d51f4 TestPoweroffOnNewVersion : Try to get a reasonable behavior for start time, fixes #2979 (#3043)
0dd5327 Don't attempt to sign windows binaries we don't have (#3042)
b4c9c31 Download WinNFSd and NSSM on demand fixes #2973, ddev_windows_installer detected as virus (#3039)