tavy315/zfdebug

Thursday, April 5, 2018
by Octav
Repository
1 Watchers
1 Stars
194 Installations

PHP
0 Dependents
0 Suggesters
86 Forks
0 Open issues
17 Versions
3 % Grown

The README.md

ZFDebug - a debug bar for Zend Framework

ZFDebug is a plugin for the Zend Framework for PHP5, providing useful debug information displayed in a small bar at the bottom of every page., _(*1)

Time spent, memory usage and number of database queries are presented at a glance. Additionally, included files, a listing of available view variables and the complete SQL command of all queries are shown in separate panels:, _(*2)

, _(*3)

The available plugins at this point are: * Cache: Information on Zend_Cache, APC and Zend OPcache (for PHP 5.5). * Database: Full listing of SQL queries from Zend_Db and the time for each. * Exception: Error handling of errors and exceptions. * File: Number and size of files included with complete list. * Html: Number of external stylesheets and javascripts. Link to validate with W3C. for custom memory measurements. * Log: Timing information of current request, time spent in action controller and custom timers. Also average, min and max time for requests. * Session * Variables: View variables, request info and contents of $_COOKIE, $_POST and $_SESSION, _(*4)

Installation

{
    "minimum-stability": "dev",
    "require": {
        "tavy315/zfdebug" : "dev-master"
    }
}

Using Composer

You may now install ZFDebug using the dependency management tool Composer., _(*5)

To use ZFDebug with Composer, add the following to the require list in your project's composer.json file:, _(*6)

"require": {
    "tavy315/zfdebug": "1.*"
},

Run the install command to resolve and download the dependencies:, _(*7)

php composer.phar install

Usage

To install, place the folder 'ZFDebug' in your library path, next to the Zend folder. Then add the following method to your bootstrap class (in ZF1.8+):, _(*8)

protected function _initZFDebug()
{
    $autoloader = Zend_Loader_Autoloader::getInstance();
    $autoloader->registerNamespace('ZFDebug');

    $options = array(
        'plugins' => array(
            'Variables',
            'Database' => array(
                'adapter' => $db,
            ),
            'File' => array(
                'basePath' => '/path/to/project',
            ),
            'Cache' => array(
                'backend' => $cache->getBackend(),
            ),
            'Exception',
        ),
    );
    $debug = new ZFDebug\Controller\Plugin\Debug($options);

    $this->bootstrap('frontController');
    $frontController = $this->getResource('frontController');
    $frontController->registerPlugin($debug);
}

Some use case will require that you set up callback functions. Especially, these happen to occur in the following plugins: * cache: the callback function is called when asked to clean the cache * language: the callback is called when we try to change the active language * auth: the callback is used to retrieve the real username when the default plugin would only give an id, _(*9)

You can leverage those functionalities by setting the following class:, _(*10)

<?php
class Application_Controller_Plugin_Debug extends \ZFDebug\Controller\Plugin\Debug
{
    public function __construct($options = null)
    {
        // avoids constructing before required vars are available
    }

    public function preDispatch(\Zend_Controller_Request_Abstract $request)
    {
        if (APPLICATION_ENV !== 'production') {
            $auth_callback = function ($raw_user) {
                // do the job for getting the real username from the raw data you would typically retrieve
            };
            $locale_callback = function () {
                // do the job for changing locale
            };
            $cache_callback = function () {
                // do the job for clearing the cache
            };
            $this->_options = array(
                'image_path' => null,
                'plugins' => array(
                    'Variables',
                    'Doctrine2' => array(
                        'entityManagers' => array(
                            \Zend_Registry::get('em')
                        ),
                    ),
                    'File' => array(
                        'base_path' => APPLICATION_PATH . '/../',
                    ),
                    'Cache' => array(
                        'backend' => 'Zend_Cache',
                        'callback' => $cache_callback,
                    ),
                    'Exception',
                    'Html',
                    'Locale' => array(
                        'callback' => $locale_callback,
                    ),
                    'Auth' => array(
                        'user' => 'id',
                        'callback' => $auth_callback,
                    ),
                )
            );
            // Registering Debug plugin
            parent::__construct();
        }
    }
}

Doctrine 1 Plugin

Here is example configuration for using the Doctrine Plugin:, _(*11)

protected function _initZFDebug()
{
    if (APPLICATION_ENV === 'development') {
        $options = array(
            'plugins' => array(
                'Variables',
                'File',
                'Memory',
                'Time',
                'Doctrine1',
                'Exception'
            )
        );

        $ZFDebug = new \ZFDebug\Controller\Plugin\Debug($options);
        $frontController = \Zend_Controller_Front::getInstance();
        $frontController->registerPlugin($ZFDebug);

        return $ZFDebug;
    }
}

Doctrine2 Plugin

Here is example configuration for using the Doctrine2 Plugin:, _(*12)

protected function _initZFDebug()
{
    if (APPLICATION_ENV == 'development') {
        $autoloader = \Zend_Loader_Autoloader::getInstance();
        $autoloader->registerNamespace('ZFDebug');
        $em = $this->bootstrap('doctrine')->getResource('doctrine')->getEntityManager();
        $em->getConnection()->getConfiguration()->setSQLLogger(new \Doctrine\DBAL\Logging\DebugStack());

        $options = array(
            'plugins' => array(
                'Variables',
                'Doctrine2' => array(
                    'entityManagers' => array($em),
                ),
                'File' => array(
                    'basePath' => APPLICATION_PATH . '/application',
                ),
                /* 'Cache' => array(
                    'backend' => $cache->getBackend()
                ), */
                'Exception',
                'Html',
                'Memory',
                'Time',
                'Registry',
            )
        );

        $debug = new \ZFDebug\Controller\Plugin\Debug($options);
        $this->bootstrap('frontController');
        $frontController = $this->getResource('frontController');
        $frontController->registerPlugin($debug);
    }
}

Further documentation will follow as the github move progresses., _(*13)

The Versions

05/04 2018

1.4.1

1.4.1.0

library zfdebug

tavy315/zfdebug

The README.md

ZFDebug - a debug bar for Zend Framework

Installation

Using Composer

Usage

Sample Zend Plugin to load the ZFDebug toolbar

Doctrine 1 Plugin

Doctrine2 Plugin

The Versions

1.4.1

1.5

1.5RC1

1.5.4

dev-master

The Requires

by aur1mas

by Joakim Nygård

by Andreas Pankratz

by François-Régis Jaunatre

by reneaigle

by Montmere Limited

by Kushan Jayatilleke

by Łukasz Ciołecki

by Octavian Matei

1.7.6

The Requires

by aur1mas

by Joakim Nygård

by Andreas Pankratz

by François-Régis Jaunatre

by reneaigle

by Montmere Limited

by Kushan Jayatilleke

by Łukasz Ciołecki

by Octavian Matei

1.7.5

The Requires

by aur1mas

by Joakim Nygård

by Andreas Pankratz

by François-Régis Jaunatre

by reneaigle

by Montmere Limited

by Kushan Jayatilleke

by Łukasz Ciołecki

by Octavian Matei

1.7.4

The Requires

by aur1mas

by Joakim Nygård

by Andreas Pankratz

by François-Régis Jaunatre

by reneaigle

by Montmere Limited

by Kushan Jayatilleke

by Łukasz Ciołecki

by Octavian Matei

1.7.3

The Requires

by aur1mas

by Joakim Nygård

by Andreas Pankratz

by François-Régis Jaunatre

by reneaigle

by Montmere Limited

by Kushan Jayatilleke

by Łukasz Ciołecki

by Octavian Matei

1.7.2

The Requires

by aur1mas

by Joakim Nygård

by Andreas Pankratz

by François-Régis Jaunatre

by reneaigle

by Montmere Limited

by Kushan Jayatilleke

by Łukasz Ciołecki