PHPackages                             lekoala/silverstripe-debugbar - 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. lekoala/silverstripe-debugbar

ActiveSilverstripe-vendormodule[Debugging & Profiling](/categories/debugging)

lekoala/silverstripe-debugbar
=============================

DebugBar for SilverStripe CMS

4.0.1(8mo ago)55252.9k↓33.1%28[1 issues](https://github.com/lekoala/silverstripe-debugbar/issues)1MITPHPPHP ^8.3CI failing

Since Oct 20Pushed 8mo ago5 watchersCompare

[ Source](https://github.com/lekoala/silverstripe-debugbar)[ Packagist](https://packagist.org/packages/lekoala/silverstripe-debugbar)[ RSS](/packages/lekoala-silverstripe-debugbar/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (10)Dependencies (8)Versions (48)Used By (1)

SilverStripe DebugBar module
============================

[](#silverstripe-debugbar-module)

[![Build Status](https://github.com/lekoala/silverstripe-debugbar/actions/workflows/ci.yml/badge.svg)](https://github.com/lekoala/silverstripe-debugbar/actions/workflows/ci.yml/badge.svg)[![scrutinizer](https://camo.githubusercontent.com/de9208f632daf78a51ae26b2384d6892fc8b16515bb57da5268b9d6be2b58f29/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6c656b6f616c612f73696c7665727374726970652d64656275676261722f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/lekoala/silverstripe-debugbar/)[![Code coverage](https://camo.githubusercontent.com/d3286f591f0d17143d7a5df6755985f428800abb04f1b67da9b69873b863dab8/68747470733a2f2f636f6465636f762e696f2f67682f6c656b6f616c612f73696c7665727374726970652d64656275676261722f6272616e63682f6d61737465722f67726170682f62616467652e737667)](https://codecov.io/gh/lekoala/silverstripe-debugbar)

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

[](#installation)

You can install the debug bar with Composer:

```
composer require --dev lekoala/silverstripe-debugbar
```

> Note: This module currently only works with the standard [template engine](https://github.com/silverstripe/silverstripe-template-engine) that renders .ss files.

Documentation
-------------

[](#documentation)

- [Introduction](#introduction)
- [Execution timeline](#execution-timeline)
- [Database profiling](#database-profiling)
- [System logs and messages](#system-logs-and-messages)
- [Template use](#template-use)
- [Partial caching hits and misses](#partial-caching-hits-and-misses)
- [Environment and other information](#environment-and-other-information)
- [Helper methods](#helper-methods)
- [Configuration options](#configuration-options)
- [Troubleshooting](#troubleshooting)

### Introduction

[](#introduction)

SilverStripe Debug Bar is a wrapper for [PHP DebugBar](http://phpdebugbar.com) which integrates with SilverStripe to provide more useful information about your projects. The Debug Bar can help you to easily identify performance issues, analyse environment settings and discover which parts of your code are being used.

For example, if your application is running the same database query multiple times in a loop, or a certain controller action is taking a long time to run, Debug Bar will highlight these bottlenecks so you can take steps to improve your overall site performance.

This module will:

- Log framework execution based on available hooks
- Log and profile database calls
- Show all SilverStripe log entries
- Show all session, cookie, requirements, SiteConfig and request data
- Show current locale, framework/CMS version, current member
- Show request timing/profiling and memory consumption

The DebugBar is automatically injected into any HTML response through the `DebugBarMiddleware`, and will only run in "dev" mode.

[![Screenshot](docs/_images/screenshot.png)](docs/_images/screenshot.png)

### Execution timeline

[](#execution-timeline)

The execution timeline ("Timeline" tab) provides you with a graphical overview of each controller and action, listing how long it takes for each to complete.

[![Execution timeline](docs/_images/timeline.png)](docs/_images/timeline.png)

The example above is from loading a page in the CMS.

You can also use our helper `DebugBar::trackTime` in order to start/stop a given measure. This will also work even before DebugBar is initialized allowing you, for example, to measure boot up time like this:

```
DebugBar::trackTime('create_request');
$request = HTTPRequestBuilder::createFromEnvironment();
// This line is optional : you can close it or it will be closed automatically before pre_request
DebugBar::trackTime('create_request');
```

Speaking of boot time, you can get a more accurate measure than the one provided by `$_SERVER['REQUEST_TIME_FLOAT']` by defining the following constant in your `index.php` file.

```
require dirname(__DIR__) . '/vendor/autoload.php';
define('FRAMEWORK_BOOT_TIME', microtime(true));
```

This will give you a distinct php and framework boot time. This way, you can measure, for instance, the effects of doing a `composer dumpautoload -o` on your project.

Note : any pending measure will be closed automatically before the `pre_request` measure.

### Database profiling

[](#database-profiling)

The "Database" tab allows you to view a list of all the database operations that a page request has made, and will group duplicated queries together. This can be useful to identify areas where performance can be improved, such as using `DataObject::get_by_id()` (which caches the result) instead of `DataObject::get()->byID()`.

[![Database profiling](docs/_images/database.png)](docs/_images/database.png)

By clicking on one of the duplicate group badges in the bottom right corner, you can see groups of duplicated queries:

[![Duplicate grouping](docs/_images/database-duplicates.png)](docs/_images/database-duplicates.png)

To help you in debugging and optimising your application, it is recommended to leave the `find_source` option on. This will help you to identify what triggers the query and where to implement caching appropriately.

If you are using `?showqueries=1`, you will also see that the usage has been optimised to display all queries nicely and their result on the page.

Also remember that if you use [the `d()` helper](helpers.md), any string variable with "sql" in the name will be formatted as a SQL string.

#### Long running queries

[](#long-running-queries)

When some queries take a long time to run they will be highlighted in red, with the request time (right hand side per item) highlighted in bold red text. The threshold for this time can be adjusted by modifying the `DebugBar.warn_dbqueries_threshold_seconds` [configuration](configuration.md) setting.

[![Long running queries](docs/_images/database-long-running.png)](docs/_images/database-long-running.png)

**Note:** The above example has been adjusted to be deliberately short. The default threshold value is one second for a long running query.

#### Large numbers of queries

[](#large-numbers-of-queries)

If a page request performance is more than a certain number of queries, a warning message will be sent to the "Messages" tab. You can adjust the threshold for this with the `DebugBar.warn_query_limit` configuration setting.

[![Query threshold warning](docs/_images/database-query-threshold.png)](docs/_images/database-query-threshold.png)

### System logs and messages

[](#system-logs-and-messages)

The "Messages" tab will show you a list of anything that has been processed by [a SilverStripe logger](https://docs.silverstripe.org/en/5/developer_guides/debugging/error_handling/) during a page execution:

[![System logs and messages](docs/_images/messages.png)](docs/_images/messages.png)

You can filter the list by type by clicking on one of the log level buttons in the bottom right corner.

**Note:** At times, other DebugBar components may also send messages to this tab.

### Template use

[](#template-use)

The "Templates" tab will show you how many template calls were made, and the file path relative to the project root directory for each.

This will only be populated when you are flushing your cache (`?flush=1`). When templates are cached, a notice will be displayed letting you know to flush to see the full list.

[![Templates](docs/_images/templates.png)](docs/_images/templates.png)

### Partial caching hits and misses

[](#partial-caching-hits-and-misses)

The "TemplateCache" tab shows how effective your chosen partial cache key is (e.g. `...`). It does this by indicating whether a key has hit a cache or not.

[![Partial caching](docs/_images/templateCache.png)](docs/_images/templateCache.png)

### Environment and other information

[](#environment-and-other-information)

There is a variety of other useful information available via various tabs and indicators on the debug bar. See the screenshot below, and the arrows explained in order from left to right:

[![Other indicators](docs/_images/other.png)](docs/_images/other.png)

#### Tabs

[](#tabs)

- **Session:** Displays a list of everything in your current SilverStripe session
- **Cookies:** Displays a list of all cookies available in a request
- **Parameters:** Displays all GET, POST and ROUTE parameters from the current request
- **Config:** Displays a list of the current [SiteConfig](https://github.com/silverstripe/silverstripe-siteconfig) settings from the CMS
- **Requirements:** Shows a list of all [`Requirements`](https://docs.silverstripe.org/en/developer_guides/templates/requirements/) calls made during a page's execution
- **Middlewares:** Shows a list of all [`Middlewares`](https://docs.silverstripe.org/en/5/developer_guides/controllers/middlewares/) used for this request
- **Mails:** Shows a list of all [emails](https://docs.silverstripe.org/en/5/developer_guides/email/) sent
- **Headers:** Shows a list of all headers

#### Indicators

[](#indicators)

Hover over indicators to see:

- **Locale:** The locale currently being used in the site
- **Version:** The current SilverStripe software version being used
- **User:** The name of the user currently logged in
- **Memory usage:** The amount of memory used to generate a page
- **Request time:** The total time to generate a page (see below)

##### Request time

[](#request-time)

The request time indicator shows you how long it took for the server to render a page, it doesn't include the time your browser takes to render it. You can use browser consoles to profile this aspect.

- For a regular page load, the request time will have a green underline to indicate a healthy speed
- For a slower page load, the request time will have an orange underline to indicate that it took longer than it perhaps should have, but is still OK
- For a long page load, the request time will have a red underline to indicate that it is potentially dangerously slow

The threshold for a dangerously slow page load can be configured with the `DebugBar.warn_request_time_seconds` [configuration](configuration.md) setting.

The threshold for a slower/warning level indicator is defined as a percentage of the dangerous threshold (by default, 50%). This can be adjusted by modifying the `DebugBar.warn_warning_ratio` configuration setting.

### Helper methods

[](#helper-methods)

#### Quick debugging

[](#quick-debugging)

The `d()` function helps you to quickly debug code. It will use the [Symfony VarDumper](https://github.com/symfony/var-dumper) to display the data in a "pretty" way.

In an XHR/AJAX context, it will simply display the data in a more simple fashion.

When `d()` is called without arguments, it will display all objects in [the debug backtrace](http://php.net/manual/en/function.debug-backtrace.php). It will display the variable name before its content to make it easy to identify data amongst multiple values.

```
d($myvar, $myothervar);
```

Any call to `d()` with "sql" in the name of the variable will output a properly formatted SQL query, for instance:

```
d($myDataList->sql());
```

You can also use `DebugBarUtils::formatSql` in your projects if needed.

#### Quick logging

[](#quick-logging)

The `l()` function helps you to log messages, and since they will appear in the "Messages" tab, it is very useful.

```
l('My message');
```

### Configuration options

[](#configuration-options)

Wherever possible, features and settings have been made configurable. You can see a list of the default configuration settings by looking at `_config/debugbar.yml`. To modify any of these settings you can define a YAML configuration block in your `mysite/_config` folder, for example:

**mysite/\_config/debugbar.yml:**

```
---
Name: mysitedebugbar
---
LeKoala\DebugBar\DebugBar:
  enabled_in_admin: false
  query_limit: 500
```

#### Settings

[](#settings)

SettingTypeDescription`enable_storage`boolStore all previous request in the temp folder (enabled by default)`auto_debug`boolAutomatically collect debug and debug\_request data (disabled by default)`ajax`boolAutomatically inject data in XHR requests (disabled by default, since this makes the Chrome request inspector very slow due to the large amount of header data)`check_local_ip`boolDo not display the DebugBar if not using a local ip (enabled by default)`find_source`boolTrace which file generates a database query (enabled by default)`enabled_in_admin`boolenable DebugBar in the CMS (enabled by default)`include_jquery`boolLet DebugBar include jQuery. Set this to false to include your own jQuery version`query_limit`intMaximum number of database queries to display (200 by default for performance reasons)`warn_query_limit`intNumber of database queries before a warning will be displayed`performance_guide_link`stringWhen a warning is shown for a high number of DB queries, the following link will be used for a performance guide`warn_dbqueries_threshold_seconds`intThreshold (seconds) for how long a database query can run for before it will be shown as a warning`warn_request_time_seconds`intThreshold (seconds) for what constitutes a *dangerously* long page request (upper limit)`warn_warning_ratio`floatRatio to divide the warning request time by to get the *warning* level (default 0.5)`show_namespace`boolShow the fully qualified namespace in the Database tab when set to true. Defaults to false`db_collector`boolShow the db tab. Defaults to true`db_save_csv`boolSave queries to csv in the temp folder. Use ?downloadqueries to download current. Defaults to false`config_collector`boolShow the config tab. Defaults to true`cache_collector`boolShow the cache tab. Defaults to true`cache_collector_show_get`boolDisplay get calls in cache tab. Defaults to false`partial_cache_collector`boolShow the partial cache tab. Defaults to true`email_collector`boolShow the email tab. Defaults to true`header_collector`boolShow the headers tab. Defaults to true#### Disabling the debug bar

[](#disabling-the-debug-bar)

You can disable the debug bar with PHP or configuration:

```
putenv('DEBUGBAR_DISABLE=true');
```

```
LeKoala\DebugBar\DebugBar:
  disabled: true
```

### Troubleshooting

[](#troubleshooting)

#### Using Vagrant

[](#using-vagrant)

If you are using Vagrant (or presumably Docker or other virtualisation) and the DebugBar isn't showing up, make sure you have the `check_local_ip` config option set to `false`. This is due to the way Vagrant and Virtualbox configure networking by default.

#### Managing jQuery

[](#managing-jquery)

The DebugBar will include its own version of jQuery by default. It will only be disabled in the admin (which already use jQuery).

If you have added jQuery in your requirements the DebugBar will not load its own jQuery version (if the filename is jquery.js or jquery.min.js). You can also set the following configuration flag to false to prevent the DebugBar from including its own jQuery.

```
LeKoala\DebugBar\DebugBar:
  include_jquery: false
```

If you are including jQuery yourself, it is expected you include it in `Page::init()`. Below is an example of how to the jQuery which ships with the framework:

```
protected function init()
{
    parent::init();
    Requirements::javascript('framework/thirdparty/jquery/jquery.min.js');
}
```

When using the simple theme, you probably want to disable the jquery from the cdn.

```
protected function init()
{
    parent::init();
    Requirements::block("//code.jquery.com/jquery-3.3.1.min.js");
}
```

If you include jQuery during an action, you need to call `DebugBar::suppressJquery();`. This will move all our scripts after your own, which should include Jquery first.

```
public function my_action()
{
    DebugBar::suppressJquery();
    Requirements::javascript("//code.jquery.com/jquery-3.3.1.min.js");
    Requirements::javascript("my.plugin.js");

    return $this;
}
```

#### FulltextSearchable support

[](#fulltextsearchable-support)

It has been reported that the `FulltextSearchable` extension conflicts with the `config_collector`.

If you happen to have an issue (eg: your $SearchForm not being printed), please disable the `config_collector`.

#### A quick note about the Security Page

[](#a-quick-note-about-the-security-page)

`LeKoala\DebugBar\Extension\ControllerExtension` will include for you all the required assets for DebugBar.

This is done using the `onAfterInit` extension hook, however on the `Security` controller the `onAfterInit` is called before your `init()`method in the `PageController`.

Since you need to add jQuery before DebugBar this may be a problem, and therefore requirements will NOT be included on the `Security` controller.

If you want DebugBar to work on the `Security` controller, make sure to include all relevant requirements by calling `DebugBar::includeRequirements();` after you include jQuery. When DebugBar is disabled this call will be ignored. Also note that any subsequent call to this method will be ignored as well.

#### Customize DebugBar css

[](#customize-debugbar-css)

Any customisation to the default css (as stored in "assets") should be made to css/custom.css. This file will be appended to the default css.

#### More than one body

[](#more-than-one-body)

If you more than one body tag, the middleware will fail to insert properly the required scripts. If that happens, you can use the placeholder in your page template. This is where the scripts will be inserted.

### \*903 upstream sent too big header

[](#903-upstream-sent-too-big-header)

When using nginx you can run into this error. This is due to the `proxy_buffer` being to small to send all response headers.

The recommended config on official guide is:

location /index.php { fastcgi\_buffer\_size 32k; fastcgi\_busy\_buffers\_size 64k; fastcgi\_buffers 4 32k; ... }

You can tweak the settings like so (adjust the values depending on your needs):

location ~ .php$ { fastcgi\_buffer\_size 1024k; fastcgi\_busy\_buffers\_size 2048k; fastcgi\_buffers 4 1024k; ... }

---

Maintainer
----------

[](#maintainer)

LeKoala -

License
-------

[](#license)

This module is licensed under the [MIT license](LICENSE).

###  Health Score

61

—

FairBetter than 98% of packages

Maintenance59

Moderate activity, may be stable

Popularity49

Moderate usage in the ecosystem

Community29

Small or concentrated contributor base

Maturity91

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 64.1% 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 ~71 days

Recently: every ~20 days

Total

47

Last Release

260d ago

Major Versions

1.x-dev → 2.0.32019-04-05

2.2.1 → 3.0.0-beta12023-07-27

2.2.2 → 3.0.22024-02-08

2.x-dev → 3.0.52024-03-25

3.1.x-dev → 4.0.02025-07-28

PHP version history (7 changes)0.1.0PHP >=5.4.8

1.0.0PHP >=5.3.3

2.0.0-beta1PHP >=5.6

1.2.x-devPHP >=5.5

2.2.0PHP ^7.4 || ^8.0

3.0.0-beta1PHP ^8.1

4.0.0PHP ^8.3

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/250762?v=4)[Thomas Portelange](/maintainers/lekoala)[@lekoala](https://github.com/lekoala)

---

Top Contributors

[![lekoala](https://avatars.githubusercontent.com/u/250762?v=4)](https://github.com/lekoala "lekoala (282 commits)")[![robbieaverill](https://avatars.githubusercontent.com/u/5170590?v=4)](https://github.com/robbieaverill "robbieaverill (108 commits)")[![GuySartorelli](https://avatars.githubusercontent.com/u/36352093?v=4)](https://github.com/GuySartorelli "GuySartorelli (14 commits)")[![Firesphere](https://avatars.githubusercontent.com/u/680570?v=4)](https://github.com/Firesphere "Firesphere (7 commits)")[![sachajudd](https://avatars.githubusercontent.com/u/24258161?v=4)](https://github.com/sachajudd "sachajudd (6 commits)")[![sabina-talipova](https://avatars.githubusercontent.com/u/87288324?v=4)](https://github.com/sabina-talipova "sabina-talipova (2 commits)")[![andrewandante](https://avatars.githubusercontent.com/u/9702648?v=4)](https://github.com/andrewandante "andrewandante (2 commits)")[![dizzystuff](https://avatars.githubusercontent.com/u/576903?v=4)](https://github.com/dizzystuff "dizzystuff (2 commits)")[![wernerkrauss](https://avatars.githubusercontent.com/u/1043925?v=4)](https://github.com/wernerkrauss "wernerkrauss (2 commits)")[![pine3ree](https://avatars.githubusercontent.com/u/3229979?v=4)](https://github.com/pine3ree "pine3ree (2 commits)")[![satrun77](https://avatars.githubusercontent.com/u/166450?v=4)](https://github.com/satrun77 "satrun77 (1 commits)")[![torleif](https://avatars.githubusercontent.com/u/67215?v=4)](https://github.com/torleif "torleif (1 commits)")[![adrhumphreys](https://avatars.githubusercontent.com/u/10803137?v=4)](https://github.com/adrhumphreys "adrhumphreys (1 commits)")[![Zazama](https://avatars.githubusercontent.com/u/7694808?v=4)](https://github.com/Zazama "Zazama (1 commits)")[![andrewnick](https://avatars.githubusercontent.com/u/8042392?v=4)](https://github.com/andrewnick "andrewnick (1 commits)")[![callan-stretton](https://avatars.githubusercontent.com/u/29969836?v=4)](https://github.com/callan-stretton "callan-stretton (1 commits)")[![chillu](https://avatars.githubusercontent.com/u/111025?v=4)](https://github.com/chillu "chillu (1 commits)")[![djmattski](https://avatars.githubusercontent.com/u/3836638?v=4)](https://github.com/djmattski "djmattski (1 commits)")[![emteknetnz](https://avatars.githubusercontent.com/u/4809037?v=4)](https://github.com/emteknetnz "emteknetnz (1 commits)")[![fspringveldt](https://avatars.githubusercontent.com/u/10938392?v=4)](https://github.com/fspringveldt "fspringveldt (1 commits)")

---

Tags

debugbarmodulesilverstripesilverstripe-4silverstripe-5silverstripe-moduledebugbarsilverstripecmsmodule

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/lekoala-silverstripe-debugbar/health.svg)

```
[![Health](https://phpackages.com/badges/lekoala-silverstripe-debugbar/health.svg)](https://phpackages.com/packages/lekoala-silverstripe-debugbar)
```

###  Alternatives

[barryvdh/laravel-debugbar

PHP Debugbar integration for Laravel

19.3k133.0M756](/packages/barryvdh-laravel-debugbar)[fruitcake/laravel-debugbar

PHP Debugbar integration for Laravel

19.3k2.3M65](/packages/fruitcake-laravel-debugbar)[silverstripe/cms

The SilverStripe Content Management System

5253.6M1.4k](/packages/silverstripe-cms)[lekoala/silverstripe-cms-actions

Add actions to your models in SilverStripe

39344.8k31](/packages/lekoala-silverstripe-cms-actions)[axyr/silverstripe-adminlogin

Use a custom login screen to log in to the admin section

165.8k](/packages/axyr-silverstripe-adminlogin)

PHPackages © 2026

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