本文目录导读：
在PHP项目中实现“网络剖析”（Network Profiling/Analysis），通常指的是对网络请求、响应时间、数据传输、API调用链路以及服务器网络性能进行监控和分析。
根据你项目的具体需求（是分析外部API性能、监控用户请求链路，还是分析服务器网络带宽）,有以下几种主流实现方案：
应用层：监控HTTP请求与响应（前端/后端请求）
这是最常用的场景，用来分析“你的PHP代码调用外部API”或“客户端请求你的PHP接口”的耗时。
方案 A：使用 cURL 的 CURLINFO_*（分析外部请求）
如果你的PHP代码通过 curl 调用第三方API，可以利用 curl_getinfo() 获取详细的网络阶段耗时。
<?php
$ch = curl_init('https://api.example.com');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
// 执行
$response = curl_exec($ch);
// 获取网络剖析信息
$info = curl_getinfo($ch);
echo "总耗时: " . $info['total_time'] . " 秒\n";
echo "DNS解析耗时: " . $info['namelookup_time'] . " 秒\n";
echo "TCP连接耗时: " . $info['connect_time'] . " 秒\n";
echo "SSL握手耗时: " . $info['ssl_verify_result'] . " (状态码)\n"; // 实际SSL时间用apt_time组合
echo "开始传输前耗时: " . $info['pretransfer_time'] . " 秒\n";
echo "开始传输到首字节: " . $info['starttransfer_time'] . " 秒\n";
// 计算服务器处理时间
$server_process_time = $info['starttransfer_time'] - $info['pretransfer_time'];
echo "服务器处理请求时间: " . $server_process_time . " 秒\n";
curl_close($ch);
?>
适用场景：追踪微服务调用、第三方API慢查询。
方案 B：记录 PHP 请求的完整生命周期（用户访问分析）
使用框架中间件或 register_shutdown_function 记录从接收到请求到发送响应的全过程。
// 在入口文件（如 index.php）最顶部
$GLOBALS['_NETWORK_START'] = microtime(true);
// 在输出响应前或 shutdown 时
register_shutdown_function(function() {
$end = microtime(true);
$duration = ($end - $GLOBALS['_NETWORK_START']) * 1000; // 毫秒
// 获取网络相关数据（需配合 $_SERVER）
$client_ip = $_SERVER['REMOTE_ADDR'] ?? 'unknown';
$request_uri = $_SERVER['REQUEST_URI'] ?? '/';
$method = $_SERVER['REQUEST_METHOD'] ?? 'GET';
$response_size = ob_get_length(); // 输出缓冲区长度
// 记录到日志或数据库
error_log(sprintf(
"[NET_PROFILE] %s %s | IP: %s | Duration: %.2fms | Size: %d bytes",
$method,
$request_uri,
$client_ip,
$duration,
$response_size ?: 0
));
});
进阶：使用 Middleware 模式（如 Laravel/Lumen/ThinkPHP）来计算请求耗时。
网络层：服务器与传输性能分析
如果你的项目需要分析服务器网络带宽、TCP连接状态、丢包率,PHP需要调用系统命令或使用扩展。
方案 A：使用 exec/shell_exec 调用系统工具
// 1. Ping 测试延迟
$ping = shell_exec('ping -c 4 -q 8.8.8.8 2>&1');
echo "<pre>$ping</pre>";
// 2. Traceroute 路由追踪
$traceroute = shell_exec('traceroute -n -m 15 8.8.8.8 2>&1');
echo "<pre>$traceroute</pre>";
// 3. 查看网络接口状态（Linux）
$netstat = shell_exec('ss -tuln 2>&1');
echo "<pre>$netstat</pre>";
// 4. 带宽测试（需安装 iperf）
// exec('iperf3 -c 192.168.1.2 -t 10 -J', $output);
// 解析 JSON 结果
注意：在生产环境执行系统命令有安全风险,必须做严格的参数过滤和权限控制。
方案 B：使用 sockets 扩展手动测量
$start = microtime(true); $socket = socket_create(AF_INET, SOCK_STREAM, SOL_TCP); socket_connect($socket, '8.8.8.8', 443); $connect_time = microtime(true) - $start; // 发送一个小数据包测量传输 socket_write($socket, "GET / HTTP/1.0\r\n\r\n"); $transfer_start = microtime(true); $response = socket_read($socket, 1024); $transfer_time = microtime(true) - $transfer_start; socket_close($socket); echo "TCP连接耗时: " . round($connect_time * 1000, 2) . "ms\n"; echo "数据传输耗时: " . round($transfer_time * 1000, 2) . "ms\n";
链路追踪（分布式系统）
对于大型PHP项目（微服务架构），需要实现分布式链路追踪（Distributed Tracing）,追踪HTTP请求经过的所有服务。
推荐标准与工具：
- OpenTelemetry：使用
open-telemetry/opentelemetry-php组件，自动为每个请求生成 Trace ID,记录跨服务的网络调用。 - Zipkin / Jaeger：通过HTTP或gRPC将Span数据发送到后端。
- LightStep / Datadog APM：付费商业方案,安装Agent即可自动剖析。
PHP伪代码示例（OpenTelemetry）：
use OpenTelemetry\API\Globals;
$tracer = Globals::tracerProvider()->getTracer('my-app');
$span = $tracer->spanBuilder('GET /api/users')->startSpan();
$span->setAttribute('http.url', 'https://service-b/users');
// 模拟网络调用
$response = file_get_contents('https://service-b/users');
$span->end();
第三方综合监控方案（推荐）
手动写所有剖析代码容易遗漏且维护麻烦，对于生产环境，建议直接集成成熟的APM（应用性能管理）工具：
| 工具 | 特点 | PHP支持 |
|---|---|---|
| New Relic | 自动仪表化，无需改代码 | PHP Agent |
| Datadog APM | 分布式追踪、网络分析 | dd-trace-php |
| Sentry Performance | 错误监控 + 性能追踪 | sentry/sentry-laravel |
| Elastic APM | 开源，集成ELK栈 | elastic/apm-agent-php |
| SkyWalking | 国产开源，支持gRPC | PHP Agent (Beta) |
安装方式（以Datadog为例）：
# 安装Agent DD_API_KEY=<key> bash -c "$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script.sh)" # 安装PHP扩展 sudo dd-php-apm-install
之后，所有PHP请求的网络指标（DNS、TCP、SSL、请求耗时）会自动上报到Dashboard。
你应该选哪种？
- 单体应用，只查外部API慢：使用 cURL CURLINFO（方案1A）。
- 需要查用户请求性能：使用 框架中间件 + 日志（方案1B）或直接上 Sentry/New Relic。
- 排查服务器网络问题：使用
exec+ 系统命令（方案2A）,但注意安全。 - 微服务/分布式系统：直接安装 OpenTelemetry 或 Datadog APM（方案3或4）。
