WebGrind Docker镜像

镜像概述

WebGrind Docker镜像是一个用于分析PHP应用程序性能的工具，它提供了Xdebug分析器生成的性能数据的Web前端界面。该镜像基于Alpine Linux，包含Nginx和PHP-FPM，可轻松部署和使用。

核心功能和特性

• 可视化展示Xdebug生成的性能分析数据
• 查看函数调用树和执行时间
• 按执行时间、调用次数等指标排序函数
• 支持搜索和筛选功能
• 轻量级Alpine Linux基础镜像
• 包含Nginx和PHP-FPM环境
• 简单的环境变量配置

使用场景和适用范围

• PHP应用程序性能分析和优化
• 识别代码中的性能瓶颈
• 开发和测试环境中的性能问题排查
• PHP开发团队的代码优化工作流
• Web服务器环境中的性能监控

使用方法和配置说明

基本使用

使用以下命令启动WebGrind容器：

bash
docker run -d -p 8080:80 --name webgrind wodby/webgrind

然后通过访问http://localhost:8080即可打开WebGrind界面。

挂载分析文件

要分析本地Xdebug生成的分析文件，可将包含.xt文件的目录挂载到容器中：

bash
docker run -d -p 8080:80 -v /path/to/your/xdebug/profiles:/webgrind/data --name webgrind wodby/webgrind

Docker Compose配置

yaml
version: '3'

services:
  webgrind:
    image: wodby/webgrind
    ports:
      - "8080:80"
    volumes:
      - ./xdebug_profiles:/webgrind/data
    environment:
      - WEBGRIND_STORAGE_DIR=/webgrind/data
      - PHP_MAX_EXECUTION_TIME=60
    restart: unless-stopped

环境变量配置

支持以下环境变量进行配置：

与PHP应用一起使用

在Docker Compose环境中与PHP应用一起使用：

yaml
version: '3'

services:
  php:
    image: your-php-image
    environment:
      - XDEBUG_MODE=profile
      - XDEBUG_OUTPUT_DIR=/tmp/xdebug
    volumes:
      - xdebug_profiles:/tmp/xdebug

  webgrind:
    image: wodby/webgrind
    ports:
      - "8080:80"
    volumes:
      - xdebug_profiles:/webgrind/data
    depends_on:
      - php

volumes:
  xdebug_profiles:

访问Web界面

启动容器后，通过浏览器访问http://<容器IP或主机名>:8080即可使用WebGrind界面：

1. 在文件列表中选择要分析的Xdebug配置文件
2. 查看函数调用图和执行时间统计
3. 使用排序和筛选功能分析性能瓶颈
4. 查看详细的函数调用栈和内存使用情况

注意事项

• 确保PHP应用已配置Xdebug并生成分析文件
• 分析大型应用时可能需要增加PHP内存限制
• 生产环境中建议仅临时部署用于性能分析
• 定期清理旧的分析文件以节省磁盘空间