Download the PHP package stevad/yii2-xhprof without Composer
On this page you can find all versions of the php package stevad/yii2-xhprof. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package yii2-xhprof
yii2-xhprof
Simple extension to use XHProf with Yii Framework 2.x. This is the updated version of yii-xhprof extension for Yii Framework 1.x.
Bundled with debug panel for official yii2-debug extension.
By default profile starts during bootstrap process and stops in PHP shutdown function. You can change this behavior and manually start and stop profiler.
For license information check the LICENSE file.
Tested on Yii Framework v2.0.6+.
Installation
This extension is available at packagist.org and can be installed via composer by following command:
composer require --dev stevad/yii2-xhprof.
Minimal configuration to enable profiler:
To use bundled debug panel - update configuration next way:
Note: xhprof should be after debug in preload section to be able to ignore requests to debug module pages.
Required XHProf files (library files - xhprof_lib and UI - xhprof_html) you can find in this GitHub repo.
Component configuration
Extension provide next configuration options for Yii component:
enabled- enable/disable profiler component.reportPath- filesystem path or path alias to the directory to store JSON file with previous profiler runs. Default:@runtime/xhprofmaxReportsCount- number of profile reports to store. Default:25.autoStart- flag to automatically start profiler during application bootstrap process. Default:true.autoStop- flag to automatically stop profiler in PHP shutdown function. Default:true.forceStop- flag to force stop profiler during PHP shutdown ifautoStopis disabled and profiler was manually started and is still running. Default:true.triggerGetParam- name of the GET param to manually trigger profiler to start. Default: no value, profiler runs on each request.showOverlay- flag to display overlay on page with links to report and callgraph result for current profiler run (if allowed). Not required to betrueif you are using bundled panel for yii2-debug extension. Default:true.libPath- direct filesystem path or path alias to the directory withxhprof_libcontents.htmlReportBaseUrl- URL path to the directory with XHProf UI contents (xhprof_html). Default:/xhprof_html(assuming you have this folder inside your document root).flagNoBuiltins- enable/disable XHPROF_FLAGS_NO_BUILTINS flag for profiler (XHProf constants). Default:true.flagCpu- enable/disable XHPROF_FLAGS_CPU flag for profiler (XHProf constants). Default:false.flagMemory- enable/disable XHPROF_FLAGS_MEMORY flag for profiler (XHProf constants). Default:true.ignoredFunctions- list of functions to ignore during profiling. Empty by default. Note: this option is not supported bytideways_xhprofextension.blacklistedRoutes- list of routes which profiler should ignore. Allowed wildcard*which means 'any alphanumeric value and one of this:/,.,_,-. Default:['debug*'](to ignore requests to the debug extension pages).
XHProf class configuration
Component from extension use own developed simple wrapper for xhprof_enable / xhprof_disable functions: XHProf class. This class provide functionality to start/stop profiling, save reports and get URLs for reports with XHProf library by Facebook.
Available configuration options (applicable for configure method, see example below):
flagNoBuiltins- enable/disable XHPROF_FLAGS_NO_BUILTINS flag for profiler (XHProf constants). Default:true.flagCpu- enable/disable XHPROF_FLAGS_CPU flag for profiler (XHProf constants). Default:false.flagMemory- enable/disable XHPROF_FLAGS_MEMORY flag for profiler (XHProf constants). Default:true.ignoredFunctions- list of functions to ignore during profiling (xhprof_enable() function). Empty by default.libPath- direct filesystem path to the directory withxhprof_libcontents.htmlUrlPath- URL path to the directory with XHProf UI contents (xhprof_html).runNamespace- predefined value of namespace for current profiler run.
All options can be changed with setters (e.g. setFlagCpu(<value>)). For more details see the source code of the class.
Manual profiling
If you disable auto start (autoStart option) or stop (autoStop option) you can place code to start/stop profiler in any place of your code and be able to see report and callgraph result via overlay or debug panel.
To manual start you need to write some kind of next code:
To manual stop you need to write next code:
Note: If you use XHProf class (with or without this extension) - all profile results can be found on XHProf UI page (it's by default by xhprof developers).
Note for PHP 7 and XHProf
If you want to use this extension with PHP 7, you can use next forked version of xhprof extension: https://github.com/rustjason/xhprof. This extension was tested on PHP 7.1.11 with extension built from provided repository.
Another better option - is to use officially ported xhprof extension by tideways.io - https://github.com/tideways/php-xhprof-extension.
Author
Copyright (c) 2015-2018 by Stevad.
