class DebugBar (View source)

A simple helper

Traits

Provides extensions to this object to integrate it with standard config API methods.

A class that can be instantiated or replaced via DI

Properties

protected static DebugBar $debugbar
public static bool $bufferingEnabled
protected static JavascriptRenderer $renderer
protected static bool $showQueries
protected static HTTPRequest $request
protected static array $extraTimes

Methods

public static 
config()

Get a configuration accessor for this class. Short hand for Config::inst()->get($this->class, .....).

public
mixed
stat(string $name) deprecated

Get inherited config value

public
mixed
uninherited(string $name)

Gets the uninherited value for the given config option

public
$this
set_stat(string $name, mixed $value) deprecated

Update the config value for a given property

public static 
create(mixed ...$args)

An implementation of the factory method, allows you to create an instance of a class

public static 
singleton(string $class = null)

Creates a class instance by the "singleton" design pattern.

public static 
DebugBar
getDebugBar()

Get the Debug Bar instance

public static 
DebugBar|null
initDebugBar()

Init the debugbar instance

protected static 
mixed
getProtectedValue(object $object, string $property)

Access a protected property when the api does not allow access

protected static 
void
setProtectedValue(object $object, string $property, mixed $newValue)

Set a protected property when the api does not allow access

public static 
void
clearDebugBar()

Clear the current instance of DebugBar

public static 
bool
getShowQueries()

No description

public static 
void
setShowQueries(bool $showQueries)

Override default showQueries mode

public static 
moduleResource(string $path)

Helper to access this module resources

public static 
void
includeRequirements()

Include DebugBar assets using Requirements API

public static 
string
renderDebugBar()

Returns the script to display the DebugBar

public static 
array
disabledCriteria()

Get all criteria why the DebugBar could be disabled

public static 
string
whyDisabled()

Determine why DebugBar is disabled

public static 
vendorNotInstalled()

No description

public static 
notLocalIp()

No description

public static 
allowAllEnvironments()

No description

public static 
isDisabled()

No description

public static 
isDevUrl()

No description

public static 
isAdminUrl()

No description

public static 
isAdminController()

No description

public static 
bool
isDebugBarRequest()

Avoid triggering data collection for open handler

public static 
string
getRequestUrl()

Get request url

public static 
withDebugBar(callable $callback)

Helper to make code cleaner

public static 
setRequest(HTTPRequest $request)

Set the current request. Is provided by the DebugBarMiddleware.

public static 
getRequest()

Get the current request

public static 
getTimeCollector()

No description

public static 
MessagesCollector|false
getMessageCollector()

No description

public static 
void
trackTime(string $label)

Start/stop time tracking (also before init)

public static 
void
closeExtraTime()

Close any open extra time record

public static 
measureExtraTime()

Add extra time to time collector

Details

static Config_ForClass config()

Get a configuration accessor for this class. Short hand for Config::inst()->get($this->class, .....).

Return Value

Config_ForClass

mixed stat(string $name) deprecated

deprecated 5.0 Use ->config()->get() instead

Get inherited config value

Parameters

string $name

Return Value

mixed

mixed uninherited(string $name)

Gets the uninherited value for the given config option

Parameters

string $name

Return Value

mixed

$this set_stat(string $name, mixed $value) deprecated

deprecated 5.0 Use ->config()->set() instead

Update the config value for a given property

Parameters

string $name
mixed $value

Return Value

$this

static Injectable create(mixed ...$args)

An implementation of the factory method, allows you to create an instance of a class

This method will defer class substitution to the Injector API, which can be customised via the Config API to declare substitution classes.

This can be called in one of two ways - either calling via the class directly, or calling on Object and passing the class name as the first parameter. The following are equivalent: $list = DataList::create(SiteTree::class); $list = SiteTree::get();

Parameters

mixed ...$args

Return Value

Injectable

static Injectable singleton(string $class = null)

Creates a class instance by the "singleton" design pattern.

It will always return the same instance for this class, which can be used for performance reasons and as a simple way to access instance methods which don't rely on instance data (e.g. the custom SilverStripe static handling).

Parameters

string $class

Optional classname to create, if the called class should not be used

Return Value

Injectable

The singleton instance

static DebugBar getDebugBar()

Get the Debug Bar instance

Return Value

DebugBar

Exceptions

Exception

static DebugBar|null initDebugBar()

Init the debugbar instance

Return Value

DebugBar|null

static protected mixed getProtectedValue(object $object, string $property)

Access a protected property when the api does not allow access

Parameters

object $object
string $property

Return Value

mixed

static protected void setProtectedValue(object $object, string $property, mixed $newValue)

Set a protected property when the api does not allow access

Parameters

object $object
string $property
mixed $newValue

Return Value

void

static void clearDebugBar()

Clear the current instance of DebugBar

Return Value

void

static bool getShowQueries()

No description

Return Value

bool

static void setShowQueries(bool $showQueries)

Override default showQueries mode

Parameters

bool $showQueries

Return Value

void

static ModuleResource moduleResource(string $path)

Helper to access this module resources

Parameters

string $path

Return Value

ModuleResource

static void includeRequirements()

Include DebugBar assets using Requirements API

Return Value

void

static string renderDebugBar()

Returns the script to display the DebugBar

Return Value

string

static array disabledCriteria()

Get all criteria why the DebugBar could be disabled

Return Value

array

static string whyDisabled()

Determine why DebugBar is disabled

Deprecated in favor of disabledCriteria

Return Value

string

static vendorNotInstalled()

No description

static notLocalIp()

No description

static allowAllEnvironments()

No description

static isDisabled()

No description

static isDevUrl()

No description

static isAdminUrl()

No description

static isAdminController()

No description

static bool isDebugBarRequest()

Avoid triggering data collection for open handler

Return Value

bool

static string getRequestUrl()

Get request url

Return Value

string

static withDebugBar(callable $callback)

Helper to make code cleaner

Parameters

callable $callback

static setRequest(HTTPRequest $request)

Set the current request. Is provided by the DebugBarMiddleware.

Parameters

HTTPRequest $request

static HTTPRequest getRequest()

Get the current request

Return Value

HTTPRequest

static TimeDataCollector|false getTimeCollector()

No description

Return Value

TimeDataCollector|false

static MessagesCollector|false getMessageCollector()

No description

Return Value

MessagesCollector|false

static void trackTime(string $label)

Start/stop time tracking (also before init)

Parameters

string $label

Return Value

void

static void closeExtraTime()

Close any open extra time record

Return Value

void

static measureExtraTime()

Add extra time to time collector