PHP应用需手动暴露符合Prometheus文本格式的/metrics端点，推荐用promphp/prometheus_client_php库并复用CollectorRegistry、合理配置APCu清理机制，避免内存泄漏；Gauge指标须每次抓取时动态更新。
PHP 应用怎么暴露 Prometheus 指标端点
Prometheus 不主动“拉取” PHP 进程内存或执行时间，它靠 HTTP 抓取一个纯文本格式的指标端点（通常是 /metrics）。PHP 本身没有内置指标暴露能力，必须手动构造符合 Prometheus exposition format 的响应体。
最轻量的做法是用原生 PHP 输出，不依赖框架：
header('Content-Type: text/plain; charset=utf-8');
echo "# HELP php_http_requests_total Total number of HTTP requests\n";
echo "# TYPE php_http_requests_total counter\n";
echo "php_http_requests_total{method=\"GET\",status=\"200\"} 127\n";
echo "php_http_requests_total{method=\"POST\",status=\"500\"} 3\n";
echo "# HELP php_memory_bytes Current memory usage in bytes\n";
echo "# TYPE php_memory_bytes gauge\n";
echo "php_memory_bytes " . memory_get_usage() . "\n";注意：所有指标名、标签值、数值都必须严格遵循格式——标签键用英文小写+下划线，字符串值必须双引号包裹（如 status="200"），空格和换行不能错位，否则 Prometheus 抓取会报 text format parsing error。
用 promphp/prometheus_client_php 库时怎么避免内存泄漏
官方推荐的 promphp/prometheus_client_php 是目前最稳定的 PHP Prometheus 客户端，但它默认使用 APCu 存储指标数据。如果没配好，会导致指标累积不清理、内存持续上涨，尤其在 CLI 模式（如队列消费者）中更明显。
立即学习“PHP免费学习笔记（深入）”；
关键配置项和避坑点：
-
APCu必须启用且版本 ≥ 5.1.12（旧版存在 key 冲突 bug） - 不要在每次请求里 new
Prometheus\CollectorRegistry—— 它应复用，全局单例 - CLI 脚本需显式调用
$registry->clearCollectors()或设 TTL，否则指标跨进程残留 - 若用 PHP-FPM，建议把
apc.ttl设为0（永不过期），但务必配合apc.gc_ttl（如 3600）触发定期清理
示例注册方式（放在入口文件最前）：
$registry = new \Prometheus\CollectorRegistry(
new \Prometheus\Storage\APC()
);
$counter = $registry->getOrRegisterCounter(
'app', 'http_requests_total', 'Total HTTP Requests',
['method', 'status']
);为什么用 cURL 抓取 PHP 指标端点总返回空或 404
常见原因不是代码写错，而是 Web 服务器路由/权限拦截了 /metrics 路径。
Apache 需确认 .htaccess 没 deny 该路径，Nginx 更典型：
- 如果用了 Laravel 或 Symfony，
/metrics可能被框架路由捕获并返回 404（因无对应 controller）—— 解决方法是在public/index.php顶部加短路逻辑，绕过框架 - Nginx 中若配置了
try_files $uri $uri/ /index.php?$query_string;，需确保/metrics文件不存在，否则会被当成静态文件返回 404 - 某些安全模块（如 mod_security）会拦截含
metrics字样的请求，日志里可见403或直接丢弃
调试技巧：用 curl -v http://localhost/metrics 看真实响应头和状态码；再直接访问 PHP 文件（如 curl http://localhost/metrics.php）排除路由问题。
Gauge 类型指标在 PHP 里怎么实时反映当前值
Gauge 和 Counter 最大区别在于：前者可增可减，代表瞬时状态（如当前在线用户数、内存占用），后者只能单调递增。PHP 没有后台线程自动刷新 Gauge，所以必须在每次抓取时重新计算。
错误做法：在脚本开头 set 一次，后续不变 —— 导致 Prometheus 显示的永远是首次请求的值。
正确做法：在输出指标前动态调用获取函数：
$gauge = $registry->getOrRegisterGauge('app', 'php_memory_bytes', 'Memory usage in bytes');
$gauge->set(memory_get_usage()); // 每次请求都重设
// 同理，活跃连接数：
$gauge->set(count($active_connections));注意：memory_get_usage() 返回的是当前脚本内存，不是整个 PHP-FPM worker；如需进程级指标（如 RSS），得走 /proc/self/status（Linux only）或 ps 命令，但会显著拖慢响应，慎用。
真正难的不是写几个指标，而是让每个指标含义清晰、标签维度合理、生命周期可控——比如 “请求耗时” 用 Histogram 还是 Summary？标签里该不该加 controller？这些设计一旦定型，改起来比代码还麻烦。
