ddev/ddev-webserver

ddev-webserver Docker镜像文档

镜像概述与主要用途

ddev-webserver镜像为DDEV工具链的核心组件，用于构建本地Web开发环境。该镜像通常不单独使用，而是作为DDEV整体解决方案的一部分运行，为PHP和Node.js项目提供Web服务支持、运行环境及开发工具集成。

核心功能与特性

• Web服务器：集成Nginx和Apache，支持多种Web服务配置
• PHP环境：包含多种非EOL（非生命周期结束）PHP版本，满足不同项目需求
• 开发工具：
  • Composer（PHP依赖管理工具）
  • Drush（Drupal命令行工具）
  • PHIVE（PHP归档管理工具）
  • WP-CLI（WordPress命令行工具）
  • Blackfire CLI（性能分析工具）
• 邮件测试：内置mailpit邮件服务器，用于本地邮件发送测试
• 前端工具：集成npm和yarn包管理器，支持Node.js项目开发

使用场景与适用范围

• 本地Web开发环境快速搭建：适用于需要在几分钟内启动标准化开发环境的PHP/Node.js项目
• 团队协作与环境共享：支持环境配置的版本控制和共享，确保团队成员使用一致的开发环境，减少"在我电脑上能运行"问题
• Docker工作流简化：无需Docker专业知识即可利用Docker优势，项目启停、环境扩展和清理操作简便

使用方法与配置说明

正常使用（推荐）

该镜像作为DDEV工具的一部分运行，推荐通过DDEV CLI管理，无需手动配置。具体使用方法参见https://docs.ddev.com/。

单独运行（调试/测试用）

如需单独运行容器进行调试或测试：

bash
docker run -it --rm docker.xuanyuan.run/ddev/ddev-webserver:<tag> bash

说明：<tag>需替换为具体版本标签（如v1.22.0）；--rm参数表示容器退出后自动删除；bash启动交互式shell。

构建与推送镜像

构建并推送镜像至Docker Hub的流程需遵循DDEV发布管理规范，具体步骤参见：https://docs.ddev.com/en/stable/developers/release-management/#pushing-docker-images-with-the-github-actions-workflow

源代码与维护

• 源代码仓库：https://github.com/ddev/ddev/tree/main/containers/ddev-webserver
• 维护者：https://github.com/ddev

支持与帮助

• DDEV社区***：https://ddev.com/s/***
• Stack Overflow：使用https://stackoverflow.com/questions/tagged/ddev提问
• 官方文档：
  • https://docs.ddev.com/
  • https://ddev.com/

问题反馈

提交问题至DDEV主仓库：https://github.com/ddev/ddev/issues

DDEV简介

https://github.com/ddev/ddev是一款开源工具，用于快速搭建本地Web开发环境，支持PHP和Node.js项目。其环境可扩展、版本控制和共享，使开发者无需Docker经验即可采用Docker工作流。项目可随时修改、关闭或删除，操作简便。

许可证

• 镜像包含软件的许可证信息：https://github.com/ddev/ddev/blob/main/LICENSE

与所有Docker镜像一样，本镜像可能包含其他软件（如基础系统的Bash等），这些软件可能具有独立许可证。使用本镜像时，用户需自行确保对镜像中所有软件的使用符合相关许可证要求。