PHPackages laracraft-tech/laravel-xhprof - 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. laracraft-tech/laravel-xhprof ActiveLibrary[Debugging & Profiling](/categories/debugging) laracraft-tech/laravel-xhprof ============================= Easy XHProf setup to profile your laravel application! v1.3.0(5mo ago)235372.1k↓54.6%111MITPHPPHP >=7.1CI passing Since Apr 20Pushed 3mo ago2 watchersCompare [ Source](https://github.com/laracraft-tech/laravel-xhprof)[ Packagist](https://packagist.org/packages/laracraft-tech/laravel-xhprof)[ Docs](https://github.com/laracraft-tech/laravel-xhprof)[ RSS](/packages/laracraft-tech-laravel-xhprof/feed)WikiDiscussions 1.x Synced 2w ago READMEChangelog (10)Dependencies (2)Versions (17)Used By (1) [![Logo Laravel XHProf](https://camo.githubusercontent.com/ff41808d72a3c80457bd2161a701faeb32607bc436f7bb39c2f3d18b62dde31b/68747470733a2f2f692e696d6775722e636f6d2f6e73575a6b73352e706e67)](https://camo.githubusercontent.com/ff41808d72a3c80457bd2161a701faeb32607bc436f7bb39c2f3d18b62dde31b/68747470733a2f2f692e696d6775722e636f6d2f6e73575a6b73352e706e67) [![Total Downloads](https://camo.githubusercontent.com/dc6b188720b3a0b5b1694bcb788179e3e2aebd527398e9378047765421bdc452/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6c61726163726166742d746563682f6c61726176656c2d786870726f66)](https://packagist.org/packages/laracraft-tech/laravel-xhprof)[![Latest Stable Version](https://camo.githubusercontent.com/f26acbbb703d6c7b3ff9fa6dd291039cb64cbb68af07e8e209e2f812c527ee96/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6c61726163726166742d746563682f6c61726176656c2d786870726f66)](https://packagist.org/packages/laracraft-tech/laravel-xhprof)[![License](https://camo.githubusercontent.com/8f0364ed98b4a28577f097d90f70717daec14a35975bacde6db5d5b4b4f9b30c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6c61726163726166742d746563682f6c61726176656c2d786870726f66)](https://packagist.org/packages/laracraft-tech/laravel-xhprof)[![Laravel Compatibility](https://camo.githubusercontent.com/e7299035d945931c8634bf3121d54075aa4fc58e7c18e501080ecc1926be4145/68747470733a2f2f62616467652e6c61726176656c2e636c6f75642f62616467652f6c61726163726166742d746563682f6c61726176656c2d786870726f66)](https://packagist.org/packages/laracraft-tech/laravel-xhprof) Introduction ------------ [](#introduction) Laravel XHProf gives you a simple way to profile your Laravel application using the well-known XHProf PHP extension, originally developed by Facebook. It also walks you through setting up the XHProf UI, which lets you visualize, save, and analyze your profiling results. [![](https://camo.githubusercontent.com/669b22b30504eda8a1150fb81995b6a02b8a4254b371e61956fe9bb86bd670bb/68747470733a2f2f692e696d6775722e636f6d2f744e42686950672e706e67)](https://camo.githubusercontent.com/669b22b30504eda8a1150fb81995b6a02b8a4254b371e61956fe9bb86bd670bb/68747470733a2f2f692e696d6775722e636f6d2f744e42686950672e706e67) Installation ------------ [](#installation) First, you'll need to install the PHP extension. We highly recommend using Ondrej's PPA, since it's well maintained and covers pretty much every PHP version. ### Native PHP environment [](#native-php-environment) If you're running PHP natively on your system, just install the XHProf extension: ``` sudo add-apt-repository ppa:ondrej/php sudo apt-get update sudo apt-get install php php-xhprof Graphviz # Verify the extension is loaded php -i | grep xhprof # you might need to restart your webserver or php-fpm afterwards ``` Note: Graphviz is required to generate callgraphs. ### Laravel Sail environment [](#laravel-sail-environment) If you're using Laravel Sail, here's how to set things up: ``` sail up -d sail artisan sail:publish # Check docker-compose.yml to see which PHP version is used under build->context (e.g. ./docker/8.1) # Then open the matching Dockerfile: nano docker//Dockerfile # Find the block where all PHP extensions get installed and add "php-xhprof graphviz \" # Now rebuild Sail sail down ; sail build --no-cache ; sail up -d # this may take a while... # Verify the extension is loaded sail php -i | grep xhprof ``` Note: The provided Laravel Sail Dockerfile already uses Ondrej's PPA. ### Install the Package [](#install-the-package) ``` composer require laracraft-tech/laravel-xhprof --dev php artisan vendor:publish --provider="LaracraftTech\LaravelXhprof\XHProfServiceProvider" --tag="config" ``` ### Install the UI [](#install-the-ui) We use the fork by "preinheimer", which is the one recommended in the official PHP docs: ``` mkdir public/vendor ; git clone git@github.com:preinheimer/xhprof.git ./public/vendor/xhprof # If you haven't already, we recommend adding public/vendor to your .gitignore echo "/public/vendor" >> .gitignore ``` ### Database [](#database) The UI package stores and reads its profiling data from a table that is hard coded to `details`. If you already have a table with that name in your database, you'll need to take a few extra steps. Otherwise, here's the straightforward path: #### If you don't already have a `details` table in your database: [](#if-you-dont-already-have-a-details-table-in-your-database) ``` php artisan vendor:publish --provider="LaracraftTech\LaravelXhprof\XHProfServiceProvider" --tag="migrations" php artisan migrate ``` #### If you already have a `details` table in your database: [](#if-you-already-have-a-details-table-in-your-database) In this case we recommend using a separate database just for XHProf. ``` CREATE DATABASE xhprof; USE xhprof; CREATE TABLE IF NOT EXISTS `details` ( `id` char(64) COLLATE utf8mb4_unicode_ci NOT NULL, `url` char(255) COLLATE utf8mb4_unicode_ci DEFAULT NULL, `c_url` char(255) COLLATE utf8mb4_unicode_ci DEFAULT NULL, `timestamp` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, `server name` char(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL, `perfdata` longblob, `type` tinyint DEFAULT NULL, `cookie` longblob, `post` longblob, `get` blob, `pmu` int DEFAULT NULL, `wt` int DEFAULT NULL, `cpu` int DEFAULT NULL, `server_id` char(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL, `aggregateCalls_include` char(255) COLLATE utf8mb4_unicode_ci DEFAULT NULL, PRIMARY KEY (`id`), KEY `details_url_index` (`url`), KEY `details_c_url_index` (`c_url`), KEY `details_cpu_index` (`cpu`), KEY `details_wt_index` (`wt`), KEY `details_pmu_index` (`pmu`), KEY `details_timestamp_index` (`timestamp`), KEY `details_server name_timestamp_index` (`server name`,`timestamp`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; ``` Note: don't forget to create a user that has privileges on the new database! ### Config [](#config) Now let's configure a few settings: ``` cp public/vendor/xhprof/xhprof_lib/config.sample.php public/vendor/xhprof/xhprof_lib/config.php # 1. Adjust the DB credentials to match your setup # 2. Enable the dot_binary section # 3. If you're working locally, set $controlIPs to false nano public/vendor/xhprof/xhprof_lib/config.php ``` Usage ----- [](#usage) Just set `XHPROF_ENABLED=true` in your .env file, and from now on every request to your application will be profiled. Visit `/vendor/xhprof/xhprof_html/` to view the results. Happy analyzing! Security -------- [](#security) If you discover any security-related issues, please email instead of using the issue tracker. Credits ------- [](#credits) - [Zacharias Creutznacher](https://github.com/laracraft-tech) - [All Contributors](../../contributors) License ------- [](#license) MIT. Please see the [license file](license.md) for more information. ### Health Score 54 — FairBetter than 97% of packages Maintenance78 Regular maintenance activity Popularity53 Moderate usage in the ecosystem Community22 Small or concentrated contributor base Maturity52 Maturing project, gaining track record Bus Factor1 Top contributor holds 81.6% 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 ~106 days Recently: every ~238 days Total 15 Last Release 93d ago PHP version history (2 changes)v1.0.1PHP ^7.3|^8.0 v1.0.2PHP >=7.1 ### Community Maintainers ![](https://www.gravatar.com/avatar/cf347b32c0d1fceabbcbce7626ad662faa34738396fd9f774231d55370823713?d=identicon)[Sairahcaz](/maintainers/Sairahcaz) ![](https://www.gravatar.com/avatar/65c03df85c364040f9a6586a938c162ec0880a5f1f1ae9a119241abbbc189d26?d=identicon)[laracraft-tech](/maintainers/laracraft-tech) --- Top Contributors [![Sairahcaz](https://avatars.githubusercontent.com/u/7384870?v=4)](https://github.com/Sairahcaz "Sairahcaz (31 commits)")[![imanghafoori1](https://avatars.githubusercontent.com/u/6961695?v=4)](https://github.com/imanghafoori1 "imanghafoori1 (3 commits)")[![laravel-shift](https://avatars.githubusercontent.com/u/15991828?v=4)](https://github.com/laravel-shift "laravel-shift (2 commits)")[![a-bashtannik](https://avatars.githubusercontent.com/u/2712350?v=4)](https://github.com/a-bashtannik "a-bashtannik (1 commits)")[![ildyria](https://avatars.githubusercontent.com/u/627094?v=4)](https://github.com/ildyria "ildyria (1 commits)") --- Tags laravelperformancephpprofilerprofilingxhprofphplaravelprofilerprofilingprofilexhprof ### Embed Badge ![Health badge](/badges/laracraft-tech-laravel-xhprof/health.svg) ``` [![Health](https://phpackages.com/badges/laracraft-tech-laravel-xhprof/health.svg)](https://phpackages.com/packages/laracraft-tech-laravel-xhprof) ``` ### Alternatives [bavix/laravel-xhprof Quick profiling of your code for Laravel 22157.8k](/packages/bavix-laravel-xhprof)[fruitcake/laravel-telescope-toolbar Toolbar for Laravel Telescope based on Symfony Web Profiler 8051.8M6](/packages/fruitcake-laravel-telescope-toolbar)[unopim/unopim UnoPim Laravel PIM 10.8k2.5k](/packages/unopim-unopim)[api-platform/laravel API Platform support for Laravel 58190.1k21](/packages/api-platform-laravel)[ecotone/laravel Ecotone for Laravel — CQRS, Event Sourcing, Sagas, Durable Workflows, and Outbox on top of Laravel Queue, via PHP attributes. 21327.3k4](/packages/ecotone-laravel) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)