perftools / php-profiler

A PHP profiling library based on XHGUI Data Collector
MIT License
146 stars 26 forks source link

Why does the project not support non intrusive mode? #42

Closed ym2048 closed 4 years ago

ym2048 commented 4 years ago

Why does perftools/php-profiler not support non intrusive type,such as using auto_ prepend_file to introduce the component? Thank you!

glensc commented 4 years ago

Config is specific to your setup.

You can create the file yourself, put content like this in there:

<?php

use Xhgui\Profiler\Profiler;
use Xhgui\Profiler\ProfilingFlags;

try {
    $config = array(
        // If defined, use specific profiler
        // otherwise use any profiler that's found
        'profiler' => Profiler::PROFILER_TIDEWAYS_XHPROF,

        // This allows to configure, what profiling data to capture
        'profiler.flags' => array(
            ProfilingFlags::CPU,
            ProfilingFlags::MEMORY,
            ProfilingFlags::NO_BUILTINS,
            ProfilingFlags::NO_SPANS,
        ),

        // Saver to use.
        // Please note that 'pdo' and 'mongo' savers are deprecated
        // Prefer 'upload' or 'file' saver.
        'save.handler' => Profiler::SAVER_UPLOAD,

        // Environment variables to exclude from profiling data
        'profiler.exclude-env' => array(),
        'profiler.options' => array(),

        /**
         * Determine whether the profiler should run.
         * This default implementation just disables the profiler.
         * Override this with your custom logic in your config
         * @return bool
         */
        'profiler.enable' => function () {
            return true;
        },

        /**
         * Creates a simplified URL given a standard URL.
         * Does the following transformations:
         *
         * - Remove numeric values after "=" in query string.
         *
         * @param string $url
         * @return string
         */
        'profiler.simple_url' => function ($url) {
            return preg_replace('/=\d+/', '', $url);
        },

        /**
         * Enable this to clean up the url before submitting it to XHGui.
         * This way it is possible to remove sensitive data or discard any other data.
         *
         * The URL argument is the `REQUEST_URI` or `argv` value.
         *
         * @param string $url
         * @return string
         */
        'profiler.replace_url' => function ($url) {
            return str_replace('token', '', $url);
        },
    );

    /**
     * The constructor will throw an exception if the environment
     * isn't fit for profiling (extensions missing, other problems)
     */
    $profiler = new Profiler($config);

    // The profiler itself checks whether it should be enabled
    // for request (executes lambda function from config)
    $profiler->start();
} catch (Exception $e) {
    // throw away or log error about profiling instantiation failure
    error_log($e->getMessage());
}

docs: