adamjakab / SuiteCRM

include/SugarXHprof/SugarXHprof.php

<?php
if(!defined('sugarEntry') || !sugarEntry) die('Not A Valid Entry Point');
/*********************************************************************************
 * SugarCRM Community Edition is a customer relationship management program developed by
 * SugarCRM, Inc. Copyright (C) 2004-2013 SugarCRM Inc.

 * SuiteCRM is an extension to SugarCRM Community Edition developed by Salesagility Ltd.
 * Copyright (C) 2011 - 2014 Salesagility Ltd.
 *
 * This program is free software; you can redistribute it and/or modify it under
 * the terms of the GNU Affero General Public License version 3 as published by the
 * Free Software Foundation with the addition of the following permission added
 * to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED WORK
 * IN WHICH THE COPYRIGHT IS OWNED BY SUGARCRM, SUGARCRM DISCLAIMS THE WARRANTY
 * OF NON INFRINGEMENT OF THIRD PARTY RIGHTS.
 *
 * This program is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 * FOR A PARTICULAR PURPOSE.  See the GNU Affero General Public License for more
 * details.
 *
 * You should have received a copy of the GNU Affero General Public License along with
 * this program; if not, see http://www.gnu.org/licenses or write to the Free
 * Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
 * 02110-1301 USA.
 *
 * You can contact SugarCRM, Inc. headquarters at 10050 North Wolfe Road,
 * SW2-130, Cupertino, CA 95014, USA. or at email address contact@sugarcrm.com.
 *
 * The interactive user interfaces in modified source and object code versions
 * of this program must display Appropriate Legal Notices, as required under
 * Section 5 of the GNU Affero General Public License version 3.
 *
 * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
 * these Appropriate Legal Notices must retain the display of the "Powered by
 * SugarCRM" logo and "Supercharged by SuiteCRM" logo. If the display of the logos is not
 * reasonably feasible for  technical reasons, the Appropriate Legal Notices must
 * display the words  "Powered by SugarCRM" and "Supercharged by SuiteCRM".
 ********************************************************************************/


/**
 * Class allows us to use XHprof for profiling
 * To enable profiling you should add next properties to config_override.php
 *
 * @see SugarXHprof::$enable            for $sugar_config['xhprof_config']['enable']
 * @see SugarXHprof::$manager           for $sugar_config['xhprof_config']['manager']
 * @see SugarXHprof::$log_to            for $sugar_config['xhprof_config']['log_to']
 * @see SugarXHprof::$sample_rate       for $sugar_config['xhprof_config']['sample_rate']
 * @see SugarXHprof::$ignored_functions for $sugar_config['xhprof_config']['ignored_functions']
 * @see SugarXHprof::$flags             for $sugar_config['xhprof_config']['flags']
 *
 * To run profiler you should call SugarXHprof::getInstance()->start();
 * To stop profiler you should call SugarXHprof::getInstance()->end();
 * 'start' method registers 'end' method as shutdown function because of it call of 'end' method is unnecessary if you want profile all calls
 * Also 'start' method is called automatically in entryPoint.php file
 *
 * Names of generated files are prefix.microtime.module.action for modules and prefix.microtime.'entryPoint'.entryPoint for entry points
 * If you want to see reports you should install https://github.com/facebook/xhprof to some directory and run it as http://your.domain/path2xhprof/xhprof_html/?run=prefix.microtime&source=module.action
 * For 507bf986e44d9.1350302086.9285.Leads.listview.xhprof file url will be look like http://your.domain/path2xhprof/xhprof_html/?run=507bf986e44d9.1350302086.9285&source=Leads.listview
 *
 * If you want to customize SugarXHprof you should create file in custom/include/SugarXHprof/ folder and name file as name of your custom class
 * Change $sugar_config['xhprof_config']['manager'] to be name of your custom class
 * Custom class has to extend from SugarXHprof
 * If custom class doesn't exist or doesn't extend from SugarXHprof then SugarXHprof be used
 */
class SugarXHprof
{
    /**
     * @var SugarXHprof instance of profiler
     */
    protected static $instance = null;

    /**
     * Because of unregister_shutdown_function is not present in php we have to skip calls of 'end' method if that property equals to false
     *
     * @var bool is shutdown function registered or not
     */
    protected $registered = false;

    /**
     * @var bool enable profiler or not, it will be disabled by some reasons
     * @see SugarXHprof::loadConfig()
     */
    protected static $enable = false;

    /**
     * @var string class of manager for customization, has to extend from SugarXHprof class
     */
    protected static $manager = __CLASS__;

    /**
     * @var string path to directory for logs, if log_to is empty then xhprof.output_dir be used
     */
    protected static $log_to = '';

    /**
     * @var int where value is a number and 1/value requests are profiled. So to sample all requests set it to 1
     */
    protected static $sample_rate = 10;

    /**
     * @var array array of function names to ignore from the profile (pass into xhprof_enable)
     */
    protected static $ignored_functions = array();

    /**
     * @var int flags for xhprof
     * @see http://www.php.net/manual/xhprof.constants.php
     */
    protected static $flags = 0;

    /**
     * Populates configuration from $sugar_config to self properties
     */
    protected static function loadConfig()
    {
        if (!empty($GLOBALS['sugar_config']['xhprof_config']))
        {
            foreach($GLOBALS['sugar_config']['xhprof_config'] as $k => $v)
            {
                if (isset($v) && property_exists(__CLASS__, $k))
                {
                    self::${$k} = $v;
                }
            }
        }

        // disabling profiler if XHprof extension is not loaded
        if (extension_loaded('xhprof') == false)

It seems like you are loosely comparing two booleans. Considering using the strict comparison === instead.

        {
            self::$enable = false;
        }

        // using default directory for profiler if it is not set
        if (empty(self::$log_to))
        {
            self::$log_to = ini_get('xhprof.output_dir');
        }

        // disabling profiler if directory is not exist or is not writable
        if (is_dir(self::$log_to) == false || is_writable(self::$log_to) == false)

It seems like you are loosely comparing two booleans. Considering using the strict comparison === instead.

        {
            self::$enable = false;
        }
    }

    /**
     * Tries to load custom profiler. If it doesn't exist then use itself
     *
     * @return SugarXHprof
     */
    public static function getInstance()
    {
        if (self::$instance != null)
        {
            return self::$instance;
        }

        self::loadConfig();

        if (is_file('custom/include/SugarXHprof/' . self::$manager . '.php'))
        {
            require_once 'custom/include/SugarXHprof/' . self::$manager . '.php';
        }
        elseif (is_file('include/SugarXHprof/' . self::$manager . '.php'))
        {
            require_once 'include/SugarXHprof/' . self::$manager . '.php';
        }
        if (class_exists(self::$manager) && is_subclass_of(self::$manager, __CLASS__))
        {
            self::$instance = new self::$manager();
        }
        else
        {
            self::$instance = new self();
        }
        return self::$instance;
    }

    /**
     * Method tries to detect entryPoint, service, module & action and returns it as string
     *
     * @return string action
     */
    static public function detectAction()

As per PSR2, the static declaration should come after the visibility declaration.

    {
        $action = '';

        // index.php
        if (!empty($GLOBALS['app']) && $GLOBALS['app'] instanceof SugarApplication && $GLOBALS['app']->controller instanceof SugarController)
        {
            if (!empty($_REQUEST['entryPoint']))
            {
                if (!empty($GLOBALS['app']->controller->entry_point_registry) && !empty($GLOBALS['app']->controller->entry_point_registry[$_REQUEST['entryPoint']]))
                {
                    $action .= '.entryPoint.' . $_REQUEST['entryPoint'];
                }
                else
                {
                    $action .= '.entryPoint.unknown';
                }
            }
            else
            {
                $action .= '.' . $GLOBALS['app']->controller->module . '.' . $GLOBALS['app']->controller->action;
            }
        }
        // soap.php
        elseif (!empty($GLOBALS['server']) && $GLOBALS['server'] instanceof soap_server)
        {
            if ($GLOBALS['server']->methodname)
            {
                $action .= '.soap.' . $GLOBALS['server']->methodname;
            }
            else
            {
                $action .= '.soap.wsdl';
            }
        }
        // service soap
        elseif (!empty($GLOBALS['service_object']) && $GLOBALS['service_object'] instanceof SugarSoapService)
        {
            $action .= '.soap.' . $GLOBALS['service_object']->getRegisteredClass();
            if ($GLOBALS['service_object']->getServer() instanceof soap_server)
            {
                if ($GLOBALS['service_object']->getServer()->methodname)
                {
                    $action .= '.' . $GLOBALS['service_object']->getServer()->methodname;
                }
                else
                {
                    $action .= '.wsdl';
                }
            }
            else
            {
                $action .= '.unknown';
            }
        }
        // service rest
        elseif (!empty($GLOBALS['service_object']) && $GLOBALS['service_object'] instanceof SugarRestService)
        {
            $action .= '.rest.' . $GLOBALS['service_object']->getRegisteredImplClass();
            if (!empty($_REQUEST['method']) && method_exists($GLOBALS['service_object']->implementation, $_REQUEST['method']))
            {
                $action .= '.' . $_REQUEST['method'];
            }
            elseif (empty($_REQUEST['method']))
            {
                $action .= '.index';
            }
            else
            {
                $action .= '.unknown';
            }
        }
        // unknown
        else
        {
            $action .= '.' . basename($_SERVER['SCRIPT_FILENAME']);
        }

        return $action;
    }

    /**
     * Tries to enabled xhprof if all settings were passed
     */
    public function start()
    {
        if (self::$enable == false)

It seems like you are loosely comparing two booleans. Considering using the strict comparison === instead.

        {
            return;
        }

        if (self::$sample_rate == 0)
        {
            return;
        }

        $rate = 1 / self::$sample_rate * 100;
        if (rand(0, 100) > $rate)
        {
            return;
        }

        register_shutdown_function(array(
            $this,
            'end'
        ));
        $this->registered = true;

        xhprof_enable(self::$flags, array(
            'ignored_functions' => self::$ignored_functions
        ));
    }

    /**
     * Tries to collect data from XHprof after call of 'start' method
     */
    public function end()
    {
        if ($this->registered == false)

It seems like you are loosely comparing two booleans. Considering using the strict comparison === instead.

        {
            return;
        }
        $this->registered = false;

        if (self::$enable == false)

It seems like you are loosely comparing two booleans. Considering using the strict comparison === instead.

        {
            return;
        }

        $data = xhprof_disable();
        $namespace = microtime(1) . self::detectAction();

        require_once 'include/SugarXHprof/xhprof_lib/utils/xhprof_runs.php';
        $xhprof_runs = new XHProfRuns_Default(self::$log_to);
        $xhprof_runs->save_run($data, $namespace);
    }
}