线上快速定位 CPU 最热的 PHP 代码路径（使用 OpenResty XRay）
内容提要
本文介绍了使用OpenResty XRay分析PHP应用的例子，通过定位消耗CPU时间最多的代码路径，提高应用性能。OpenResty XRay是非侵入式动态分析工具，无需安装特殊模块或插件，也无需重新编译或重启进程。示例展示了如何使用OpenResty XRay进行分析，找出CPU最热的代码路径。介绍了OpenResty XRay的自动监控和报告功能。
延伸解读
非侵入式分析的实际价值
OpenResty XRay 无需在目标应用中安装模块、重新编译或重启进程，即可对运行中的 PHP 进程进行动态分析。这意味着在生产环境中排查高 CPU 问题时，不必中断服务或修改代码，降低了诊断操作对线上业务的影响，适合需要快速定位性能瓶颈又无法轻易停机的场景。
从热点函数到源码的定位链路
分析报告不仅指出最热函数是 preg_match，还将其关联到业务代码中的 processOrders 函数，并给出具体源文件路径和行号（第 437 行）。这种从运行时热点直接映射到源码位置的机制，能帮助开发者跳过猜测环节，快速找到需要优化的代码段，例如案例中在循环内多次执行的正则匹配。
PHP 与 C 双层火焰图的互补
文章同时展示了 PHP 语言级别和 C 语言级别的 CPU 火焰图。PHP 层指向 preg_match 和 processOrders，C 层则显示 pcre2_match_8、php_pcre_match_impl 等底层调用。两层视图相互印证，既说明性能消耗来自业务代码的正则使用，也揭示其最终由 PCRE2 库执行，有助于判断优化应停留在 PHP 层还是深入底层。
引导式分析与自动监控的适用差异
引导式分析适合按步骤手动选择问题类型、进程和分析时长，便于开发调试和演示；而 Insights 页面提供以日和周为周期的自动报告，可自动监控在线进程。两者并非互斥，日常巡检可依赖自动报告，遇到具体问题时再用引导式分析深入排查，从而兼顾持续监控与针对性诊断。
Q&A
OpenResty XRay 是什么？它有什么特点？
OpenResty XRay 是一个动态追踪产品，可以自动分析运行中的应用，以解决性能问题、行为问题和安全漏洞，并提供可行的建议。它采用非侵入式动态分析，无需在目标应用中安装任何特殊模块或插件，无需重新编译目标应用，甚至无需重启已经在运行的进程。
如何使用 OpenResty XRay 定位 PHP 进程中最消耗 CPU 的代码路径？
首先用 top 命令确认目标 PHP 进程的 CPU 使用率，然后用 ps 查看进程详情。接着打开 OpenResty XRay 的 Web 控制台，选择正确的机器，进入 Guided Analysis 页面，选择 High CPU Usage，点击 Next，选择目标 PHP 应用实例和消耗 CPU 的进程，保持默认分析类型（PHP 和 C/C++），设置分析时间（默认 300 秒），开始分析。分析完成后会自动生成报告，显示最热的 PHP 代码路径。
在示例中，OpenResty XRay 分析报告显示了哪些最热的函数调用？
报告显示最热的函数调用是 preg_match，它是正则匹配的 PHP 层面的封装。此外，还显示了 processOrders 函数（属于业务代码）和 callAction 方法（Laravel 框架中用于调用控制器动作）。在 C 代码路径中，最热的是 pcre2_match_8、php_pcre_match_impl、php_do_pcre_match 和 zend_execute_scripts 等函数。
针对示例中发现的 CPU 热点，OpenResty XRay 给出了什么优化建议？
OpenResty XRay 建议预编译正则表达式来优化性能，因为 preg_match 调用是在循环中多次进行的。
OpenResty XRay 除了引导式分析，还能自动监控并生成报告吗？
是的，OpenResty XRay 也可以自动监控在线进程，并生成分析报告。您可以在 Insights 页面中找到以日和周为周期的自动报告，无需使用 Guided Analysis 功能。
OpenResty XRay 支持哪些运行时环境？
OpenResty XRay 由 Y 语言驱动，可以在不同环境下支持多种不同的运行时，如 Stap+、eBPF+、GDB 和 ODB。
