tuimedia/base Docker 镜像 - 轩辕镜像

Alpine-Profiler

镜像概述和主要用途

该Docker镜像基于Alpine官方镜像扩展，集成了XHProf性能分析工具，实际使用的是支持PHP7的实验性分支。主要用于PHP应用的性能数据采集与分析，帮助开发人员识别应用性能瓶颈。

核心功能和特性

• 基于Alpine官方镜像构建，保持轻量级特性
• 集成XHProf性能分析工具，支持PHP7环境
• 支持CPU和内存性能数据采集
• 允许将性能分析结果持久化存储到指定目录
• 兼容XHProf UI工具的文件命名规范，便于结果可视化分析

使用场景和适用范围

适用于需要对PHP应用进行性能分析和调试的开发环境或测试环境，尤其适合需要采集、存储和分析PHP代码执行过程中CPU及内存消耗的场景。

使用方法和配置说明

基本使用

当需要进行性能分析时，可替代:alpine-official镜像使用。

启用性能分析

在代码中添加以下代码以启动性能分析：

php
xhprof_enable(XHPROF_FLAGS_MEMORY + XHPROF_FLAGS_CPU);

停止性能分析并保存结果

在代码中添加以下代码以停止分析并将结果保存到文件：

php
$name = time();
$type = "my-app-1";
$filename = "/var/www/profiles/$name.hub9.xhprof";
file_put_contents($filename, serialize(xhprof_disable()));

持久化存储性能分析结果

建议将分析结果目录挂载到宿主机，以便持久化存储和后续分析。以下是docker-compose配置示例：

yaml
app:
    image: tuimedia/base:alpine-profiler
    volumes:
        - ./profiles:/var/www/profiles  # 将宿主机./profiles目录挂载到容器内/var/www/profiles

文件命名规范

使用XHProf UI查看分析结果时，文件命名需满足以下要求：

• 文件名格式：name.type.xhprof
• name必须是十六进制数字（通过ctype_xdigit检查返回true）
• type必须存在
• name和type之间用点分隔
• 文件扩展名为xhprof

使用XHProf UI

XHProf有多种UI工具可用，最简单的是XHProf自带的UI。具体使用方法可参考镜像：tuimedia/xhprof-docker。

关于命名的说明：XHProf UI虽不完美，但可以正常使用。按照上述命名规范保存的分析结果文件可被XHProf UI正确识别和展示。