c0de8/phalcon3-debug-widget

Phalcon debug toolbar for Phalcon 3

0.1.1 2017-01-23 07:42 UTC

This package is not auto-updated.

Last update: 2024-03-20 17:58:39 UTC


README

Latest Stable Version Total Downloads

License

  1. Forked from [Zazza/phalcon-debug-widget] (https://github.com/Zazza/phalcon-debug-widget)

  2. Update from https://github.com/C0DE8/phalcon3-debug-widget

Changelog:

  • no necessary assets (all images, CSS and JS Code is minified and inline)
  • no jquery dependence (jQuery is executed with "noConflict")
  • the sections: Server, Views, Database hide and show by click

Note (How it works):

The debug widget for now is very simplistic and more of a proof-of-concept. It expects you have three services in your dependency injector named "db", "dispatcher" and "view" and that they correspond to those services. When you pass the DI to Phalcon Debug Widget It looks for those specific services and:

  • sets them as shared services
  • sets the eventManager for them
  • Attaches itself to those events

This means passing the DI to the debug widget will alter those services. Generally speaking, a shared db, dispatcher, and view is fine. If you have ideas for other ways to hook in, please open an issue for discussion.

The Phalcon Debug Widget is designed to make development easier by displaying debugging information directly in your browser window. Currently it displays php globals such as $_SESSION as well as outputing resource usage and database queries and connection information. It includes syntax highlighting via Prismjs.com.

If it looks familiar, its because its modeled after the Yii debug toolbar

Installation

composer.json:

"c0de8/phalcon3-debug-widget": "dev-master"

composer require (command line):

composer require c0de8/phalcon3-debug-widget:dev-master

Usage and Configuration

Define a debug or environment flag in your main index.php file so you can easily disable the Phalcon Debug Widget on production environments. Example:

defined('PHALCONDEBUG') || define('PHALCONDEBUG', true);

After you have setup your \Phalcon\Loader and \Phalcon\DI\FactoryDefault() create a new instance of the debug widget inside your "index.php", where application is started.

if (PHALCONDEBUG) {
    $debugWidget = new \PDW\DebugWidget($di, [
        'db'          => ['dbRead', 'dbWrite],
        'dispatch'    => ['dispatcher'],
        'view'        => ['view'],
        'apiProvider' => ['apiProvider']
    ], [
        'server',
        'request',
        'views',
        'db',
        'api'
    ]);
}

Preview

Attribution:

Bug Icon designed by Nithin Viswanathan from the Noun Project