PHPackages                             sympress/profiler - 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. sympress/profiler

ActiveWordpress-muplugin[Debugging & Profiling](/categories/debugging)

sympress/profiler
=================

Profiler and web debug toolbar for the WordPress kernel.

1.0.1(1mo ago)1144GPL-2.0-or-laterPHPPHP ^8.5CI passing

Since Jun 14Pushed 1w agoCompare

[ Source](https://github.com/SymPress/profiler)[ Packagist](https://packagist.org/packages/sympress/profiler)[ RSS](/packages/sympress-profiler/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (2)Dependencies (6)Versions (3)Used By (0)

SymPress Profiler
=================

[](#sympress-profiler)

[![Checks](https://camo.githubusercontent.com/067640584c1260a2bc242069bc0f32936510d486fc075fe605269e5681f0ee66/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f53796d50726573732f70726f66696c65722f71612e796d6c3f6272616e63683d6d61696e266c6162656c3d636865636b73)](https://github.com/SymPress/profiler/actions/workflows/qa.yml) [![Release](https://camo.githubusercontent.com/2859a978c5dfe6090f4351c0da7ed2a686128f448bb98daf6a224ec83f828f93/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f53796d50726573732f70726f66696c65723f6c6162656c3d72656c65617365)](https://github.com/SymPress/profiler/releases) [![PHP](https://camo.githubusercontent.com/3d605c15265ef95a17a126fbf3255e52018eea65905ae3a699b057cf665505b7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646570656e64656e63792d762f73796d70726573732f70726f66696c65722f7068702e7376673f6c6162656c3d706870)](https://packagist.org/packages/sympress/profiler) [![Downloads](https://camo.githubusercontent.com/f29212951926ddae1276f6dd8aeb99fede7bd1e1081dd4e1b16538125d2ca170/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f73796d70726573732f70726f66696c65722e7376673f6c6162656c3d646f776e6c6f616473)](https://packagist.org/packages/sympress/profiler/stats) [![License: GPL-2.0-or-later](https://camo.githubusercontent.com/26f8b6541ea045cc1dbc2267208158b5a7ebbf5cf437c4b486d80fee9386f77e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d47504c2d2d322e302d2d6f722d2d6c617465722d626c75652e737667)](LICENSE) [![Security Policy](https://camo.githubusercontent.com/7a0ecd25391c2821401e28d753557f53c5fe267b349b8b4032bb4ca1ef462ee7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f73656375726974792d706f6c6963792d3265613434662e737667)](SECURITY.md)

Profiler and web debug toolbar for SymPress WordPress kernel applications.

The package records request, runtime, WordPress, and rendering data during development and exposes it through an in-browser toolbar and profiler pages. It is distributed as a Composer-powered WordPress MU plugin and integrates with the SymPress kernel service container.

Installation
------------

[](#installation)

```
composer require sympress/profiler
```

The package requires PHP 8.5, WordPress 6.9 or newer, and `sympress/kernel`.

Features
--------

[](#features)

- Symfony-style web debug toolbar for WordPress frontoffice requests
- Profiler pages with searchable stored profiles
- Request, response, performance, memory, and PHP error collection
- WordPress data collectors for hooks, templates, blocks, assets, REST/AJAX, options, cache, cron, plugins, themes, queries, and localization
- HTTP client, database, security, kernel, and runtime diagnostics
- Filesystem profile storage under the kernel cache directory
- Development-only access by default with filter-based overrides
- Optional `SAVEQUERIES` activation for local debug environments
- Bundled toolbar icons, styles, templates, and font assets

Usage
-----

[](#usage)

When the SymPress kernel discovers the package, it registers `SymPress\Profiler\ProfilerBundle` and loads `profiler/profiler.php` as the MU plugin entry point.

The profiler collects frontoffice requests in local and development environments by default. The toolbar links each request to a stored profile with all collector panels.

See [`docs/architecture.md`](docs/architecture.md) for the hook and persistence lifecycle. Collector keys, priorities, payload fields, and sensitive data are cataloged in [`docs/collectors.json`](docs/collectors.json).

```