DDEV v1.24.5 版本发布：容器化开发环境的重大更新

项目简介

DDEV 是一个开源的容器化开发环境管理工具，它简化了在本地计算机上搭建和管理开发环境的过程。通过 Docker 容器技术，DDEV 为开发者提供了可移植、一致且高效的开发环境，特别适合 PHP、Node.js、Python 等项目的开发工作。

版本亮点

DDEV v1.24.5 带来了多项重要改进和新功能，主要集中在网络配置、开发工具集成和环境变量增强等方面。

WSL2 镜像网络模式支持

对于使用 Windows WSL2 的开发者，新版本显著改进了"镜像模式网络"（Mirrored Mode Networking）的支持。这一模式相比默认的 NAT 模式提供了更好的网络性能。更新包括：

1. 端口等待超时优化，解决了之前可能出现的连接问题
2. 自动配置 Xdebug 连接，简化了调试设置
3. 新增实验性功能标志 hostAddressLoopback=true 来启用这一模式

PhpStorm 集成改进

解决了 PhpStorm 使用 docker-compose run 创建临时容器时导致的状态识别问题。现在：

1. DDEV 集成插件能够正确识别项目状态
2. 避免了因临时容器导致的错误状态报告
3. 提升了 IDE 与开发环境的协作体验

新特性与功能增强

环境变量扩展

新增了几个实用的环境变量，为自动化脚本和配置提供了更多灵活性：

• DDEV_PRIMARY_URL_PORT：获取主 URL 的端口号
• DDEV_PRIMARY_URL_WITHOUT_PORT：获取不带端口号的主 URL
• DDEV_SCHEME：获取当前使用的协议（http 或 https）
• DDEV_APPROOT：在 web 容器中可用的应用根目录路径

构建系统改进

1. 多阶段 Docker 构建支持：现在可以使用 prepend.Dockerfile* 文件来实现复杂的多阶段构建流程
2. 二进制文件校验：下载的 Mutagen 和 docker-compose 二进制文件现在会进行 SHA 校验，确保安全性
3. 重试机制：在网络不稳定的情况下，下载操作会自动重试，提高了可靠性

命令行工具增强

1. Shell 自动补全：为 --service (-s) 标志添加了自动补全支持，适用于多个命令
2. WordPress 路径自动检测：ddev wp 命令现在会自动检测并设置 --path 参数
3. 改进的输出格式：ddev add-on get 命令的输出更加清晰，并添加了警告退出码

问题修复

1. 网络相关问题：

   • 修复了 HTTP/HTTPS 端口解析问题
   • 解决了 WSL2 镜像模式下 Xdebug 的连接问题
   • 优化了端口检测的超时机制

2. 数据库相关：

   • PostgreSQL 导出现在使用快速检查点，避免长时间阻塞
   • 修复了备份过程中的性能问题

3. 其他修复：

   • 解决了 PhpStorm 调试集成导致的 stdin 相关问题
   • 修复了 XHGui 启动命令对自定义端口的支持
   • 移除了 nginx.conf 中冗余的媒体文件处理配置

版本兼容性与升级建议

版本约束支持

新增了对复杂版本约束的支持，包括：

• 通配符（如 1.24.x）
• 比较运算符（如 > 1.24.5）
• 扩展条件表达式

升级注意事项

1. Homebrew 用户：如果仍在使用旧的 drud formula，需要执行清理命令：

   rm -rf "$(brew --repo drud/homebrew-ddev)"
   brew uninstall -f ddev
   brew install ddev/ddev/ddev
   

2. 磁盘空间优化：升级后建议执行 ddev delete images 或 ddev delete images --all 清理旧的 Docker 镜像

3. 配置更新：考虑使用 ddev config --auto 更新项目配置到最新版本

技术栈更新

1. PHP 版本：更新至 PHP 8.3.21 和 8.4.7
2. docker-compose：升级到 v2.36.0
3. Windows 安装：移除了 Chocolatey 的自动安装，简化了安装流程

项目模板改进

1. Magento 2：现在使用 OpenSearch 替代 Elasticsearch
2. Drupal：改进了快速启动模板和测试稳定性
3. Craft CMS：设置文件现在存储在 .ddev/.env.web 中，不再管理主 .env 文件
4. Pimcore：由于上游许可变更，现在需要许可证才能使用

总结

DDEV v1.24.5 是一个功能丰富的中期版本更新，特别关注了 Windows WSL2 用户的体验改进和开发工具集成。新版本在网络配置、环境变量支持和构建系统方面都有显著提升，同时修复了多个影响开发体验的问题。对于使用 DDEV 作为开发环境的团队，这个版本值得升级以获得更稳定和高效的开发体验。