tuimedia/base

Alpine-Profiler

镜像概述和主要用途

该Docker镜像基于Alpine官方镜像扩展，集成了https://github.com/phacility/xhprof%EF%BC%8C%E5%AE%9E%E9%99%85%E4%BD%BF%E7%94%A8%E7%9A%84%E6%98%AF%E6%94%AF%E6%8C%81PHP7%E7%9A%84https://github.com/longxinH/xhprof%E3%80%82%E4%B8%BB%E8%A6%81%E7%94%A8%E4%BA%8EPHP%E5%BA%94%E7%94%A8%E7%9A%84%E6%80%A7%E8%83%BD%E6%95%B0%E6%8D%AE%E9%87%87%E9%9B%86%E4%B8%8E%E5%88%86%E6%9E%90%EF%BC%8C%E5%B8%AE%E5%8A%A9%E5%BC%80%E5%8F%91%E4%BA%BA%E5%91%98%E8%AF%86%E5%88%AB%E5%BA%94%E7%94%A8%E6%80%A7%E8%83%BD%E7%93%B6%E9%A2%88%E3%80%82

核心功能和特性

• 基于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。具体使用方法可参考镜像：https://hub.docker.com/r/tuimedia/xhprof-docker/%E3%80%82

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