PHPackages                             devstudio-rs/wpmvc-debug - 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. devstudio-rs/wpmvc-debug

ActiveLibrary

devstudio-rs/wpmvc-debug
========================

Debug toolbar for the WPMVC framework

v0.6.0(1mo ago)04↓66.7%MITPHPPHP >=7.0

Since Jul 17Pushed 1mo agoCompare

[ Source](https://github.com/devstudio-rs/wpmvc-debug)[ Packagist](https://packagist.org/packages/devstudio-rs/wpmvc-debug)[ RSS](/packages/devstudio-rs-wpmvc-debug/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (3)DependenciesVersions (4)Used By (0)

WPMVC Debug
===========

[](#wpmvc-debug)

A debug toolbar for the [WPMVC framework](https://wpmvc.devstudio.rs). It adds a floating button to the front end that opens a panel with everything you need to inspect a request while developing: the initialized applications, their components, database queries, logs, scheduled cron jobs and the server environment.

It is a **development tool** — install it as a dev dependency and enable it only in local/debug environments. The panel reads state and never alters your application (the only writes are the explicit, admin-only log/cron actions).

- Bundled UI: Bootstrap 5.3 compiled with a `wpmvc-` prefix on every class and CSS variable, so it can't clash with a theme that already loads Bootstrap.
- Light/dark theme (dark by default), pinnable so it survives page reloads.
- No dependencies pulled at runtime; the framework is provided by the host app.

Requirements
------------

[](#requirements)

- PHP 7.0+
- WordPress with the WPMVC framework installed
- The package must live under `ABSPATH` (it derives its own asset URL from its location).

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

[](#installation)

Install as a dev dependency:

```
composer require --dev devstudio-rs/wpmvc-debug
```

Register it as a `debug` component in your application config, and add it to `bootstrap` only in debug environments so it is never active in production:

```
// config/main.php
'bootstrap' => WP_DEBUG ? array( 'view', 'debug' ) : array( 'view' ),

'components' => array(
    // ...
    'debug' => array(
        'class' => \wpmvc\debug\Debug::class,
    ),
),
```

That's all — the component enqueues its assets and renders the panel on `wp_footer`. The panel is shown to everyone while enabled, but the log/cron actions are restricted to users with `manage_options`.

> **Database queries** are captured through WordPress's `SAVEQUERIES`. The component defines it automatically when it isn't already set; to capture the queries that run *before* the debugger loads, define `SAVEQUERIES` in `wp-config.php`.

Sections
--------

[](#sections)

### Overview

[](#overview)

General information about the current request at a glance: method and path, the current user, environment and debug flag, PHP/WordPress versions and performance (peak memory + time). Below it, the loaded applications and a preview of the registered components, each linking to its full tab.

[![Overview](docs/images/overview.png)](docs/images/overview.png)

### Applications

[](#applications)

Every initialized WPMVC application instance, with its class, path and domain, and how many components are declared, how many have actually been loaded (lazy loading), how many are eager-loaded via `bootstrap`, and its registered route count.

[![Applications](docs/images/applications.png)](docs/images/applications.png)

### Components

[](#components)

Every component declared across all applications, searchable and filterable by application. Each row expands to show whether it is loaded or still lazy, if it is a bootstrap component, and the config it was declared with.

[![Components](docs/images/components.png)](docs/images/components.png)

### Database

[](#database)

The queries executed during the request (from `$wpdb->queries`), with a summary of the query count, total time, slow queries and the database server. The list is searchable, filterable by query type and sortable by time. Each query expands to show the full SQL, its timing and the call stack that triggered it.

[![Database](docs/images/database.png)](docs/images/database.png)

### Logs

[](#logs)

Two sub-tabs: the **WordPress** debug log (`WP_DEBUG_LOG`) and the **Logger**component's own files. Entries are grouped by level, searchable and filterable, and each expands to its full message (including multi-line stack traces). Administrators get a **Clear** button per log.

[![Logs](docs/images/logs.png)](docs/images/logs.png)

### Events

[](#events)

The WordPress actions and filters fired during the request, aggregated per hook: type, fire count, total execution time and when it first fired. The list is searchable, filterable by type and sortable by time (to surface the slowest hooks first). Each row expands to timing details and the callbacks registered on the hook (priority, source, file and line). A **Timeline** sub-tab charts every hook as a bar — positioned at its first fire within the request, sized by the total time spent in its callbacks.

Capture starts when the component boots, so hooks fired earlier in the bootstrap (mu-plugins and plugins loading) are not recorded. High-frequency noise hooks (translations, escaping, per-option/transient reads) are excluded, and recording is capped at 500 unique hooks per request.

[![Events](docs/images/events.png)](docs/images/events.png)

### Scheduled Jobs

[](#scheduled-jobs)

The WP-Cron schedule (`_get_cron_array()`): every event with its next run, recurrence, arguments and status, plus summary stats. Administrators can expand a job to **run it now** or **delete** it.

[![Scheduled Jobs](docs/images/scheduled-jobs.png)](docs/images/scheduled-jobs.png)

### Cache

[](#cache)

What WordPress's caching layers actually expose, in three sub-tabs: **Object Cache** — the active backend (core's in-memory cache or a persistent drop-in), this request's hits/misses and hit rate, and the cache contents per group with item counts and approximate sizes; **Transients** — every transient in the database with its scope, expiry state and size; **Autoloaded Options** — how many options load on every request, their combined size, and the largest ones. Administrators can flush the object cache (persistent backends only) and delete expired transients.

[![Cache](docs/images/cache.png)](docs/images/cache.png)

### Environment

[](#environment)

Server, PHP, WordPress and database configuration, the loaded PHP extensions, environment variables (secrets masked) and notable filesystem paths.

[![Environment](docs/images/environment.png)](docs/images/environment.png)

License
-------

[](#license)

MIT

###  Health Score

31

—

LowBetter than 65% of packages

Maintenance91

Actively maintained with recent releases

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity21

Early-stage or recently created project

 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 ~0 days

Total

3

Last Release

45d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/4865305?v=4)[Miloš Petković](/maintainers/mpetkovic)[@mpetkovic](https://github.com/mpetkovic)

---

Top Contributors

[![mpetkovic](https://avatars.githubusercontent.com/u/4865305?v=4)](https://github.com/mpetkovic "mpetkovic (1 commits)")

### Embed Badge

![Health badge](/badges/devstudio-rs-wpmvc-debug/health.svg)

```
[![Health](https://phpackages.com/badges/devstudio-rs-wpmvc-debug/health.svg)](https://phpackages.com/packages/devstudio-rs-wpmvc-debug)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)