perftools/xhgui-collector

Library for collecting and storing XHProf results for later use by XHGUI.

, _(*1)

XHGUI Collector

This is a small standalone module which you can use to collect and store XHProf performance data for later usage in XHGUI., _(*2)

NOTE: This package is being phased out, in new installatons, use perftools/php-profiler package., _(*3)

Goals

• Compatibility with PHP >= 5.3.0
• No dependencies aside from the relevant extensions
• Customizable and configurable so you can build your own logic on top of it

XHGUI Compatibility

This project was originally forked from perftools/xhgui@133051f, which was after the tag 0.7.1., _(*4)

This should ensure compatibility for most tags up to 0.7.1 (included)., _(*5)

The only change that would break compatibility would be a schema change on the XHGUI side., _(*6)

This table represents current known information about compatibility between this project and XHGUI data schema., _(*7)

Usage

Profile an Application or Site

The simplest way to profile an application is to use external/header.php. external/header.php is designed to be combined with PHP's [auto_prepend_file][4] directive. You can enable auto_prepend_file system-wide through php.ini. Alternatively, you can enable auto_prepend_file per virtual host., _(*8)

With apache this would look like:, _(*9)

<VirtualHost *:80>
  php_admin_value auto_prepend_file "/Users/markstory/Sites/xhgui/external/header.php"
  DocumentRoot "/Users/markstory/Sites/awesome-thing/app/webroot/"
  ServerName site.localhost
</VirtualHost>

With Nginx in fastcgi mode you could use:, _(*10)

server {
  listen 80;
  server_name site.localhost;
  root /Users/markstory/Sites/awesome-thing/app/webroot/;
  fastcgi_param PHP_VALUE "auto_prepend_file=/Users/markstory/Sites/xhgui/external/header.php";
}

Profile a CLI Script

The simplest way to profile a CLI is to use external/header.php. external/header.php is designed to be combined with PHP's [auto_prepend_file][4] directive. You can enable auto_prepend_file system-wide through php.ini. Alternatively, you can enable include the header.php at the top of your script:, _(*11)

<?php
require '/path/to/xhgui/external/header.php';
// Rest of script.

You can alternatively use the -d flag when running php:, _(*12)

php -d auto_prepend_file=/path/to/xhgui/external/header.php do_work.php

Use with environment variables

• run composer require perftools/xhgui-collector
• include these lines into your bootstrap file (e.g. index.php)

define('XHGUI_CONFIG_DIR', PATH_TO_OWN_CONFIG);
require_once PATH_TO_YOUR_VENDOR . '/perftools/xhgui-collector/external/header.php';

• set environment variables to configure the mongodb host, database name and more

System Requirements

For using the data collection classes you will need the following:, _(*13)

• PHP version 5.3 or later.
• XHProf, Uprofiler or Tideways to actually profile the data.
• Some way to access a MongoDB server. Choose either:
  • MongoDB Extension>=1.3.0 (MongoDB PHP driver from pecl)
  • alcaeus/mongo-php-adapter composer dependency.
• a MongoDB server. XHGUI requires version 2.2.0 or later.

When in doubt, refer to XHGUI repository's composer.json or this repository's composer.json suggests section., _(*14)