seantrane/profiler

A profiler for Laravel 4. A bespoke version of the sebklaus/profiler, which is a continuation of the retired juy/profiler.

v1.7.5 2014-01-27 13:22 UTC

This package is not auto-updated.

Last update: 2024-11-09 15:41:24 UTC


README

A PHP 5.3 profiler for Laravel 4.0.x and 4.1.x.

Fork based on sebklaus/profiler, and others...

Backend based on sorora/omni, frontend based on loic-sharma/profiler. Some features inspired by papajoker/profiler, some features by juy/profiler with additions by myself.

Continued

This is a continuation of juy/profiler.
It includes Pull Requests #34 & #6.

Different themes

Dark

Light

Features

  • Laravel Environment info, compatible with 4.0.x and 4.1.x
  • Total memory usage
  • Current controller/action info
  • Routes
  • Log events
  • SQL Query Log with syntax highlighting
  • Total execution time
  • Includes all application files
  • All variables passed to the current view
  • Session variables
  • Laravel Config settings
  • Laravel webserver error logs
  • Laravel auth variables (if used)
  • Sentry auth variables (if used)
  • Enabling/ Disabling via URL (add /_profiler to the end of any URL (eg. http://localhost/folder/_profiler))
  • Two different themes; dark and light.

Installation

To add Profiler to your Laravel application, add the below line to your composer.json file, in "require": { … }:

"sebklaus/profiler" : "dev-master"

Then run composer update or composer install, if it is the first time you install packages.

The final step is to add the below line to the end of the providers array in app/config/app.php (or the appropriate environment app.php):

'Sebklaus\Profiler\Providers\ProfilerServiceProvider',

Configuration

In order to be able to change the default settings of Profiler, publish the config file by running:

php artisan config:publish sebklaus/profiler

To change the default settings, edit app/config/packages/sebklaus/profiler/config.php.

Profiler

Set this option to FALSE to deactivate Profiler or TRUE to activate it. The default NULL uses the debug setting of app/config/app.php (or the appropriate environment app.php) to activate/ deactivate.

// config.php
'profiler' => NULL,

To be able to enable/ disable Profiler via URL (add /_profiler to the end of any URL (eg. http://localhost/folder/_profiler)), set the urlToggle option to TRUE:

// config.php
'urlToggle' => FALSE,

You will be redirected back to the page you started the request from (eg. http://localhost/folder).

If you have had Profiler installed prior to v1.6.0 and published the config settings, please add the above urlToggle element to the array in /app/config/packages/sebklaus/profiler/config.php or run php artisan config:publish sebklaus/profiler again. Running php artisan config:publish sebklaus/profiler will replace the config file, so make sure you restore your desired settings.

// config.php
'urlTogglePassword' => \Hash::make((string) mt_rand(0, microtime(true))),

If profiler is NULL or FALSE and urlToggle is TRUE and your app is running in the production environment, you will be asked to enter the password that has been set for urlTogglePassword in order to enable Profiler.
Upon successful password verification, Profiler will stay enabled for the duration of the session.

Change (string) mt_rand(0, microtime(true)) to your preferred password to enable Profiler.

If you have had Profiler installed prior to v1.7.0 and published the config settings, please add the above urlTogglePassword element to the array in /app/config/packages/sebklaus/profiler/config.php or run php artisan config:publish sebklaus/profiler again. Running php artisan config:publish sebklaus/profiler will replace the config file, so make sure you restore your desired settings.

If you wish to disable Profiler during runtime, add the below code to your script:

Config::set('profiler::profiler', false);

You can (re-)order, disable and adjust label and title for the various info sections of Profiler by editing values of the btns array:

// config.php
'btns' => array(
	'environment' => array('label'=>'ENV','title'=>'Environment'),
	'memory'      => array('label'=>'MEM','title'=>'Memory'),
	'controller'  => array('label'=>'CTRL','title'=>'Controller'),
	'routes'      => array('label'=>'ROUTES'),
	'log'         => array('label'=>'LOG'),
	'sql'         => array('label'=>'SQL'),
	'checkpoints' => array('label'=>'TIME'),
	'file'        => array('label'=>'FILES'),
	'view'        => array('label'=>'VIEW'),
	'session'     => array('label'=>'SESSION'),
	'server'      => array('label'=>'SERVER'),
	'config'      => array('label'=>'CONFIG'),
	'storage'     => array('label'=>'LOGS','title'=>'Logs in storage'),
	'auth'        => array('label'=>'AUTH'),
	'auth-sentry' => array('label'=>'AUTH')
),

Add a link to your preferred (Laravel) documentation (or really anywhere you want) by changing the value of doc.
The link is active on the Laravel logo on the left hand side of the opened Profiler.

// config.php
'doc'=>'http://laravel.com/docs',

jQuery

Profiler makes use of jQuery, which is automatically downloaded and included, if it can't be detected.

Usage

Custom Timers

To start a timer, all you need to do is:

Profiler::start('my timer key');

To end the timer, simply call the end function like so:

Profiler::end('my timer key');

Logging

Profiler utilizes Laravels built in logging system and captures logged events. To log events, you can use (as you would with Laravel) any of these:

Log::debug('Your message here');
Log::info('Your message here');
Log::notice('Your message here');
Log::warning('Your message here');
Log::error('Your message here');
Log::critical('Your message here');
Log::alert('Your message here');
Log::emergency('Your message here');

These are colour coded in the Log part of Profiler - colours may change in the future to more accurately reflect the log type.