当前位置：首页 > 文章列表 > 文章 > php教程 > Symfony将基准结果转为数组技巧

Symfony将基准结果转为数组技巧

2026-01-14 17:17:40 0浏览收藏

学习文章要努力，但是不要急！今天的这篇文章《Symfony 将基准测试结果转为数组方法》将会介绍到等等知识点，如果你想深入学习文章，可以关注我！我会持续更新相关文章的，希望对大家都能有所帮助！

首先使用PHPBench生成JSON格式的基准测试报告，可通过配置phpbench.json文件或命令行参数实现；2. 然后使用PHP的file_get_contents读取生成的JSON文件；3. 接着调用json_decode($jsonData, true)将JSON内容转换为PHP关联数组；4. 最后遍历数组结构，提取suites、benchmarks、subjects和variants中的关键指标（如平均时间、峰值内存等），并整理成扁平化数组以便分析；该方法确保了数据的结构化与可操作性，最终得到一个包含所有必要性能指标的PHP数组以供后续使用。

Symfony 怎么把基准测试结果转数组

将Symfony项目中的基准测试结果转为数组，这听起来有点像要把一份详细的报告从纸面搬到电子表格里，方便后续分析。通常，这不会是基准测试工具直接给你的默认选项，你需要一些策略来捕获或解析它的输出。最直接且结构化的方法，我个人比较推荐利用基准测试工具（比如PHPBench）的JSON输出能力，然后用PHP代码去解析这个JSON。

解决方案

如果你在Symfony项目中使用PHPBench进行基准测试，那么最直接且结构化的方法就是让PHPBench生成JSON格式的报告。这样一来，你就能用标准的json_decode函数轻松地将其转换为PHP数组。

首先，确保你的PHPBench配置允许输出JSON报告。你可以在phpbench.json配置文件中指定报告输出路径，或者直接在命令行中指定。

phpbench.json 配置示例：

{
    "reports": {
        "json_report": {
            "generator": "json",
            "path": "var/benchmark_results.json"
        }
    },
    "output": {
        "json_report": {}
    }
}

然后，运行你的基准测试：

vendor/bin/phpbench run --report=json_report

这会在你的var/目录下生成一个benchmark_results.json文件。

接下来，你就可以用PHP代码读取并解析这个文件了：

';
// print_r($resultsArray);
// echo '

'; // 示例：提取每个Subject的平均时间 $processedResults = []; foreach ($resultsArray['suites'] as $suite) { foreach ($suite['benchmarks'] as $benchmark) { foreach ($benchmark['subjects'] as $subject) { foreach ($subject['variants'] as $variant) { // 假设我们关心每个 variant 的平均时间 (mean time) // 和内存消耗 (memory_peak) $processedResults[] = [ 'benchmark_class' => $benchmark['class'], 'subject_name' => $subject['name'], 'variant_index' => $variant['index'], 'mean_time_us' => $variant['result']['time']['avg'], // 微秒 'memory_peak_bytes' => $variant['result']['memory']['peak'], // 字节 'iterations' => $variant['result']['nb_iterations'], 'revs' => $variant['result']['nb_revolutions'], ]; } } } } // print_r($processedResults); ?>

这段代码会把JSON文件内容读取出来，然后用json_decode(..., true)直接转成PHP数组。之后，你可以根据PHPBench JSON的结构，遍历并提取你真正关心的指标，组合成一个更扁平、更易用的数组。

如何在PHPBench中配置JSON输出？

在PHPBench中配置JSON输出，主要是通过其灵活的报告（Reports）系统来完成的。PHPBench内置了一个JSON报告生成器，你只需要告诉它何时以及如何使用。这比自己去解析控制台输出要靠谱得多，也更不容易出错。

配置JSON输出有两种主要方式：通过配置文件或直接在命令行中指定。

1. 通过 phpbench.json 配置文件： 这是我个人比较推荐的方式，因为它能让你的测试配置保持一致性，方便团队协作。在你的项目根目录下（或者你指定给PHPBench的配置路径），创建一个phpbench.json文件，并添加如下内容：

{
    "reports": {
        "my_json_report": {
            "generator": "json",
            "path": "var/benchmarks/results.json"
        }
    },
    "output": {
        "my_json_report": {}
    }
}

"reports" 部分定义了一个名为 my_json_report 的报告。
"generator": "json" 明确告诉PHPBench使用内置的JSON报告生成器。
"path": "var/benchmarks/results.json" 则指定了JSON文件的输出路径。你可以根据你的项目结构调整这个路径，比如放到storage/或者data/目录下。
"output" 部分则指定了在执行测试时，哪些报告应该被生成。这里我们让 my_json_report 生成。

配置好后，你只需要运行普通的基准测试命令即可：

vendor/bin/phpbench run

PHPBench会自动根据配置文件生成JSON报告。

2. 通过命令行参数： 如果你只是想临时生成一个JSON报告，或者不想修改配置文件，可以直接在运行命令时指定报告类型：

vendor/bin/phpbench run --report=json --output=var/temp_results.json

--report=json 告诉PHPBench使用JSON报告生成器。
--output=var/temp_results.json 则指定了输出文件的路径。

这种方式虽然方便，但如果你经常需要JSON输出，还是配置到phpbench.json里更省心。JSON报告的结构通常比较复杂，它会包含基准测试的套件（suites）、基准测试类（benchmarks）、主题（subjects）、变体（variants）、以及每个迭代（iterations）的详细结果（时间、内存、错误等）。理解这个结构是将其转换为你所需数组的关键。

如何通过PHP代码解析JSON结果并转换为特定数组结构？

拿到PHPBench生成的JSON文件后，接下来的事就简单多了，无非就是用PHP内置的json_decode函数把它变成一个PHP数组或对象。关键在于，JSON里头的数据结构是分层的，你需要根据自己的需求，从中“筛选”出你真正关心的那部分数据，并将其整理成你想要的数组格式。

假设我们已经通过file_get_contents()读取了JSON文件内容到$jsonData变量，并且json_decode($jsonData, true)得到了一个名为$resultsArray的关联数组。

PHPBench的JSON结构通常是这样的：

{
    "suites": [
        {
            "env": { /* 环境信息 */ },
            "benchmarks": [
                {
                    "class": "App\\Benchmark\\MyBenchmark",
                    "path": "/path/to/MyBenchmark.php",
                    "subjects": [
                        {
                            "name": "benchSomething",
                            "groups": [],
                            "variants": [
                                {
                                    "index": 0,
                                    "parameters": {},
                                    "result": {
                                        "time": {
                                            "avg": 12345.67,
                                            "mode": 12000.0,
                                            "rstdev": 100.0,
                                            // ... 更多时间统计
                                        },
                                        "memory": {
                                            "avg": 1024,
                                            "peak": 2048
                                        },
                                        "nb_iterations": 5,
                                        "nb_revolutions": 1000,
                                        // ... 其他结果
                                    }
                                }
                            ]
                        }
                    ]
                }
            ]
        }
    ]
}

我们的目标是把它转换成一个更扁平、更易于分析的数组，比如每个条目代表一个基准测试的“变体”（variant），包含其名称、平均时间、峰值内存等核心指标。

 $benchmarkClass,
                                    'subject_name' => $subjectName,
                                    'variant_index' => $variant['index'] ?? null,
                                    'parameters' => $variant['parameters'] ?? [], // 变体参数
                                    'mean_time_ms' => $meanTimeUs !== null ? round($meanTimeUs / 1000, 2) : null, // 转换为毫秒
                                    'peak_memory_kb' => $peakMemoryBytes !== null ? round($peakMemoryBytes / 1024, 2) : null, // 转换为KB
                                    'iterations' => $iterations,
                                    'revolutions' => $revolutions,
                                    'error' => $error,
                                ];
                            }
                        }
                    }
                }
            }
        }
    }
}

// 此时 $cleanResults 就是一个你整理好的数组，每个元素代表一个基准测试变体的关键数据
// print_r($cleanResults);

/*
示例输出结构：
Array
(
    [0] => Array
        (
            [benchmark_class] => App\Benchmark\MyBenchmark
            [subject_name] => benchSomething
            [variant_index] => 0
            [parameters] => Array()
            [mean_time_ms] => 12.35
            [peak_memory_kb] => 2.0
            [iterations] => 5
            [revolutions] => 1000
            [error] =>
        )
    // ... 更多基准测试结果
)
*/

这段代码通过多层循环遍历JSON结构，并使用空合并运算符??来安全地访问可能不存在的键，避免报错。它将每个“变体”的关键性能指标（平均时间、峰值内存、迭代次数等）提取出来，并整理成一个扁平的关联数组，最后收集到$cleanResults数组中。你可以根据自己的分析需求，增加或减少提取的字段，甚至进行单位转换（比如从微秒转毫秒，字节转KB）。

除了JSON，还有哪些更高级的编程方式获取基准测试数据？

当然，如果你觉得解析文件还不够直接，或者需要在PHPBench运行过程中实时处理数据，那么直接利用PHPBench的API进行编程访问会是更高级的选项。这通常涉及到在你的PHP代码中直接调用PHPBench的组件，而不是通过命令行。

这种方式的优势在于：

实时性： 你可以在测试结束后立即在同一个进程中获取到结果对象，无需文件IO。
灵活性： 你可以更细粒度地控制测试的执行，甚至编写自定义的报告器或监听器。
数据结构原生： 获取到的就是PHPBench内部定义的对象，而不是通过JSON序列化/反序列化后的数据。

实现这种方式，你需要像PHPBench本身那样，实例化它的核心服务。这通常包括Container、Runner、ReportGenerator等。这玩意儿说起来有点复杂，因为它深入到了PHPBench的内部工作机制，但核心思想是：

构建PHPBench容器： PHPBench内部通过一个依赖注入容器来管理其服务。
获取Runner服务： Runner是执行基准测试的核心组件。
运行基准测试并获取报告对象： Runner会返回一个Report对象，这个对象包含了所有测试结果的结构化数据。

这是一个简化的概念性代码示例，实际操作可能需要更详细地配置PHPBench的Container：

init();

/** @var \PhpBench\Runner $runner */
$runner = $container->get(PhpBench::SERVICE_RUNNER);

// 定义要运行的基准测试文件或目录
$paths = [
    __DIR__ . '/src/Benchmark' // 你的基准测试文件所在的目录
];

// 执行基准测试
/** @var Report $report */
$report = $runner->run($paths);

// 此时，$report 对象就包含了所有基准测试的结果
// 你可以遍历这个对象来获取数据，并转换为数组
$processedResults = [];

foreach ($report->getSuites() as $suite) {
    foreach ($suite->getBenchmarks() as $benchmark) {
        foreach ($benchmark->getSubjects() as $subject) {
            foreach ($subject->getVariants() as $variant) {
                // 获取结果对象
                $result = $variant->getResult();

                // 提取数据
                $timeResult = $result->getTime();
                $memoryResult = $result->getMemory();

                $processedResults[] = [
                    'benchmark_class' => $benchmark->getClass(),
                    'subject_name' => $subject->getName(),
                    'variant_index' => $variant->getIndex(),
                    'parameters' => $variant->getParameterSet()->getArrayCopy(), // 获取参数
                    'mean_time_us' => $timeResult->getMean(),
                    'peak_memory_bytes' => $memoryResult->getPeak(),
                    'iterations' => $result->getNbIterations(),
                    'revolutions' => $result->getNbRevolutions(),
                    'error' => $result->hasError() ? $result->getError()->getMessage() : null,
                ];
            }
        }
    }
}

// print_r($processedResults);

这种方式虽然代码量稍大，且对PHPBench的内部结构有一定要求，但它提供了最直接、最灵活的数据访问能力。如果你需要构建一个高度定制化的报告系统，或者将基准测试结果无缝集成到其他自动化流程中，那么直接使用PHPBench的API会是更好的选择。它避免了JSON解析的开销，并且你直接操作的是PHP对象，类型提示和IDE支持都更友好。

今天关于《Symfony将基准结果转为数组技巧》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！