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管理，无需手动配置。具体使用方法参见DDEV官方文档。

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

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

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

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

构建与推送镜像

构建并推送镜像至Docker Hub的流程需遵循DDEV发布管理规范，具体步骤参见：DDEV镜像推送文档

源代码与维护

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

支持与帮助

• DDEV社区***：加入***
• Stack Overflow：使用ddev标签提问
• 官方文档：
  • DDEV文档中心
  • DDEV官网

问题反馈

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

DDEV简介

https://github.com/ddev/ddev%E6%98%AF%E4%B8%80%E6%AC%BE%E5%BC%80%E6%BA%90%E5%B7%A5%E5%85%B7%EF%BC%8C%E7%94%A8%E4%BA%8E%E5%BF%AB%E9%80%9F%E6%90%AD%E5%BB%BA%E6%9C%AC%E5%9C%B0Web%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%EF%BC%8C%E6%94%AF%E6%8C%81PHP%E5%92%8CNode.js%E9%A1%B9%E7%9B%AE%E3%80%82%E5%85%B6%E7%8E%AF%E5%A2%83%E5%8F%AF%E6%89%A9%E5%B1%95%E3%80%81%E7%89%88%E6%9C%AC%E6%8E%A7%E5%88%B6%E5%92%8C%E5%85%B1%E4%BA%AB%EF%BC%8C%E4%BD%BF%E5%BC%80%E5%8F%91%E8%80%85%E6%97%A0%E9%9C%80Docker%E7%BB%8F%E9%AA%8C%E5%8D%B3%E5%8F%AF%E9%87%87%E7%94%A8Docker%E5%B7%A5%E4%BD%9C%E6%B5%81%E3%80%82%E9%A1%B9%E7%9B%AE%E5%8F%AF%E9%9A%8F%E6%97%B6%E4%BF%AE%E6%94%B9%E3%80%81%E5%85%B3%E9%97%AD%E6%88%96%E5%88%A0%E9%99%A4%EF%BC%8C%E6%93%8D%E4%BD%9C%E7%AE%80%E4%BE%BF%E3%80%82

许可证

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

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