PHP性能监控工具推荐:2026年主流方案为New Relic(生产实时监控)、Blackfire(深度调优火焰图)、PHP 8.6内置面板(本地开发轻量启用),三者需按场景分工使用,禁用Xdebug/XHProf硬塞。

Composer 里没有叫 Parity 的官方或主流 PHP 性能监控库——这个名字在 Packagist、GitHub 和主流 PHP 监控生态(如 Blackfire、Tideways、XHProf、Datadog APM)中均无对应包。你很可能混淆了名称,或是看到非公开/已下架/拼写错误的项目。
composer require 找不到 parity/xxx 的常见原因
执行 composer require parity/something 报错 Could not find package parity/something,基本可归为以下几类:
- 包名拼写错误:比如本意是
spatie/laravel-ray或extlib/parity(但后者也不存在) - 私有包未配置仓库:若该库托管在内部 Git 服务器或私有 Packagist 实例,需先在
composer.json中声明repositories - 包已被移除或重命名:搜索 Packagist.org 确认 —— 截至 2026 年 6 月,
parity作为 vendor 名无有效包 - 混淆了其他语言生态:Rust 有
parity-ethereum,JS 有@parity/api,但都不是 PHP 库
真正可用的 PHP 代码性能监控库推荐
如果你目标是“在 PHP 中做轻量级、可嵌入、开源可控的性能监控”,这些是当前(2026 年中)稳定可用且活跃维护的选择:
-
extlib/xhprof(vialongxinH/xhproffork):PHP 扩展级采样,支持 PHP 8.4+,配合perftools/xhgui可视化,无需 SaaS -
datadog/php-trace:官方 APM SDK,支持分布式追踪、SQL/HTTP 慢调用标记,需 Datadog Agent 配合 -
spatie/laravel-ray(Laravel 专用):开发期实时调试面板,不侵入生产,依赖少,composer require spatie/laravel-ray --dev -
php-pm/php-pm+ 自定义 metrics hook:适用于常驻进程场景,可通过 PSR-14 事件暴露内存/CPU/请求耗时
注意:composer require 后必须检查扩展是否启用(如 xhprof.so)、环境变量是否设置(如 DD_ENV=prod)、以及是否漏掉 vendor/autoload.php 引入 —— 这些比选错包名更容易导致“装了却没效果”。
立即学习“PHP免费学习笔记(深入)”;
如何验证一个监控库是否真被 Composer 正确加载
光看 composer install 成功不够,得确认运行时生效:
- 执行
php -m | grep xhprof(对扩展类) - 在入口脚本顶部加
var_dump(class_exists('Spatie\Ray\Ray'));(对类库) - 触发一次请求后检查日志目录是否有
.xhgui文件生成,或 Ray 面板是否弹出 - 若用
dd()或ray()调试无响应,先确认是否在require-dev里装了但没加--dev参数
名字打错是小事,但把监控链路卡在安装环节,后面所有性能分析都无从谈起。建议先用 composer search xhprof 或访问 packagist.org 直接搜关键词,而不是依赖模糊记忆的库名。



















