PHPackages phperf/xh-tool - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Debugging & Profiling](/categories/debugging) 4. / 5. phperf/xh-tool ActiveTool[Debugging & Profiling](/categories/debugging) phperf/xh-tool ============== XHPROF profile viewer CLI tool v1.1.0(8y ago)46.3k↑66.7%17MITPHPPHP >5.4 Since Feb 8Pushed 8y agoCompare [ Source](https://github.com/phperf/xh-tool)[ Packagist](https://packagist.org/packages/phperf/xh-tool)[ RSS](/packages/phperf-xh-tool/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (2)Dependencies (1)Versions (3)Used By (7) XHPROF profile viewer CLI tool ============================== [](#xhprof-profile-viewer-cli-tool) A command-line tool to analyze XHPROF hierarchical data. Installation ------------ [](#installation) Download `xh-tool.phar` from releases, optionally install bash completions and symlink to `/usr/local/bin` with: ``` php xh-tool.phar --install ``` Or install via `composer`: ``` composer require --dev phperf/xh-tool ``` Usage ----- [](#usage) Get a serialized profile data file, example: `xhprof_report_sample.1518071438.9016.serialized`. You can get a profile of standalone script with [`phperf/php-profiler`](https://github.com/phperf/profiler-docker) docker image: ``` docker run --rm -v $(pwd):/code phperf/php-profiler php test_me.php ``` ### Info [](#info) Get basic info about profile ``` xh-tool info --help v1.1.0 xh-tool info XHPROF profile viewer Usage: xh-tool info profile Path to XHPROF hierarchical profile Options: --cpu Show CPU time instead of wall time --with-mem Add memory info ``` ``` xh-tool info xhprof_report_sample.1518071438.9016.serialized Nodes: 2082 Functions: 731 Calls: 16M Total name wallTime wallTime% wallTime1 ownTime ownTime% ownTime1 count main() 34.99s 100 34.99s 7.56ms 0.02 7.56ms 1 ``` ### Top [](#top) Get ordered functions list ``` xh-tool top --help v1.1.0 xh-tool top XHPROF profile viewer Usage: xh-tool top profile Path to XHPROF hierarchical profile Options: --strip-nesting Strip @N for nested calls --limit Number of rows in result, default no limit --filter Case-insensitive regex to filter by function name, example: "process$", "swaggest", "^MyNs\\MyClass\\MyMethod$" --cpu Show CPU time instead of wall time --with-mem Add memory info --order Order by field, default: ownTime Allowed values: name, wallTime, wallTime1, wallTime%, cpuTime, cpuTime1, cpuTime%, ownTime, ownTime1, ownTime%, ownCpuTime, ownCpuTime1, ownCpuTime%, memoryUsage1, peakMemoryUsage, peakMemoryShift, count ``` Columns: - `wallTime` is time spent in function (including child function calls). - `wallTime%` is time spent in function normalized to `main()` total time. - `wallTime1` is average time spent in 1 function call, valued as `wallTime / count`. - `ownTime` is time spent in function (excluding child function calls). - `ownTime%` is `ownTime` normalized to to `main()` total time. - `ownTime1` is average time spent in 1 function call (excluding child function calls), valued as `ownTime / count`. - `cpuTime` is CPU time spent in function (including child function calls). - `cpuTime%` is CPU time spent in function normalized to `main()` total CPU time. - `cpuTime1` is average CPU time spent in 1 function call, valued as `cpuTime / count`. - `ownCpuTime` is time spent in function (excluding child function calls). - `ownCpuTime%` is `ownCpuTime` normalized to to `main()` total CPU time. - `ownCpuTime1` is average time spent in 1 function call (excluding child function calls), valued as `ownCpuTime / count`. - `memoryUsage1` is average memory usage by 1 function call. - `peakMemoryUsage` is a peak value of memory usage if changed after function call. - `peakMemoryShift` is amount of memory contributed by function to `peakMemoryUsage`. - `count` is number of function calls happened. ``` xh-tool top xhprof_report_sample.1518071438.9016.serialized --order ownTime --limit 10 --filter swaggest name wallTime wallTime% wallTime1 ownTime ownTime% ownTime1 count Swaggest\JsonSchema\Schema::process 12.52s 35.79 113.2us 1.12s 3.2 10.1us 111K Swaggest\JsonSchema\Schema::process@1 9.2s 26.3 98.1us 1.05s 2.99 11.1us 94K Swaggest\JsonSchema\Schema::processObject 10.05s 28.72 138.6us 965.02ms 2.76 13.3us 73K Swaggest\JsonSchema\Tests\PHPUnit\Spec\Draft7OpisTest::runSpecTest 14.78s 42.23 275.6us 884.17ms 2.53 16.5us 54K Swaggest\JsonSchema\Schema::in 14.36s 41.04 129.8us 813.56ms 2.33 7.4us 111K Swaggest\JsonSchema\Schema::process@2 6.98s 19.95 101us 773.07ms 2.21 11.2us 69K Swaggest\JsonSchema\Schema::process@3 4.99s 14.26 81.4us 740.24ms 2.12 12.1us 61K Swaggest\JsonSchema\Tests\PHPUnit\Spec\Draft7SwaggestTest::runSpecTest 17.01s 48.62 307.6us 734.24ms 2.1 13.3us 55K Swaggest\JsonSchema\Constraint\Type::isValid 746.13ms 2.13 2.8us 718.75ms 2.05 2.7us 269K Swaggest\JsonSchema\Schema::process@4 3.06s 8.76 54.2us 691.08ms 1.98 12.2us 57K ``` ### Func [](#func) Get info on specific function ``` v1.1.0 xh-tool func XHPROF profile viewer Usage: xh-tool func profile Path to XHPROF hierarchical profile filter Case-insensitive regex to filter by function name, example: "process$", "swaggest", "^MyNs\\MyClass\\MyMethod$" Options: --strip-nesting Strip @N for nested calls --limit Number of rows in result, default no limit --cpu Show CPU time instead of wall time --with-mem Add memory info --order Order by field, default: ownTime Allowed values: name, wallTime, wallTime1, wallTime%, cpuTime, cpuTime1, cpuTime%, ownTime, ownTime1, ownTime%, ownCpuTime, ownCpuTime1, ownCpuTime%, memoryUsage1, peakMemoryUsage, peakMemoryShift, count ``` ``` xh-tool func xhprof_report_sample.1518071438.9016.serialized Schema::process$ Function name wallTime wallTime% wallTime1 ownTime ownTime% ownTime1 count Swaggest\JsonSchema\Schema::process 12.52s 35.79 113.2us 1.12s 3.2 10.1us 111K Parents name wallTime wallTime% wallTime1 count Swaggest\JsonSchema\Schema::in 12.42s 35.51 112.3us 111K Swaggest\JsonSchema\Schema::out 97.63ms 0.28 97.63ms 1 Children name wallTime wallTime% wallTime1 count Swaggest\JsonSchema\Schema::processType 308.63ms 0.88 4.8us 65K Swaggest\JsonSchema\Schema::processAnyOf 66.77ms 0.19 51.4us 1K SplObjectStorage::attach 2us 0 2us 1 SplObjectStorage::contains 1us 0 1us 1 Swaggest\JsonSchema\Schema::processContent 17.4ms 0.05 24.9us 700 Swaggest\JsonSchema\Schema::processOneOf 102.59ms 0.29 73.3us 1K Swaggest\JsonSchema\Schema::processIf 40.04ms 0.11 33.4us 1K Swaggest\JsonSchema\Schema::processEnum 2.68ms 0.01 5.4us 500 Swaggest\JsonSchema\Schema::processConst 48.98ms 0.14 40.8us 1K Swaggest\JsonSchema\Schema::processNot 51.65ms 0.15 25.8us 2K Swaggest\JsonSchema\Schema::processAllOf 94.92ms 0.27 59.3us 2K array_key_exists 12.17ms 0.03 0.1us 105K Swaggest\JsonSchema\Schema::processNumeric 14.43ms 0.04 1.9us 8K Swaggest\JsonSchema\Schema::processArray 212.15ms 0.61 30.3us 7K Swaggest\JsonSchema\Schema::processString 431.46ms 1.23 25.1us 17K is_array 5.39ms 0.02 0.1us 88K Swaggest\JsonSchema\Schema::processObject 9.97s 28.5 143.9us 69K is_float 7.24ms 0.02 0.1us 93K is_int 7.64ms 0.02 0.1us 97K is_string 8.06ms 0.02 0.1us 103K PHPUnitBenchmark\Suite::jsonSerialize 22us 0 22us 1 ``` ### Edges [](#edges) Show raw edges of profile data ``` xh-tool edges --help v1.1.0 xh-tool edges XHPROF profile viewer Usage: xh-tool edges profile Path to XHPROF hierarchical profile Options: --strip-nesting Strip @N for nested calls --limit Number of rows in result, default no limit --filter Case-insensitive regex to filter by function name, example: "process$", "swaggest", "^MyNs\\MyClass\\MyMethod$" --cpu Show CPU time instead of wall time --with-mem Add memory info --order Order by field, default: ownTime Allowed values: name, wallTime, wallTime1, wallTime%, cpuTime, cpuTime1, cpuTime%, ownTime, ownTime1, ownTime%, ownCpuTime, ownCpuTime1, ownCpuTime%, memoryUsage1, peakMemoryUsage, peakMemoryShift, count ``` ``` xh-tool edges xhprof_report_sample.1518071438.9016.serialized --order ownTime --limit 10 --filter swaggest name wallTime wallTime% wallTime1 count Swaggest\JsonSchema\Schema::processObject@1==>Swaggest\JsonSchema\Schema::process@2 5.23s 14.96 172.1us 30K Swaggest\JsonSchema\Helper::toPregPattern==>strpos 905us 0 0.2us 5K Swaggest\JsonSchema\Schema::processObject==>spl_autoload_call 13.55ms 0.04 4.52ms 3 Swaggest\JsonSchema\Schema::processObject==>Swaggest\JsonSchema\Structure\ObjectItem::key 7.8ms 0.02 1.7us 5K Swaggest\JsonSchema\Structure\ObjectItem::key==>ArrayIterator::key 574us 0 0.1us 5K Swaggest\JsonSchema\Schema::processObject==>Swaggest\JsonSchema\Structure\ObjectItem::current 8.25ms 0.02 1.8us 5K Swaggest\JsonSchema\Structure\ObjectItem::current==>ArrayIterator::current 463us 0 0.1us 5K Swaggest\JsonSchema\Schema::processObject==>Swaggest\JsonSchema\Structure\ObjectItem::valid 12.79ms 0.04 1.9us 7K Swaggest\JsonSchema\Structure\ObjectItem::valid==>ArrayIterator::valid 1.08ms 0 0.2us 7K Swaggest\JsonSchema\Schema::processObject==>Swaggest\JsonSchema\Structure\ObjectItem::rewind 9.72ms 0.03 2.9us 3K ``` ### Health Score 33 — LowBetter than 75% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity28 Limited adoption so far Community14 Small or concentrated contributor base Maturity59 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~23 days Total 2 Last Release 2998d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/27acbd2504e91c838d403112493d8ae7b584c2d8d2f2ea7a9762ef764e35bc8c?d=identicon)[vearutop](/maintainers/vearutop) --- Top Contributors [![vearutop](https://avatars.githubusercontent.com/u/1381436?v=4)](https://github.com/vearutop "vearutop (4 commits)") ### Embed Badge ![Health badge](/badges/phperf-xh-tool/health.svg) ``` [![Health](https://phpackages.com/badges/phperf-xh-tool/health.svg)](https://phpackages.com/packages/phperf-xh-tool) ``` ### Alternatives [symfony/stopwatch Provides a way to profile code 2.8k387.2M918](/packages/symfony-stopwatch)[fruitcake/laravel-debugbar PHP Debugbar integration for Laravel 19.1k662.9k29](/packages/fruitcake-laravel-debugbar)[jokkedk/webgrind Webgrind is a Xdebug profiling web frontend in PHP5. It implements a subset of the features of kcachegrind and installs in seconds and works on all platforms. For quick'n'dirty optimizations it does the job. 3.3k193.0k](/packages/jokkedk-webgrind)[koriym/printo An object graph visualizer. 1421.8M2](/packages/koriym-printo)[soloterm/dumps A Laravel command to intercept dumps from your Laravel application. 125285.7k3](/packages/soloterm-dumps)[beyondcode/helo-laravel HELO Laravel debug helper 90360.1k](/packages/beyondcode-helo-laravel) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)